حقل إدخال يسمح بالاختيار من بين مجموعة من الخيارات المحدّدة مسبقًا.
var checkboxGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.CHECK_BOX) .setTitle("A group of checkboxes. Multiple selections are allowed.") .setFieldName("checkbox_field") .addItem("checkbox one title", "checkbox_one_value", false) .addItem("checkbox two title", "checkbox_two_value", true) .addItem("checkbox three title", "checkbox_three_value", true) .setOnChangeAction(CardService.newAction() .setFunctionName("handleCheckboxChange")); var radioGroup = CardService.newSelectionInput() .setType(CardService.SelectionInputType.RADIO_BUTTON) .setTitle("A group of radio buttons. Only a single selection is allowed.") .setFieldName("checkbox_field") .addItem("radio button one title", "radio_one_value", true) .addItem("radio button two title", "radio_two_value", false) .addItem("radio button three title", "radio_three_value", false);
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
addItem(text, value, selected) | SelectionInput | إضافة عنصر جديد يمكن اختياره. |
setFieldName(fieldName) | SelectionInput | يحدّد المفتاح الذي يحدِّد إدخال الاختيار هذا في كائن الحدث الذي يتم إنشاؤه عند تفاعل مع واجهة مستخدم. |
setOnChangeAction(action) | SelectionInput | تتيح هذه السياسة ضبط Action لتنفيذها كلما تغيّر إدخال الاختيار. |
setTitle(title) | SelectionInput | ضبط العنوان الذي سيتم عرضه قبل حقل الإدخال |
setType(type) | SelectionInput | تعمل على ضبط نوع هذا الإدخال. |
المستندات التفصيلية
addItem(text, value, selected)
إضافة عنصر جديد يمكن اختياره.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | Object | النص المطلوب عرضه لهذا العنصر. يتم تحويل الوسيطات الأولية غير النصية إلى سلاسل تلقائيًا. |
value | Object | قيمة إرسال النموذج التي يتم إرسالها عبر معاودة الاتصال يتم تحويل الوسيطات الأولية غير النصية إلى سلاسل تلقائيًا. |
selected | Boolean | يمكنك اختيار ما إذا كنت تريد أن يبدأ العنصر في الاختيار أم لا. |
تذكرة ذهاب وعودة
SelectionInput
— هذا العنصر للسلاسل.
setFieldName(fieldName)
يحدّد المفتاح الذي يحدِّد إدخال الاختيار هذا في كائن الحدث الذي يتم إنشاؤه عند تفاعل مع واجهة مستخدم. غير مرئية للمستخدم يجب أن تكون فريدة.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
fieldName | String | الاسم الذي سيتم تخصيصه لهذا الإدخال. |
تذكرة ذهاب وعودة
SelectionInput
— هذا العنصر للسلاسل.
setOnChangeAction(action)
تتيح هذه السياسة ضبط Action
لتنفيذها كلما تغيّر إدخال الاختيار.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
action | Action | الإجراء الواجب اتخاذه. |
تذكرة ذهاب وعودة
SelectionInput
— هذا العنصر للسلاسل.
setTitle(title)
ضبط العنوان الذي سيتم عرضه قبل حقل الإدخال
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
title | String | عنوان حقل الإدخال |
تذكرة ذهاب وعودة
SelectionInput
— هذا العنصر للسلاسل.
setType(type)
تعمل على ضبط نوع هذا الإدخال. القيمة التلقائية هي CHECKBOX
.
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
type | SelectionInputType | نوع الاختيار |
تذكرة ذهاب وعودة
SelectionInput
— هذا العنصر للسلاسل.