ساختن کارت برای برنامه‌های Google Chat

این صفحه نحوه ساختن مؤلفه‌ها و ساختار کارت را شرح می‌دهد. کارت‌ها میاناهای کاربری هستند که برنامه‌های Google Chat می‌توانند از آن‌ها برای ارائه و جمع‌آوری اطلاعات از کاربران Chat استفاده کنند. برنامه‌های Chat می‌توانند کارت‌ها را در میاناهای زیر بسازند و نمایش دهند:

  • پیام‌هایی که حاوی یک یا چند کارت هستند.
  • صفحه‌های اصلی، که کارتی است که از برگه صفحه اصلی در پیام‌های مستقیم با برنامه Chat ظاهر می‌شود.
  • کادرهای گفتگو که کارت‌هایی هستند که در پنجره جدیدی از پیام‌ها و صفحه‌های اصلی باز می‌شوند.

در این صفحه، با مؤلفه‌های زیر در کارت آشنا می‌شوید:

  • سرصفحه‌ها که معمولاً حاوی عنوان کارت یا بخش کارت هستند.
  • بخش‌ها، که بدنه اصلی کارت را تشکیل می‌دهند و شامل ابزاره‌ها و دیگر عناصر تعاملی هستند. در بخش کارت، می‌توانید ساختار بیشتری به کارت اضافه کنید، ازجمله ستون‌ها و شبکه‌ها.
  • پانویس‌های ثابت که در پایین کادرهای گفتگو ظاهر می‌شوند تا عناصر واسط کاربر دائمی، مانند دکمه‌ها، را نمایش دهند.

پیش‌نیازها

برنامه Google Chat که برای دریافت و پاسخ دادن به تعاملات کاربر پیکربندی شده است. برای ایجاد برنامه Chat تعاملی، یکی از شروع‌های سریع زیر را براساس معماری برنامه که می‌خواهید استفاده کنید تکمیل کنید:


از «کارت‌ساز» برای طراحی و پیش‌نمایش پیام‌رسانی و میاناهای کاربر برای برنامه‌های Chat استفاده کنید:

باز کردن «کارت‌ساز»

افزودن سرایند

ابزارک CardHeader نشان‌دهنده سرصفحه کارت است. سرصفحه‌ها می‌توانند شامل عنوان، زیرعنوان، و تصویر چهرک برای کارت شما باشند.

در زیر نمونه‌ای از CardHeader آورده شده است:

یک یا چند بخش کارت اضافه کنید

ابزاره CardSection یک محفظه سطح بالا در کارت است. از بخش‌های کارت برای گروه‌بندی ابزاره‌ها در کارت استفاده می‌کنید. برای هر بخش کارت، می‌توانید یک سرصفحه و یک یا چند ابزاره اضافه کنید.

در زیر نمونه‌ای از CardSection که حاوی دو ابزاره textParagraph است آورده شده است:

افزودن جداکننده افقی بین ابزاره‌ها

dividerابزارک خطی افقی را در سراسر عرض کارت بین ابزارک‌های پشته‌ای عمودی نمایش می‌دهد. این خط یک جداکننده بصری است که به کاربران کمک می‌کند بین ابزارهایی که کارت‌ها را برای اسکن و درک آسان‌تر می‌کنند، تمایز قائل شوند.

در زیر کارتی متشکل از ابزاره divider بین انواع دیگر ابزاره‌ها آمده است:

افزودن ستون

columnsابزاره حداکثر ۲ ستون را در کارت نمایش می‌دهد. می‌توانید به هر ستون ابزاره اضافه کنید؛ ابزاره‌ها به‌ترتیبی که مشخص شده‌اند ظاهر می‌شوند. برای گنجاندن بیش‌از ۲ ستون، یا برای استفاده از ردیف‌ها، از ابزاره grid استفاده کنید.

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

مثال زیر کارتی را با ابزارک columns نشان می‌دهد که دارای ۲ ستون نوشتار است. برای مشاهده فقط چیدمان ستون‌ها و جمع کردن نمونه کد، روی جمع کردن کلیک کنید. وقتی فضا محدود است، مانند مثال زیر، ستون دوم زیر ستون اول قرار می‌گیرد.

تعریف عرض ستون

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

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

مثال زیر کارتی را با ابزاره columns نشان می‌دهد که ۲ ستون نوشتار با ۴ مورد در ستون‌ها دارد. هر مورد در ستون‌ها دارای horizontalSizeStyle است که برای دستکاری میزان فضایی که نوشتار در هر ستون پر می‌کند اعمال شده است:

  • پاراگراف نوشتاری اول از FILL_MINIMUM_SPACE استفاده می‌کند تا بیش‌از ۳۰٪ عرض کارت را پر نکند.
  • پاراگراف نوشتاری دوم از FILL_AVAILABLE_SPACE برای پر کردن فضای دردسترس در عرض کارت استفاده می‌کند. در این مثال، ۷۰٪ از عرض کارت را پر می‌کند.
  • پاراگراف نوشتاری سوم horizontalSizeStyle را تعریف نمی‌کند، بنابراین به‌طور پیش‌فرض فضای دردسترس کارت را پر می‌کند.
  • پاراگراف متنی چهارم از FILL_MINIMUM_SPACE استفاده می‌کند تا حداکثر ۳۰٪ از عرض کارت را پر کند.

تعریف تراز افقی ستون

با تعریف کردن فیلد horizontalAlignment می‌توانید ابزاره‌ها را به‌صورت افقی در سمت چپ، راست، یا مرکز ستون تراز کنید. اگر فیلد horizontalAlignment تعریف نشده باشد، ابزاره‌ها در ستون به‌سمت چپ تراز می‌شوند.

