Một tiện ích trường nhập chấp nhận phương thức nhập văn bản.
Có sẵn cho các ứng dụng Tiện ích bổ sung của Google Workspace và Google Chat.
const textInput = CardService.newTextInput() .setFieldName('text_input_form_input_key') .setTitle('Text input title') .setHint('Text input hint');
Phương thức
Phương thức | Loại dữ liệu trả về | Mô tả ngắn |
---|---|---|
set | Text | Đặt khoá xác định phương thức nhập văn bản này trong đối tượng sự kiện được tạo khi có tương tác với giao diện người dùng. |
set | Text | Đặt gợi ý cho hoạt động nhập văn bản. |
set | Text | Đặt xem văn bản nhập vào hiển thị trên một dòng hay nhiều dòng. |
set | Text | Đặt một hành động sẽ được thực hiện bất cứ khi nào dữ liệu nhập văn bản thay đổi. |
set | Text | Đặt nội dung đề xuất tự động hoàn thành trong trường văn bản. |
set | Text | Đặt thao tác gọi lại để tìm nạp nội dung đề xuất dựa trên dữ liệu đầu vào của người dùng để tự động hoàn thành. |
set | Text | Đặt tiêu đề sẽ hiển thị phía trên trường nhập. |
set | Text | Đặt quy tắc xác thực cho tiện ích này. |
set | Text | Đặt giá trị được điền sẵn trong trường nhập. |
Tài liệu chi tiết
set Field Name(fieldName)
Đặt khoá xác định phương thức nhập văn bản này trong đối tượng sự kiện được tạo khi có tương tác với giao diện người dùng. Người dùng không nhìn thấy. Bắt buộc, phải là duy nhất.
Tham số
Tên | Loại | Mô tả |
---|---|---|
field | String | Khoá dùng để xác định dữ liệu đầu vào này. |
Cầu thủ trả bóng
Text
– Đối tượng này, để tạo chuỗi.
set Hint(hint)
Đặt gợi ý cho hoạt động nhập văn bản. Dùng để cung cấp cho người dùng thêm hướng dẫn về nội dung cần nhập. Ví dụ: gợi ý có thể mô tả định dạng ("xxx-xxx-xxxx") cho trường số điện thoại.
Tham số
Tên | Loại | Mô tả |
---|---|---|
hint | String | Gợi ý văn bản sẽ hiển thị bên dưới trường nhập. Văn bản này luôn hiển thị. |
Cầu thủ trả bóng
Text
– Đối tượng này, để tạo chuỗi.
set Multiline(multiline)
Đặt xem văn bản nhập vào hiển thị trên một dòng hay nhiều dòng.
Tham số
Tên | Loại | Mô tả |
---|---|---|
multiline | Boolean | Chế độ cài đặt nhiều dòng. |
Cầu thủ trả bóng
Text
– Đối tượng này, để tạo chuỗi.
set On Change Action(action)
set Suggestions(suggestions)
Đặt nội dung đề xuất tự động hoàn thành trong trường văn bản.
Tham số
Tên | Loại | Mô tả |
---|---|---|
suggestions | Suggestions | Tập hợp các đề xuất để sử dụng. |
Cầu thủ trả bóng
Text
– Đối tượng này, để tạo chuỗi.
set Suggestions Action(suggestionsAction)
Đặt thao tác gọi lại để tìm nạp nội dung đề xuất dựa trên dữ liệu đầu vào của người dùng để tự động hoàn thành. Tham số Action
phải chỉ định một hàm callback trả về đối tượng Suggestions
.
const action = CardService.newAction() .setFunctionName('suggestionCallback') .setParameters({numSuggestions: 3}); CardService.newTextInput() .setFieldName('option-field') .setTitle('Option Selected') .setSuggestionsAction(action); // ... function suggestionCallback(e) { const suggestions = CardService.newSuggestions(); const numSuggestions = Number.parseInt(e.parameter.numSuggestions); for (let i = 1; i <= numSuggestions; i++) { suggestions.addSuggestion(`Suggestion ${i}`); } return CardService.newSuggestionsResponseBuilder() .setSuggestions(suggestions) .build(); }
Tham số
Tên | Loại | Mô tả |
---|---|---|
suggestions | Action | Thao tác tìm nạp nội dung đề xuất cho dữ liệu đầu vào này. |
Cầu thủ trả bóng
Text
– Đối tượng này, để tạo chuỗi.
set Title(title)
Đặt tiêu đề sẽ hiển thị phía trên trường nhập. Bắt buộc.
Tham số
Tên | Loại | Mô tả |
---|---|---|
title | String | Nhãn văn bản cho dữ liệu đầu vào này. |
Cầu thủ trả bóng
Text
– Đối tượng này, để tạo chuỗi.
set Validation(validation)
Đặt quy tắc xác thực cho tiện ích này.
const validation = CardService.newValidation().setCharacterLimit('10').setType( CardService.InputType.TEXT); const input = CardService.newTextInput() .setFieldName('text_name_xxx1') .setTitle('Max 10 characters') .setValidation(validation);
Tham số
Tên | Loại | Mô tả |
---|---|---|
validation | Validation | Quy tắc xác thực cho tiện ích Text này. |
Cầu thủ trả bóng
Text
– Đối tượng này, để tạo chuỗi.
set Value(value)
Đặt giá trị được điền sẵn trong trường nhập.
Tham số
Tên | Loại | Mô tả |
---|---|---|
value | String | Giá trị mặc định được đặt trong dữ liệu đầu vào. Giá trị này luôn được biểu thị dưới dạng chuỗi trong các tham số lệnh gọi lại của biểu mẫu. |
Cầu thủ trả bóng
Text
– Đối tượng này, để tạo chuỗi.