Class Switch

Switch

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

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

const 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 chế độ điều khiển của switch.
setFieldName(fieldName)	Switch	Đặt khoá xác định switch này trong đối tượng sự kiện được tạo khi có một lượt tương tác với giao diện người dùng.
setOnChangeAction(action)	Switch	Đặt hành động cần thực hiện khi switch được bật/tắt.
setSelected(selected)	Switch	Đặt xem switch này có nên bắt đầu ở trạng thái đã chọn hay chưa 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 chế độ điều khiển của switch. Giá trị mặc định là SWITCH.

Tham số

Tên	Loại	Mô tả
controlType	SwitchControlType	Loại chế độ điều khiển của switch.

Cầu thủ trả bóng

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

---

setFieldName(fieldName)

Đặt khoá xác định switch này trong đối tượng sự kiện được tạo khi có một lượt tương tác với giao diện người dùng. Không hiển thị cho 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. Các giá trị đầu vào của biểu mẫu cho các nút chuyển sử dụng cùng một tên trường được trả về 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 switch đã bật có tên trường đó.

Tham số

Tên	Loại	Mô tả
fieldName	String	Khoá dùng để xác định switch 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 switch được bật/tắt.

Tham số

Tên	Loại	Mô tả
action	Action	Hành động cần thực hiện khi switch được bật/tắt.

Cầu thủ trả bóng

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

---

setSelected(selected)

Đặt xem switch này có nên bắt đầu ở trạng thái đã chọn hay chưa chọn.

Tham số

Tên	Loại	Mô tả
selected	Boolean	Cài đặt trạng thái switch 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ị được liên kết với tên khi switch ở trạng thái bật. Khi được gửi đến lệnh gọi lại biểu mẫu, giá trị 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.