Class Columns

الأعمدة

تعرض الأداة Columns ما يصل إلى عمودَين في بطاقة أو مربّع حوار. يمكنك إضافة تطبيقات مصغّرة إلى كل Column، وتظهر التطبيقات المصغّرة بالترتيب الذي تم تحديده. للاطّلاع على مثال في تطبيقات Google Chat، راجِع الأعمدة.

يتم تحديد ارتفاع كل عمود حسب العمود الأطول. على سبيل المثال، إذا كان العمود الأول أطول من العمود الثاني، سيكون ارتفاع كلا العمودين هو ارتفاع العمود الأول. بما أنّ كل عمود يمكن أن يحتوي على عدد مختلف من التطبيقات المصغّرة، لا يمكنك تحديد الصفوف أو محاذاة التطبيقات المصغّرة بين الأعمدة.

يتم عرض الأعمدة جنبًا إلى جنب. يمكنك تخصيص عرض كل عمود باستخدام الحقل HorizontalSizeStyle. إذا كان عرض شاشة المستخدم ضيقًا جدًا، سيتم نقل العمود الثاني إلى أسفل العمود الأول:

  • على الويب، يتم التفاف العمود الثاني إذا كان عرض الشاشة أقل من أو يساوي 480 بكسل.
  • على أجهزة iOS، يتم التفاف العمود الثاني إذا كان عرض الشاشة أقل من أو يساوي 300 نقطة.
  • على أجهزة Android، يتم التفاف العمود الثاني إذا كان عرض الشاشة أقل من 320 وحدة بكسل مستقلة الكثافة أو يساويها.

متاحة لتطبيقات Google Chat وإضافات Google Workspace تشمل واجهات المستخدم الخاصة بالإضافة التي تتوافق مع الأعمدة ما يلي:

  • مربّع الحوار الذي يظهر عندما يفتح المستخدمون الإضافة من مسودة رسالة إلكترونية
  • مربّع الحوار الذي يظهر عندما يفتح المستخدمون الإضافة من قائمة إضافة مرفق في حدث على "تقويم Google"
    // Build a column that is aligned in the center and fills the space:
    const column =
        CardService.newColumn()
            .setHorizontalSizeStyle(
                CardService.HorizontalSizeStyle.FILL_AVAILABLE_SPACE)
            .setHorizontalAlignment(CardService.HorizontalAlignment.CENTER)
            .setVerticalAlignment(CardService.VerticalAlignment.CENTER);
    const columns = CardService.newColumns().addColumn(column).setWrapStyle(
        CardService.WrapStyle.WRAP);

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
addColumn(column)Columnsيضيف Column إلى التطبيق المصغّر "الأعمدة".
addEventAction(eventAction)Widgetتضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)Widgetتضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها.
setVisibility(visibility)Widgetتضبط هذه السمة مستوى ظهور الأداة.
setWrapStyle(wrapStyle)Columnsيضبط هذا السمة نمط التفاف الأعمدة، ويتحكّم في كيفية تغيير حجم العمود استنادًا إلى عرض الشاشة.

مستندات تفصيلية

addColumn(column)

يضيف Column إلى التطبيق المصغّر "الأعمدة". يتم عرض الأعمدة بالترتيب الذي تمت إضافتها به. يمكنك إضافة عمودَين كحدّ أقصى.

const columns = CardService.newColumns().addColumn(CardService.newColumn());

المعلمات

الاسمالنوعالوصف
columnColumnعمود فرعي لإضافته إلى التطبيق المصغّر "الأعمدة"

الإرجاع

Columns: هذا الكائن، للتسلسل


addEventAction(eventAction)

تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.

المعلمات

الاسمالنوعالوصف
eventActionEventActionتمثّل هذه السمة EventAction المطلوب إضافتها.

الإرجاع

Widget — العنصر، للتسلسل.


setId(id)

تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. لا يمكن تعديل التطبيقات المصغّرة إلا في الإضافات.

المعلمات

الاسمالنوعالوصف
idStringمعرّف الأداة، ويجب ألا يتجاوز 64 حرفًا وأن يكون بالتنسيق `[a-zA-Z0-9-]+`.

الإرجاع

Widget: هذا الكائن، للتسلسل


setVisibility(visibility)

تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي VISIBLE.

المعلمات

الاسمالنوعالوصف
visibilityVisibilityVisibility الأداة

الإرجاع

Widget — العنصر، للتسلسل.


setWrapStyle(wrapStyle)

يضبط هذا السمة نمط التفاف الأعمدة، ويتحكّم في كيفية تغيير حجم العمود استنادًا إلى عرض الشاشة.

const columns = CardService.newColumns()
                    .addColumn(CardService.newColumn())
                    .setWrapStyle(CardService.WrapStyle.WRAP);

المعلمات

الاسمالنوعالوصف
wrapStyleWrapStyleنمط الالتفاف المطلوب ضبطه للأعمدة.

الإرجاع

Columns: هذا الكائن، للتسلسل