عنصر في واجهة المستخدم يتيح تفعيل هذا الإعداد أو إيقافه، ولا يمكن استخدامه إلا داخل تطبيق 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
: هذا الكائن، للتسلسل.