Class Columns

الأعمدة

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

معاينة المطوِّر: متاحة كجزء من برنامج معاينة المطوّر في Google Workspace الذي يمنح إمكانية استخدام ميزات معيّنة قبل إطلاقها.

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

الأعمدة معروضة جنبًا إلى جنب. يمكنك تخصيص عرض كل عمود باستخدام الحقل 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());

المَعلمات

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

استرجاع الكرة

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

---

setWrapStyle(wrapStyle)

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

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

المَعلمات

الاسم	النوع	الوصف
wrapStyle	WrapStyle	نمط الالتفاف المراد تعيينه للأعمدة.

استرجاع الكرة

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