Class Columns

الأعمدة

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

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

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

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

متاحة لتطبيقات Google Chat وإضافات Google Workspace

// 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 — هذا العنصر، للتسلسل.