输入框 - Input

# 输入框控件: input 输入框控件也是一个特殊的文本控件,因此所有文本控件的函数的属性和函数都适用于按钮控件。输入框控件有自己的属性和函数,要查看所有这些内容,阅读[EditText](https://developer.android.google.cn/reference/android/widget/EditText.html)。 对于一个输入框控件,我们可以通过text属性设置他的内容,通过lines属性指定输入框的行数;在代码中通过`getText()`函数获取输入的内容。例如: ``` "ui"; ui.layout( <vertical padding="16"> <text textSize="16sp" textColor="black" text="请输入姓名"/> <input id="name" text="小明"/> <button id="ok" text="确定"/> </vertical> ); //指定确定按钮点击时要执行的动作 ui.ok.click(function(){ //通过getText()获取输入的内容 var name = ui.name.getText(); toast(name + "您好!"); }); ``` 效果如图: ![ex-input](ex-input.png) 除此之外,输入框控件有另外一些主要属性(虽然这些属性对于文本控件也是可用的但一般只用于输入框控件): ## hint 输入提示。这个提示会在输入框为空的时候显示出来。如图所示: ![ex-hint](images/ex-hint.png) 上面图片效果的代码为: ``` "ui"; ui.layout( <vertical> <input hint="请输入姓名"/> </vertical> ) ``` ## textColorHint 指定输入提示的字体颜色。 ## textSizeHint 指定输入提示的字体大小。 ## inputType 指定输入框可以输入的文本类型。可选的值为以下值及其用"|"的组合: * `date` 用于输入日期。 * `datetime` 用于输入日期和时间。 * `none` 没有内容类型。此输入框不可编辑。 * `number` 仅可输入数字。 * `numberDecimal` 可以与number和它的其他选项组合,以允许输入十进制数(包括小数)。 * `numberPassword` 仅可输入数字密码。 * `numberSigned` 可以与number和它的其他选项组合,以允许输入有符号的数。 * `phone` 用于输入一个电话号码。 * `text` 只是普通文本。 * `textAutoComplete` 可以与text和它的其他选项结合, 以指定此字段将做自己的自动完成, 并适当地与输入法交互。 * `textAutoCorrect` 可以与text和它的其他选项结合, 以请求自动文本输入纠错。 * `textCapCharacters` 可以与text和它的其他选项结合, 以请求大写所有字符。 * `textCapSentences` 可以与text和它的其他选项结合, 以请求大写每个句子里面的第一个字符。 * `textCapWords` 可以与text和它的其他选项结合, 以请求大写每个单词里面的第一个字符。 * `textEmailAddress` 用于输入一个电子邮件地址。 * `textEmailSubject` 用于输入电子邮件的主题。 * `textImeMultiLine` 可以与text和它的其他选项结合,以指示虽然常规文本视图不应为多行, 但如果可以, 则IME应提供多行支持。 * `textLongMessage` 用于输入长消息的内容。 * `textMultiLine` 可以与text和它的其他选项结合, 以便在该字段中允许多行文本。如果未设置此标志, 则文本字段将被限制为单行。 * `textNoSuggestions` 可以与text及它的其他选项结合, 以指示输入法不应显示任何基于字典的单词建议。 * `textPassword` 用于输入密码。 * `textPersonName` 用于输入人名。 * `textPhonetic` 用于输入拼音发音的文本, 如联系人条目中的拼音名称字段。 * `textPostalAddress` 用于输入邮寄地址。 * `textShortMessage` 用于输入短的消息内容。 * `textUri` 用于输入一个URI。 * `textVisiblePassword` 用于输入可见的密码。 * `textWebEditText` 用于输入在web表单中的文本。 * `textWebEmailAddress` 用于在web表单里输入一个电子邮件地址。 * `textWebPassword` 用于在web表单里输入一个密码。 * `time` 用于输入时间。 例如,想指定一个输入框的输入类型为小数数字,为: `<input inputType="number|numberDecimal"/>` ## password 指定输入框输入框是否为密码输入框。默认为`false`。 例如:`<input password="true"/>` ## numeric 指定输入框输入框是否为数字输入框。默认为`false`。 例如:`<input numeric="true"/>` ## phoneNumber 指定输入框输入框是否为电话号码输入框。默认为`false`。 例如:`<input phoneNumber="true"/>` ## digits 指定输入框可以输入的字符。例如,要指定输入框只能输入"1234567890+-",为`<input digits="1234567890+-"/>`。 ## singleLine 指定输入框是否为单行输入框。默认为`false`。您也可以通过`lines="1"`来指定单行输入框。 例如:`<input singleLine="true"/>`