تعرض الأداة Columns ما يصل إلى عمودَين في بطاقة أو مربّع حوار. يمكنك إضافة تطبيقات مصغّرة إلى كل Column، وتظهر التطبيقات المصغّرة بالترتيب الذي تم تحديده. للاطّلاع على مثال في تطبيقات Google Chat، راجِع الأعمدة.
يتم تحديد ارتفاع كل عمود حسب العمود الأطول. على سبيل المثال، إذا كان العمود الأول أطول من العمود الثاني، سيكون ارتفاع كلا العمودين هو ارتفاع العمود الأول. بما أنّ كل عمود يمكن أن يحتوي على عدد مختلف من التطبيقات المصغّرة، لا يمكنك تحديد الصفوف أو محاذاة التطبيقات المصغّرة بين الأعمدة.
يتم عرض الأعمدة جنبًا إلى جنب. يمكنك تخصيص عرض كل عمود باستخدام الحقل Horizontal. إذا كان عرض شاشة المستخدم ضيقًا جدًا، سيتم نقل العمود الثاني إلى أسفل العمود الأول:
- على الويب، يتم التفاف العمود الثاني إذا كان عرض الشاشة أقل من أو يساوي 480 بكسل.
- على أجهزة iOS، يتم التفاف العمود الثاني إذا كان عرض الشاشة أقل من أو يساوي 300 نقطة.
- على أجهزة 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);
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
add | Columns | يضيف Column إلى التطبيق المصغّر "الأعمدة". |
add | Widget | تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر. |
set | Widget | تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. |
set | Widget | تضبط هذه السمة مستوى ظهور الأداة. |
set | Columns | يضبط هذا السمة نمط التفاف الأعمدة، ويتحكّم في كيفية تغيير حجم العمود استنادًا إلى عرض الشاشة. |
مستندات تفصيلية
add Column(column)
يضيف Column إلى التطبيق المصغّر "الأعمدة". يتم عرض الأعمدة بالترتيب الذي تمت إضافتها به. يمكنك إضافة عمودَين كحدّ أقصى.
const columns = CardService.newColumns().addColumn(CardService.newColumn());
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
column | Column | عمود فرعي لإضافته إلى التطبيق المصغّر "الأعمدة" |
الإرجاع
Columns: هذا الكائن، للتسلسل
add Event Action(eventAction)
تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
event | Event | تمثّل هذه السمة Event المطلوب إضافتها. |
الإرجاع
Widget — العنصر، للتسلسل.
set Id(id)
تضبط هذه السمة المعرّف الفريد الذي تمّ تعيينه والمستخدَم لتحديد الأداة التي سيتمّ تعديلها. لا يمكن تعديل التطبيقات المصغّرة إلا في الإضافات.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
id | String | معرّف الأداة، ويجب ألا يتجاوز 64 حرفًا وأن يكون بالتنسيق `[a-zA-Z0-9-]+`. |
الإرجاع
Widget: هذا الكائن، للتسلسل
set Visibility(visibility)
تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي VISIBLE.
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
visibility | Visibility | Visibility الأداة |
الإرجاع
Widget — العنصر، للتسلسل.
set Wrap Style(wrapStyle)
يضبط هذا السمة نمط التفاف الأعمدة، ويتحكّم في كيفية تغيير حجم العمود استنادًا إلى عرض الشاشة.
const columns = CardService.newColumns() .addColumn(CardService.newColumn()) .setWrapStyle(CardService.WrapStyle.WRAP);
المعلمات
| الاسم | النوع | الوصف |
|---|---|---|
wrap | Wrap | نمط الالتفاف المطلوب ضبطه للأعمدة. |
الإرجاع
Columns: هذا الكائن، للتسلسل