Class Columns

ستون‌ها

ویجت Columns حداکثر ۲ ستون را در یک کارت یا کادر محاوره‌ای نمایش می‌دهد. می‌توانید به هر Column ویجت اضافه کنید؛ ویجت‌ها به ترتیبی که مشخص شده‌اند ظاهر می‌شوند. برای مثال در برنامه‌های چت گوگل، به ستون‌ها مراجعه کنید.

ارتفاع هر ستون توسط ستون بلندتر تعیین می‌شود. برای مثال، اگر ستون اول از ستون دوم بلندتر باشد، هر دو ستون ارتفاع ستون اول را دارند. از آنجا که هر ستون می‌تواند شامل تعداد متفاوتی از ویجت‌ها باشد، نمی‌توانید ردیف تعریف کنید یا ویجت‌ها را بین ستون‌ها تراز کنید.

ستون‌ها در کنار هم نمایش داده می‌شوند. می‌توانید عرض هر ستون را با استفاده از فیلد Horizontal Size Style تنظیم کنید. اگر عرض صفحه نمایش کاربر خیلی باریک باشد، ستون دوم زیر ستون اول قرار می‌گیرد:

  • در وب، ستون دوم در صورتی که عرض صفحه نمایش کمتر یا مساوی ۴۸۰ پیکسل باشد، جمع می‌شود.
  • در دستگاه‌های iOS، اگر عرض صفحه نمایش کمتر یا مساوی ۳۰۰ pt باشد، ستون دوم جمع می‌شود.
  • در دستگاه‌های اندروید، اگر عرض صفحه نمایش کمتر یا مساوی ۳۲۰ dp باشد، ستون دوم جمع می‌شود.

برای برنامه‌های 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);

روش‌ها

روش نوع بازگشتی شرح مختصر
add Column(column) Columns یک Column به ویجت ستون‌ها اضافه می‌کند.
add Event Action(eventAction) Widget رویدادی را اضافه می‌کند که می‌توان روی ویجت اجرا کرد.
set Id(id) Widget شناسه منحصر به فرد اختصاص داده شده برای شناسایی ویجت مورد نظر برای تغییر را تنظیم می‌کند.
set Visibility(visibility) Widget میزان نمایش ویجت را تنظیم می‌کند.
set Wrap Style(wrapStyle) Columns سبک پوشش ستون‌ها را تنظیم می‌کند، نحوه تغییر اندازه ستون را بر اساس عرض صفحه نمایش کنترل می‌کند.

مستندات دقیق

add Column(column)

یک Column به ابزارک ستون‌ها اضافه می‌کند. ستون‌ها به ترتیبی که اضافه شده‌اند نمایش داده می‌شوند. می‌توانید تا دو ستون اضافه کنید.

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

پارامترها

نام نوع توضیحات
column Column یک ستون فرزند برای اضافه کردن به ویجت ستون‌ها.

بازگشت

Columns - این شیء، برای زنجیره‌سازی.

add Event Action(eventAction)

رویدادی را اضافه می‌کند که می‌توان روی ویجت اجرا کرد.

پارامترها

نام نوع توضیحات
event Action Event Action Event Action قرار است اضافه شود.

بازگشت

Widget — شیء، برای زنجیره‌سازی.

set Id(id)

شناسه منحصر به فردی که برای شناسایی ویجت مورد نظر برای تغییر استفاده می‌شود را تنظیم می‌کند. تغییر ویجت فقط در افزونه‌ها پشتیبانی می‌شود.

پارامترها

نام نوع توضیحات
id String شناسه‌ی ویجت، با محدودیت ۶۴ کاراکتر و با فرمت `[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 Style Wrap Style سبک پوششی که برای ستون‌ها تنظیم می‌شود.

بازگشت

Columns - این شیء، برای زنجیره‌سازی.