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ức | Loạ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ên | Loại | 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ó 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ên | Loại | Mô tả |
---|---|---|
fieldName | String | Khoá 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)
setSelected(selected)
Đặt xem nút chuyển này sẽ bắt đầu như đã chọn hay bỏ chọn.
Tham số
Tên | Loại | Mô tả |
---|---|---|
selected | Boolean | Chế độ 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ên | Loại | Mô tả |
---|---|---|
value | String | Giá 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.