Class TextInput

TextInput (Nhập văn bản)

Một tiện ích trường nhập chấp nhận phương thức nhập văn bản.

Hỗ trợ xác thực việc gửi biểu mẫu. Khi Action.setAllWidgetsAreRequired(allWidgetsAreRequired) được đặt thành true hoặc tiện ích này được chỉ định thông qua Action.addRequiredWidget(requiredWidget), thao tác gửi sẽ bị chặn trừ phi bạn nhập một giá trị.

Có sẵn cho các tiện ích bổ sung của Google Workspace và ứng dụng 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	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ó tương tác với giao diện người dùng.
setHint(hint)	TextInput	Đặt gợi ý cho hoạt động nhập văn bản.
setMultiline(multiline)	TextInput	Đặt xem văn bản nhập vào hiển thị trên một dòng hay nhiều dòng.
setOnChangeAction(action)	TextInput	Đặ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.
setSuggestions(suggestions)	TextInput	Đặt nội dung đề xuất tự động hoàn thành trong trường văn bản.
setSuggestionsAction(suggestionsAction)	TextInput	Đặt thao tác gọi lại để tìm nạp các đề xuất dựa trên dữ liệu đầu vào của người dùng để tự động hoàn thành.
setTitle(title)	TextInput	Đặt tiêu đề sẽ hiển thị phía trên trường nhập.
setValidation(validation)	TextInput	Đặt quy tắc xác thực cho tiện ích này.
setValue(value)	TextInput	Đặt giá trị được điền sẵn trong trường nhập.

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ó 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.

Thông số

Tên	Loại	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 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.

Thông 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

TextInput – Đối tượng này, để tạo chuỗi.

---

setMultiline(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.

Thông số

Tên	Loại	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)

Đặ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.

Thông số

Tên	Loại	Mô tả
action	Action	Hành động cần thực hiện.

Cầu thủ trả bóng

TextInput – Đối tượng này, để tạo chuỗi.

---

setSuggestions(suggestions)

Đặt nội dung đề xuất tự động hoàn thành trong trường văn bản.

Thông 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

TextInput – Đối tượng này, để tạo chuỗi.

---

setSuggestionsAction(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 SuggestionsResponse.

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();
}

Thông số

Tên	Loại	Mô tả
suggestionsAction	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

TextInput – Đối tượng này, để tạo chuỗi.

---

setTitle(title)

Đặt tiêu đề sẽ hiển thị phía trên trường nhập. Bắt buộc.

Thông 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

TextInput – Đối tượng này, để tạo chuỗi.

---

setValidation(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);

Thông số

Tên	Loại	Mô tả
validation	Validation	Quy tắc xác thực cho tiện ích TextInput này.

Cầu thủ trả bóng

TextInput – Đối tượng này, để tạo chuỗi.

---

setValue(value)

Đặt giá trị được điền sẵn trong trường nhập.

Thông 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 tham số lệnh 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.