مثال زیر نوشتار را به‌صورت افقی در ستونی در سمت چپ تراز می‌کند:

مثال زیر نوشتار را به‌صورت افقی در مرکز ستون تراز می‌کند:

مثال زیر نوشتار را به‌صورت افقی در ستونی در سمت راست تراز می‌کند:

تعریف تراز عمودی ستون

می‌توانید ابزاره‌ها را با تعریف کردن فیلد verticalAlignment به‌صورت عمودی در بالا، پایین، یا مرکز ستون تراز کنید. اگر فیلد verticalAlignment تعریف نشده باشد، ابزاره‌های موجود در ستون در بالا تراز می‌شوند.

مثال زیر نوشتار را در ستون به‌صورت عمودی از بالا تراز می‌کند:

مثال زیر نوشتار را به‌صورت عمودی در مرکز ستون تراز می‌کند:

مثال زیر نوشتار را به‌صورت عمودی در ستونی در پایین تراز می‌کند:

افزودن جدولی برای نمایش مجموعه‌ای از موارد

ابزارک grid جدولی را با مجموعه‌ای از موارد نمایش می‌دهد. شبکه از هر تعداد ستون و مورد پشتیبانی می‌کند. تعداد ردیف‌ها با تقسیم کردن موارد بر ستون‌ها تعیین می‌شود. جدولی با ۱۰ مورد و ۲ ستون دارای ۵ ردیف است. جدولی با ۱۱ مورد و ۲ ستون دارای ۶ ردیف است.

این ابزاره از پیشنهادها پشتیبانی می‌کند که به کاربران کمک می‌کند داده‌های یکنواخت وارد کنند، و کنش‌های هنگام تغییر که Actions هستند و وقتی تغییری در فیلد ورودی نوشتار رخ می‌دهد، مثلاً وقتی کاربر نوشتاری را اضافه یا حذف می‌کند، اجرا می‌شوند.

مثال زیر یک شبکه ۲ ستونی با یک مورد است:

برای تعیین محل نمایش نوشتار با تصویر در شبکه، می‌توانید gridItemLayout فیلد را مشخص کنید. این فیلد به شما امکان می‌دهد مشخص کنید نوشتار در بالا یا پایین مورد در شبکه ظاهر شود. اگر gridItemLayout تعریف نشده باشد، نوشتار به‌طور پیش‌فرض زیر مورد در جدول ظاهر می‌شود.

مثال زیر یک شبکه سه ستونی با نوشتار و تصویر در هر شبکه است. شبکه اول نوشتاری را تعریف می‌کند که بالای تصویر نشان داده می‌شود، شبکه دوم نوشتاری را تعریف می‌کند که زیر تصویر نشان داده می‌شود، و شبکه سوم موقعیت نوشتار را تعریف نمی‌کند.

افزودن حاشیه به شبکه یا ستون

برای مواردی که در ابزارک column یا grid نشان داده می‌شوند، می‌توانید با تعریف کردن فیلد borderType و فیلد borderStyle به این عناصر میانای کاربر حاشیه اضافه کنید. اگر فیلد borderStyle تعریف نشده باشد، به‌طور پیش‌فرض هیچ حاشیه‌ای نشان داده نمی‌شود. می‌توانید borderType را برای اعمال به همه موارد درون ابزاره تعریف کنید یا سبک را به هر مورد درون ابزاره به‌صورت جداگانه اعمال کنید.

مثال زیر یک شبکه ۲ ستونی با یک تصویر در هر شبکه است که در آن نوع، سبک، و رنگ حاشیه برای اعمال روی همه موارد داخل شبکه تعریف شده است.

مثال زیر یک شبکه ۳ ستونی با یک تصویر در هر شبکه است و سبک و نوع حاشیه به‌صورت جداگانه تعریف شده است. حاشیه تصویر اول به‌صورت STROKE تعریف شده است. تصویر دوم دارای حاشیه‌ای است که به‌صورت NO_BORDER تعریف شده است. تصویر سوم حاشیه تعریف‌شده‌ای ندارد.

افزودن گردونه

ابزاره Carousel مجموعه‌ای از اشیاء CarouselCard را نشان می‌دهد که می‌توان آن‌ها را در صفحه پیمایش کرد. می‌توانید چند ابزاره به هر CarouselCard اضافه کنید.

ابزاره CardFixedFooter نشان‌دهنده پانویس پیام کادر گفتگویی است که برنامه Chat ارسال کرده است. پانویس‌ها می‌توانند شامل دکمه اصلی و دکمه فرعی باشند.

ابزاره CardFixedFooter فقط برای کادرهای گفتگو دردسترس است.

در زیر نمونه‌ای از ابزاره CardFixedFooter با دو دکمه آورده شده است:

عیب‌یابی

وقتی برنامه Google Chat یا کارت خطایی را برمی‌گرداند، میانای Chat پیامی با این مضمون نشان می‌دهد: «مشکلی پیش آمد.» یا «نمی‌توانیم درخواستتان را پردازش کنیم.» گاهی اوقات میانای کاربری Chat هیچ پیام خطایی نمایش نمی‌دهد، اما برنامه Chat یا کارت نتیجه غیرمنتظره‌ای تولید می‌کند؛ برای مثال، ممکن است پیام کارت ظاهر نشود.

اگرچه ممکن است پیام خطا در میانای کاربر Chat نمایش داده نشود، پیام‌های خطای توصیفی و داده‌های گزارش برای کمک به شما در رفع خطاها هنگامی که ثبت خطا برای برنامه‌های Chat روشن است، دردسترس هستند. برای دریافت راهنمایی درباره مشاهده، اشکال‌زدایی، و رفع خطاها، به عیب‌یابی و رفع خطاهای Google Chat مراجعه کنید.