Một thành phần trên giao diện người dùng hỗ trợ bật hoặc tắt. Bạn chỉ có thể sử dụng thành phần này trong tiện ích DecoratedText.
Được cung cấp cho 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ức | Kiểu 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ó một hoạt động tương tác trên 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. |
setSelected(selected) | Switch | Đặt nút chuyển này sẽ bắt đầu ở trạng thái đã chọn hay bỏ chọn. |
setValue(value) | Switch | Đặt giá trị được gửi dưới dạng thông tin nhập vào 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ên | Loại | Nội dung mô tả |
|---|---|---|
controlType | SwitchControlType | Loạ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ó 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.
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. Hệ thống trả về giá trị đầu vào của biểu mẫu cho các nút chuyển sử dụng cùng tên trường dưới dạng một mảng. Mảng này bao gồm các giá trị cho tất cả các nút chuyển đã bật có tên trường đó.
Tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
fieldName | String | Khoá dùng để xác định công tắc này. |
Cầu thủ trả bóng
Switch – Đối tượng này để tạo chuỗi.
setOnChangeAction(action)
setSelected(selected)
Đặt nút chuyển này sẽ bắt đầu ở trạng thái đã chọn hay bỏ chọn.
Tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
selected | Boolean | Chế độ cài đặt trạng thái công tắc khởi động. |
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 thông tin nhập vào biểu mẫu khi nút chuyển này được bật.
Tham số
| Tên | Loại | Nội dung mô tả |
|---|---|---|
value | String | Giá trị được liên kết với tên khi nút chuyển được bật. Khi được gửi đến lệnh gọi lại biểu mẫu, tham số 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.