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 = "キャンセル";  -- キャンセルボタンのタイトル
};

テーマ

使用例​

使用例