TextField (Trường văn bản)

Hiển thị trường văn bản một dòng để nhập chuỗi.

Khóa	Kiểu	Mô tả	Bắt buộc	Mặc định	Phiên bản tối thiểu
alignment	string	Căn chỉnh văn bản	–	Left	–
keyboard	string	Loại bàn phím	–	Default	–
placeholder	string	Văn bản giữ chỗ	Có thể bản địa hóa	""	–
isSecure	boolean	Che ký tự bằng dấu chấm	–	false	–
clearButtonMode	string	Hiển thị nút xóa	–	Never	–
maxLength	integer	Độ dài văn bản tối đa	–	INT_MAX	–
validationRegex	string	Biểu thức chính quy dùng để xác thực dữ liệu nhập	–	nil	1.2-10
prompt	string	Tiêu đề lời nhắc	Có thể bản địa hóa	nil	1.2-10
message	string	Nội dung lời nhắc	Có thể bản địa hóa	nil	1.2-10
okTitle	string	Tiêu đề nút xác nhận của lời nhắc	Có thể bản địa hóa	"OK"	1.2-10
cancelTitle	string	Tiêu đề nút hủy của lời nhắc	Có thể bản địa hóa	"Cancel"	1.2-10

Thành phần này không hỗ trợ icon. Nếu đặt label, nên đặt alignment thành "Right".

Nếu dữ liệu nhập không khớp với validationRegex, dữ liệu đó không thể được lưu.

Nếu prompt hoặc message không rỗng, thao tác nhấn TextField sẽ hiển thị hộp thoại nhắc để nhập dữ liệu tại đó.

alignment	Mô tả
Left	Trái
Center	Giữa
Right	Phải
Natural	Tự nhiên
Justified	Căn đều

keyboard	Mô tả
Default	Bàn phím hệ thống và bên thứ ba
Alphabet	ASCII
ASCIICapable	ASCII
NumbersAndPunctuation	Số và dấu câu
URL	URL
NumberPad	Bàn phím số
PhonePad	Bàn phím điện thoại
NamePhonePad	Tên và điện thoại
EmailAddress	Địa chỉ email
DecimalPad	Số có dấu thập phân

clearButtonMode	Mô tả
Never	Không bao giờ
Always	Luôn luôn
WhileEditing	Trong khi chỉnh sửa
UnlessEditing	Khi không chỉnh sửa

Kiểu trả về	Mô tả
string	Giá trị trường văn bản

Chủ đề

Khóa chủ đề	Kiểu	Mô tả
textColor	Color	Màu văn bản
caretColor	Color	Màu con trỏ nhập
placeholderColor	Color	Màu văn bản giữ chỗ

Ví dụ

{
    default = "";
    label = "Tên người dùng";
    cell = "TextField";
    key = "username";
    keyboard = "Default";
    alignment = "Right";
    placeholder = "Nhập tên người dùng";
    maxLength = 21;
    validationRegex = "^[0-9a-zA-Z]+$";
};
{
    isSecure = true;
    default = "";
    label = "Mật khẩu";
    cell = "TextField";
    key = "password";
    keyboard = "NumberPad";
    alignment = "Right";
    placeholder = "Nhập mật khẩu";
    prompt = "Nhập mật khẩu";
    message = "Vui lòng nhập mật khẩu gồm 6 chữ số";
    validationRegex = "^[0-9]{6}$";
    okTitle = "Lưu";
    cancelTitle = "Hủy";
};