تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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());

المعلَمات

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

الإرجاع

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

`setWrapStyle(wrapStyle)`

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

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

المعلَمات

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

الإرجاع

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