Class Columns

الأعمدة

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

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

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

• على الويب، يتم التفاف العمود الثاني إذا كان عرض الشاشة أقل من أو يساوي 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);

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
addColumn(column)	Columns	يضيف Column إلى التطبيق المصغّر "الأعمدة".
addEventAction(eventAction)	Widget	تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setId(id)	Widget	يضبط هذا الإجراء المعرّف الفريد الذي تمّ تعيينه والذي يُستخدَم لتحديد الأداة التي سيتمّ تغييرها.
setVisibility(visibility)	Widget	تضبط هذه السمة مستوى ظهور الأداة.
setWrapStyle(wrapStyle)	Columns	يضبط هذا السمة نمط التفاف الأعمدة، ويتحكّم في كيفية تغيير حجم العمود استنادًا إلى عرض الشاشة.

مستندات تفصيلية

addColumn(column)

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

const columns = CardService.newColumns().addColumn(CardService.newColumn());

المَعلمات

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

الإرجاع

Columns: هذا العنصر، للتسلسل

---

addEventAction(eventAction)

تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.

المَعلمات

الاسم	النوع	الوصف
eventAction	EventAction	تمثّل هذه السمة EventAction المطلوب إضافتها.

الإرجاع

Widget — العنصر، للتسلسل

---

setId(id)

يضبط هذا الإجراء المعرّف الفريد الذي تمّ تعيينه والذي يُستخدَم لتحديد الأداة التي سيتمّ تغييرها. لا يمكن تغيير التطبيقات المصغّرة إلا في الإضافات.

المَعلمات

الاسم	النوع	الوصف
id	String	معرّف الأداة، ويمكن أن يتضمّن 64 حرفًا بحدّ أقصى وبالتنسيق `[a-zA-Z0-9-]+`.

الإرجاع

Widget: هذا العنصر، للتسلسل

---

setVisibility(visibility)

تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي `VISIBLE`.

المَعلمات

الاسم	النوع	الوصف
visibility	Visibility	Visibility الأداة

الإرجاع

Widget — العنصر، للتسلسل

---

setWrapStyle(wrapStyle)

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

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

المَعلمات

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

الإرجاع

Columns: هذا العنصر، للتسلسل