این صفحه نحوه طراحی و ایجاد اجزای اصلی رابط کاربری پیامهای کارت در Google Chat را شرح میدهد.
کارتها از طرحبندی تعریفشده، عناصر رابط کاربری تعاملی، مانند دکمهها، و رسانههای غنی مانند تصاویر پشتیبانی میکنند. میتوانید از کارتها برای ارائه اطلاعات، جمعآوری ورودی یا ارائه مراحل بعدی به کاربران از طریق پیامها و گفتگوهای کارت استفاده کنید.
از Card Builder برای طراحی و پیش نمایش پیام های کارت JSON برای برنامه های Chat استفاده کنید:
کارت ساز را باز کنیدکارت ها و دیالوگ ها به طور کلی دارای اجزای زیر هستند:
- یک
CardHeader
که حاوی عنوان کارت شما است. - یک یا چند ویجت
CardSection
که بدنه اصلی کارت را تشکیل می دهند. - ویجت
CardFixedFooter
که فقط برای دیالوگ ها اختصاص دارد.
پیش نیازها
یک هدر اضافه کنید
ویجت CardHeader
نشان دهنده هدر یک کارت است. هدرها می توانند شامل عنوان، زیرنویس و تصویر آواتار برای کارت شما باشند.
میتوانید CardHeader
برای پیامها و گفتگوهای کارت اضافه کنید.
نمونه زیر یک نمونه از CardHeader
است:
قسمتی از کارت را تعریف کنید
ویجت CardSection
یک ظرف سطح بالا در کارت است. شما از بخش های کارت برای گروه بندی ویجت ها در کارت استفاده می کنید. برای هر بخش کارت، می توانید یک هدر و یک یا چند ویجت اضافه کنید.
میتوانید CardSection
برای پیامها و گفتگوهای کارت اضافه کنید.
نمونه زیر نمونه ای از CardSection
است که شامل دو ویجت textParagraph
است:
یک پاورقی ماندگار اضافه کنید
ویجت CardFixedFooter
نشان دهنده پاورقی یک پیام محاوره ای است که توسط یک برنامه چت ارسال می شود. پاورقی ها می توانند شامل یک دکمه اصلی و یک دکمه ثانویه باشند.
ویجت CardFixedFooter
فقط برای گفتگوها در دسترس است.
نمونه زیر یک ویجت CardFixedFooter
با دو دکمه است:
عیب یابی
وقتی یک برنامه یا کارت Google Chat خطایی را برمیگرداند، رابط Chat پیامی را نشان میدهد که میگوید «مشکلی پیش آمده است». یا "نمی توان به درخواست شما رسیدگی کرد." گاهی اوقات Chat UI هیچ پیام خطایی را نمایش نمی دهد، اما برنامه یا کارت Chat نتیجه غیرمنتظره ای ایجاد می کند. برای مثال، ممکن است پیام کارت ظاهر نشود.
اگرچه ممکن است پیام خطا در رابط کاربری گپ نمایش داده نشود، پیامهای خطای توصیفی و دادههای گزارش در دسترس هستند تا به شما کمک کنند هنگام فعال بودن ثبت خطا برای برنامههای گپ، خطاها را برطرف کنید. برای راهنمایی برای مشاهده، اشکالزدایی و رفع خطاها، به عیبیابی و رفع خطاهای Google Chat مراجعه کنید.