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: هذا العنصر، لإنشاء سلسلة.