Class Columns

الأعمدة

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

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

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

  • على الويب، يتمّ عرض العمود الثاني بشكل مُعدَّل إذا كان عرض الشاشة أقلّ من أو يساوي 480 بكسل.
  • على أجهزة iOS، يتمّ عرض العمود الثاني على عدة أسطر إذا كان عرض الشاشة أقل من أو يساوي 300 pt.
  • على أجهزة 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 إلى أداة "الأعمدة"
setWrapStyle(wrapStyle)Columnsتُستخدَم لضبط نمط التفاف الأعمدة، كما تتيح التحكّم في كيفية تغيير حجم العمود استنادًا إلى عرض الشاشة.

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

addColumn(column)

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

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

المعلمات

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

الإرجاع

Columns: هذا العنصر، لإنشاء سلسلة.


setWrapStyle(wrapStyle)

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

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

المعلمات

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

الإرجاع

Columns: هذا العنصر، لإنشاء سلسلة.