Tiện ích trường nhập dữ liệu chấp nhận phương thức nhập văn bản.
Được cung cấp cho tiện ích bổ sung của Google Workspace và ứng dụng Google Chat.
var 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 | Kiểu dữ liệu trả về | Mô tả ngắn |
---|---|---|
setFieldName(fieldName) | TextInput | Đặ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ó một hoạt động tương tác trên giao diện người dùng. |
setHint(hint) | TextInput | Đặt gợi ý cho mục nhập văn bản. |
setMultiline(multiline) | TextInput | Thiết lập xem văn bản nhập hiển thị trên một dòng hay nhiều dòng. |
setOnChangeAction(action) | TextInput | Đặt một thao tác cần thực hiện bất cứ khi nào phương thức nhập văn bản thay đổi. |
setSuggestions(suggestions) | TextInput | Đặt các đề xuất cho tính năng tự động hoàn thành trong trường văn bản. |
setSuggestionsAction(suggestionsAction) | TextInput | Đặt hành động gọi lại để tìm nạp đề xuất dựa trên hoạt động nhập của người dùng để tự động hoàn thành. |
setTitle(title) | TextInput | Đặt tiêu đề xuất hiện phía trên trường nhập dữ liệu. |
setValue(value) | TextInput | Đặt giá trị điền sẵn sẽ được đặt trong trường nhập dữ liệu. |
Tài liệu chi tiết
setFieldName(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ó một hoạt động tương tác trên giao diện người dùng. Không hiển thị với người dùng. Bắt buộc, phải là duy nhất.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
fieldName | String | Khoá dùng để xác định dữ liệu đầu vào này. |
Cầu thủ trả bóng
TextInput
– Đối tượng này để tạo chuỗi.
setHint(hint)
Đặt gợi ý cho mục 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") của trường số điện thoại.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
hint | String | Gợi ý văn bản hiển thị bên dưới trường nhập dữ liệu. Văn bản này sẽ luôn hiển thị. |
Cầu thủ trả bóng
TextInput
– Đối tượng này để tạo chuỗi.
setMultiline(multiline)
Thiết lập xem văn bản nhập hiển thị trên một dòng hay nhiều dòng.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
multiline | Boolean | Chế độ cài đặt nhiều dòng. |
Cầu thủ trả bóng
TextInput
– Đối tượng này để tạo chuỗi.
setOnChangeAction(action)
setSuggestions(suggestions)
Đặt các đề xuất cho tính năng tự động hoàn thành trong trường văn bản.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
suggestions | Suggestions | Tập hợp các đề xuất để sử dụng. |
Cầu thủ trả bóng
TextInput
– Đối tượng này để tạo chuỗi.
setSuggestionsAction(suggestionsAction)
Đặt hành động gọi lại để tìm nạp đề xuất dựa trên hoạt động nhập 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 SuggestionsResponse
.
var action = CardService.newAction() .setFunctionName('suggestionCallback') .setParameters({'numSuggestions': 3}); CardService.newTextInput() .setFieldName('option-field') .setTitle('Option Selected') .setSuggestionsAction(action); // ... function suggestionCallback(e) { var suggestions = CardService.newSuggestions(); var numSuggestions = parseInt(e.parameter['numSuggestions']); for(var i = 1; i <= numSuggestions; i++) { suggestions.addSuggestion('Suggestion ' + i); } return CardService.newSuggestionsResponseBuilder() .setSuggestions(suggestions) .build(); }
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
suggestionsAction | Action | Hành động tìm nạp đề xuất cho dữ liệu nhập này. |
Cầu thủ trả bóng
TextInput
– Đối tượng này để tạo chuỗi.
setTitle(title)
Đặt tiêu đề xuất hiện phía trên trường nhập dữ liệu. Bắt buộc.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
title | String | Nhãn văn bản cho dữ liệu nhập này. |
Cầu thủ trả bóng
TextInput
– Đối tượng này để tạo chuỗi.
setValue(value)
Đặt giá trị điền sẵn sẽ được đặt trong trường nhập dữ liệu.
Tham số
Tên | Loại | Nội dung mô tả |
---|---|---|
value | String | Giá trị mặc định được đặt trong dữ liệu nhập. Giá trị này luôn được biểu thị dưới dạng chuỗi trong các tham số gọi lại của biểu mẫu. |
Cầu thủ trả bóng
TextInput
– Đối tượng này để tạo chuỗi.