Class SelectionInput

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
SelectionInput

حقل إدخال يسمح بالاختيار من بين مجموعة من الخيارات المحدّدة مسبقًا.

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)

إضافة عنصر جديد يمكن اختياره.

المعلّمات

الاسمالنوعالوصف
textObjectالنص المطلوب عرضه لهذا العنصر. يتم تحويل الوسيطات الأولية غير النصية إلى سلاسل تلقائيًا.
valueObjectقيمة إرسال النموذج التي يتم إرسالها عبر معاودة الاتصال يتم تحويل الوسيطات الأولية غير النصية إلى سلاسل تلقائيًا.
selectedBooleanيمكنك اختيار ما إذا كنت تريد أن يبدأ العنصر في الاختيار أم لا.

تذكرة ذهاب وعودة

SelectionInput — هذا العنصر للسلاسل.


setFieldName(fieldName)

يحدّد المفتاح الذي يحدِّد إدخال الاختيار هذا في كائن الحدث الذي يتم إنشاؤه عند تفاعل مع واجهة مستخدم. غير مرئية للمستخدم يجب أن تكون فريدة.

المعلّمات

الاسمالنوعالوصف
fieldNameStringالاسم الذي سيتم تخصيصه لهذا الإدخال.

تذكرة ذهاب وعودة

SelectionInput — هذا العنصر للسلاسل.


setOnChangeAction(action)

تتيح هذه السياسة ضبط Action لتنفيذها كلما تغيّر إدخال الاختيار.

المعلّمات

الاسمالنوعالوصف
actionActionالإجراء الواجب اتخاذه.

تذكرة ذهاب وعودة

SelectionInput — هذا العنصر للسلاسل.


setTitle(title)

ضبط العنوان الذي سيتم عرضه قبل حقل الإدخال

المعلّمات

الاسمالنوعالوصف
titleStringعنوان حقل الإدخال

تذكرة ذهاب وعودة

SelectionInput — هذا العنصر للسلاسل.


setType(type)

تعمل على ضبط نوع هذا الإدخال. القيمة التلقائية هي CHECKBOX.

المعلّمات

الاسمالنوعالوصف
typeSelectionInputTypeنوع الاختيار

تذكرة ذهاب وعودة

SelectionInput — هذا العنصر للسلاسل.