Class Switch

Switch

Một thành phần trên giao diện người dùng hỗ trợ chế độ bật hoặc tắt. Bạn chỉ có thể dùng thuộc tính này trong tiện ích DecoratedText.

Dùng được cho các tiện ích bổ sung của Google Workspace và ứng dụng Google Chat.

var switchDecoratedText  = CardService.newDecoratedText()
  .setTopLabel("Switch decorated text widget label")
  .setText("This is a decorated text widget with a switch on the right")
  .setWrapText(true)
  .setSwitchControl(CardService.newSwitch()
      .setFieldName("form_input_switch_key")
      .setValue("form_input_switch_value")
      .setOnChangeAction(CardService.newAction()
          .setFunctionName("handleSwitchChange")));

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
setControlType(controlType)SwitchĐặt loại điều khiển của nút chuyển.
setFieldName(fieldName)SwitchĐặt khoá xác định nút chuyển này trong đối tượng sự kiện được tạo khi có Tương tác giao diện người dùng.
setOnChangeAction(action)SwitchĐặt hành động cần thực hiện khi nút chuyển được bật/tắt.
setSelected(selected)SwitchĐặt xem nút chuyển này sẽ bắt đầu như đã chọn hay bỏ chọn.
setValue(value)SwitchĐặt giá trị được gửi dưới dạng dữ liệu đầu vào của biểu mẫu khi nút chuyển này được bật.

Tài liệu chi tiết

setControlType(controlType)

Đặt loại điều khiển của nút chuyển. Giá trị mặc định là SWITCH.

Tham số

TênLoạiMô tả
controlTypeSwitchControlTypeLoại điều khiển công tắc.

Cầu thủ trả bóng

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


setFieldName(fieldName)

Đặt khoá xác định nút chuyển này trong đối tượng sự kiện được tạo khi có Tương tác giao diện người dùng. Người dùng không nhìn thấy. Bắt buộc.

Không giống như các trường biểu mẫu khác, tên trường này không cần phải là duy nhất. Các giá trị nhập vào biểu mẫu cho các nút chuyển sử dụng cùng tên trường sẽ được trả về dưới dạng mảng. Mảng này bao gồm cho tất cả các nút chuyển đã bật có tên trường đó.

Tham số

TênLoạiMô tả
fieldNameStringKhoá dùng để nhận dạng công tắc này.

Cầu thủ trả bóng

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


setOnChangeAction(action)

Đặt hành động cần thực hiện khi nút chuyển được bật/tắt.

Tham số

TênLoạiMô tả
actionActionThao tác sẽ thực hiện khi công tắc được bật.

Cầu thủ trả bóng

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


setSelected(selected)

Đặt xem nút chuyển này sẽ bắt đầu như đã chọn hay bỏ chọn.

Tham số

TênLoạiMô tả
selectedBooleanChế độ cài đặt trạng thái chuyển đổi bắt đầu.

Cầu thủ trả bóng

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


setValue(value)

Đặt giá trị được gửi dưới dạng dữ liệu đầu vào của biểu mẫu khi nút chuyển này được bật.

Tham số

TênLoạiMô tả
valueStringGiá trị liên kết với tên khi nút chuyển ở trạng thái bật. Khi điều này được gửi đến lệnh gọi lại biểu mẫu, hàm này luôn được biểu thị dưới dạng một chuỗi.

Cầu thủ trả bóng

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