Trang này được dịch bởi Cloud Translation API.

Class TextInput

Tiện ích trường nhập dữ liệu chấp nhận phương thức nhập văn bản.

Dùng được cho các 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	Loại dữ liệu trả về	Mô tả ngắn
`setFieldName(fieldName)`	`TextInput`	Đặt khoá xác định dữ liệu đầu vào văn bản này trong đối tượng sự kiện được tạo khi ở đó là tương tác trên giao diện người dùng.
`setHint(hint)`	`TextInput`	Đặt gợi ý cho việc nhập văn bản.
`setMultiline(multiline)`	`TextInput`	Đặt xem văn bản nhập hiển thị trên một hay nhiều dòng.
`setOnChangeAction(action)`	`TextInput`	Đặt một hành động cần thực hiện bất cứ khi nào nội dung nhập văn bản thay đổi.
`setSuggestions(suggestions)`	`TextInput`	Đặt gợi ý cho tính năng tự động hoàn thành trong trường văn bản.
`setSuggestionsAction(suggestionsAction)`	`TextInput`	Thiết lập hành động gọi lại để tìm nạp nội dung đề xuất dựa trên hoạt động tự động hoàn thành của người dùng.
`setTitle(title)`	`TextInput`	Đặt tiêu đề hiển thị phía trên trường nhập dữ liệu.
`setValue(value)`	`TextInput`	Đặt giá trị điền sẵn trong trường nhập dữ liệu.

Tài liệu chi tiết

`setFieldName(fieldName)`

Đặt khoá xác định dữ liệu đầu vào văn bản này trong đối tượng sự kiện được tạo khi ở đó là tương tác trên 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ả
`fieldName`	`String`	Khoá dùng để nhận dạng nguồn đầ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 việc nhập văn bản. Dùng để cung cấp thêm hướng dẫn cho người dùng về nội dung cần nhập. Cho 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 xuất hiện bên dưới trường nhập dữ liệu. 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 hiển thị trên một 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

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

`setOnChangeAction(action)`

Đặt một hành động cần thực hiện bất cứ khi nào nội dung nhập văn bản thay đổi.

Tham 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 gợi ý cho tính năng tự động hoàn thành trong trường văn bản.

Tham số

Tên	Loại	Mô tả
`suggestions`	`Suggestions`	Bộ sưu tậ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)`

Thiết lập hành động gọi lại để tìm nạp nội dung đề xuất dựa trên hoạt động tự động hoàn thành của người dùng. Chiến lược phát hành đĩa đơn 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	Mô tả
`suggestionsAction`	`Action`	Hành động tìm nạp đề 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 đề cần hiển thị phía trên trường nhập dữ liệu. Bắt buộc.

Tham số

Tên	Loại	Mô tả
`title`	`String`	Nhãn văn bản cho nguồn đầu vào 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 trong trường nhập dữ liệu.

Tham số

Tên	Loại	Mô tả
`value`	`String`	Giá trị mặc định được đặt trong thông tin đầu vào. Giá trị này luôn được biểu thị dưới dạng một chuỗi trong tham số lệnh gọi lại trong biểu mẫu.

Cầu thủ trả bóng

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