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

Class Switch

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

Có sẵn cho các ứng dụng Tiện ích bổ sung của Google Workspace và 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	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ó hoạt động 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 bật/tắt nút chuyển.
`setSelected(selected)`	`Switch`	Đặt trạng thái ban đầu của nút chuyển này là đã 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 đ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 nút chuyển.

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ó hoạt động tương tác với 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à tên duy nhất. Các giá trị nhập của biểu mẫu cho các nút chuyển sử dụng cùng một tên trường sẽ đượ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 nút chuyển đã bật có tên trường đó.

Tham số

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

Tham số

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

Cầu thủ trả bóng

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

`setSelected(selected)`

Đặt trạng thái ban đầu của nút chuyển này là đã chọn hay chưa chọn.

Tham số

Tên	Loại	Mô tả
`selected`	`Boolean`	Chế độ cài đặt trạng thái nút chuyển 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 nút chuyển 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.