یک عنصر رابط کاربری که از روشن یا خاموش شدن پشتیبانی می کند. این فقط در یک ویجت DecoratedText
قابل استفاده است.
برای افزونههای Google Workspace و برنامههای 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")));
مواد و روش ها
روش | نوع برگشت | توضیح مختصر |
---|---|---|
setControlType(controlType) | Switch | نوع کنترل سوئیچ را تنظیم می کند. |
setFieldName(fieldName) | Switch | کلیدی را تنظیم می کند که این سوئیچ را در شی رویدادی که هنگام وجود تعامل رابط کاربری ایجاد می شود، مشخص می کند. |
setOnChangeAction(action) | Switch | زمانی که سوئیچ تغییر می کند، اقدامی را تنظیم می کند. |
setSelected(selected) | Switch | تنظیم می کند که آیا این سوئیچ باید به صورت انتخابی یا انتخاب نشده شروع شود. |
setValue(value) | Switch | مقداری را تنظیم می کند که هنگام روشن شدن این سوئیچ به عنوان ورودی فرم ارسال می شود. |
مستندات دقیق
setControlType(controlType)
نوع کنترل سوئیچ را تنظیم می کند. پیشفرض SWITCH
است.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
controlType | SwitchControlType | نوع کنترل سوئیچ |
برگشت
Switch
- این شی، برای زنجیر کردن.
setFieldName(fieldName)
کلیدی را تنظیم می کند که این سوئیچ را در شی رویدادی که هنگام وجود تعامل رابط کاربری ایجاد می شود، مشخص می کند. برای کاربر قابل مشاهده نیست. ضروری.
برخلاف سایر فیلدهای فرم، نام این فیلد نیازی به منحصربفرد بودن ندارد. مقادیر ورودی فرم برای سوئیچ هایی که از همان نام فیلد استفاده می کنند به عنوان یک آرایه برگردانده می شوند. آرایه از مقادیر همه سوئیچ های فعال با نام فیلد تشکیل شده است.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
fieldName | String | کلیدی که برای شناسایی این سوئیچ استفاده می شود. |
برگشت
Switch
- این شی، برای زنجیر کردن.
setOnChangeAction(action)
setSelected(selected)
تنظیم می کند که آیا این سوئیچ باید به صورت انتخابی یا انتخاب نشده شروع شود.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
selected | Boolean | تنظیم وضعیت سوئیچ راه اندازی. |
برگشت
Switch
- این شی، برای زنجیر کردن.
setValue(value)
مقداری را تنظیم می کند که هنگام روشن شدن این سوئیچ به عنوان ورودی فرم ارسال می شود.
مولفه های
نام | تایپ کنید | شرح |
---|---|---|
value | String | مقدار مرتبط با نام زمانی که سوئیچ روشن است. هنگامی که این به فراخوانی فرم ارسال می شود، همیشه به عنوان یک رشته نمایش داده می شود. |
برگشت
Switch
- این شی، برای زنجیر کردن.