メインコンテンツまでスキップ

TextField 単一行テキストフィールド

このコンポーネントは、文字列を入力するためのテキストフィールドを画面上に表示します。

キー説明必須デフォルト値最低対応バージョン
alignment文字列配置方法-Left-
keyboard文字列キーボードの種類-Default-
placeholder文字列テキストフィールドのプレースホルダーローカライズ可能""-
isSecureブール値文字を小さな丸で表示するかどうか-false-
clearButtonMode文字列クリアボタンを表示するかどうか-Never-
maxLength整数テキストの最大文字数-INT_MAX-
validationRegex文字列入力文字列の検証に使用する正規表現-nil1.2-10
prompt文字列入力ダイアログのタイトルローカライズ可能nil1.2-10
message文字列入力ダイアログのメッセージローカライズ可能nil1.2-10
okTitle文字列入力ダイアログの確定ボタンのタイトルローカライズ可能"好"1.2-10
cancelTitle文字列入力ダイアログのキャンセルボタンのタイトルローカライズ可能"取消"1.2-10

このコンポーネントは icon をサポートしていません。title プロパティを設定する場合は、alignment プロパティを "Right" に設定することをお勧めします。

文字列項目を変更または追加するとき、文字列が正規表現 validationRegex の検証に合格しない場合、現在の項目は保存できません。

prompt または message が空でない場合、TextField をタップすると入力ダイアログが表示され、ダイアログ内で値の入力を求められます。

alignment説明
Left左揃え
Center中央揃え
Right右揃え
Natural自然な配置
Justified両端揃え
keyboard説明
Default標準およびサードパーティ製キーボード
Alphabet標準 ASCII
ASCIICapable標準 ASCII
NumbersAndPunctuation数字と句読点
URLURL
NumberPad数字入力
PhonePad電話番号
NamePhonePad氏名と電話番号
EmailAddressメールアドレス
DecimalPad小数点付きの数字
clearButtonMode説明
Never常に非表示
Always常に表示
WhileEditing編集中のみ表示
UnlessEditing編集中でない場合のみ表示
戻り値の型説明
文字列テキストフィールドの内容

テーマ

テーマキー説明
textColor文字色
caretColorカーソルの色
placeholderColorプレースホルダーの色

使用例

{
default = "";
label = "用户名";
cell = "TextField";
key = "username";
keyboard = "Default"; -- デフォルトのキーボード
alignment = "Right"; -- 右揃え
placeholder = "输入用户名"; -- プレースホルダー
maxLength = 21; -- 最大文字数
validationRegex = "^[0-9a-zA-Z]+$"; -- 正規表現による検証
};
{
isSecure = true; -- 文字を小さな丸で表示するパスワード入力
default = "";
label = "密码";
cell = "TextField";
key = "password";
keyboard = "NumberPad"; -- テンキー
alignment = "Right"; -- 右揃え
placeholder = "输入密码"; -- プレースホルダー
prompt = "请输入密码"; -- ダイアログのタイトル
message = "请在提示框中输入 6 位数字密码"; -- ダイアログのメッセージ
validationRegex = "^[0-9]{6}$"; -- 正規表現による検証
okTitle = "保存"; -- 確定ボタンのタイトル
cancelTitle = "取消"; -- キャンセルボタンのタイトル
};

XUI-TextField.png

XUI-TextField-Prompt.png