TextField 単一行テキストフィールド
このコンポーネントは、文字列を入力するためのテキストフィールドを画面上に表示します。
| キー | 型 | 説明 | 必須 | デフォルト値 | 最低対応バージョン |
|---|---|---|---|---|---|
| alignment | 文字列 | 配置方法 | - | Left | - |
| keyboard | 文字列 | キーボードの種類 | - | Default | - |
| placeholder | 文字列 | テキストフィールドのプレースホルダー | ローカライズ可能 | "" | - |
| isSecure | ブール値 | 文字を小さな丸で表示するかどうか | - | false | - |
| clearButtonMode | 文字列 | クリアボタンを表示するかどうか | - | Never | - |
| maxLength | 整数 | テキストの最大文字数 | - | INT_MAX | - |
| validationRegex | 文字列 | 入力文字列の検証に使用する正規表現 | - | nil | 1.2-10 |
| prompt | 文字列 | 入力ダイアログのタイトル | ローカライズ可能 | nil | 1.2-10 |
| message | 文字列 | 入力ダイアログのメッセージ | ローカライズ可能 | nil | 1.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 | 数字と句読点 |
| URL | URL |
| 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 = "取消"; -- キャンセルボタンのタイトル
};

