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	網址
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 = "取消";  -- 取消按鈕標題
};

主題

範例​

範例