تصميم مكونات البطاقة أو مربع الحوار

توضّح هذه الصفحة طريقة تصميم وإنشاء واجهة المستخدم الأساسية الخاصة برسائل البطاقات في Google Chat.

تتوافق البطاقات مع تنسيق محدد وعناصر تفاعلية في واجهة المستخدم، مثل الأزرار، ووسائط متعددة تفاعلية مثل الصور. يمكنك استخدام البطاقات لتقديم المعلومات أو جمع الإدخالات أو تقديم الخطوات التالية للمستخدمين من خلال رسائل البطاقات ومربعات الحوار.

يمكنك استخدام "أداة إنشاء البطاقات" لتصميم رسائل بطاقات JSON ومعاينتها لتطبيقات Chat:

فتح "أداة إنشاء البطاقات"

تحتوي البطاقات ومربّعات الحوار بشكل عام على العناصر التالية:

  • CardHeader الذي يتضمّن عنوان بطاقتك
  • تطبيق واحد أو أكثر من تطبيقات "CardSection" المصغّرة التي تشكِّل النص الأساسي للبطاقة
  • أداة CardFixedFooter مخصصة لمربعات الحوار فقط.

المتطلّبات الأساسية

  • حساب Google Workspace لديه إمكانية الوصول إلى Google Chat.
  • تم نشر تطبيق Chat. لإنشاء تطبيق Chat، اتّبِع خطوات quickstart هذه.

    • إضافة عنوان

    يمثّل تطبيق CardHeader المصغّر عنوان البطاقة. يمكن أن تتضمن العناوين عنوانًا وعنوانًا فرعيًا وصورة رمزية لبطاقتك.

    يمكنك تضمين CardHeader في رسائل البطاقات ومربعات الحوار.

    إليك مثال على السمة CardHeader:

    تحديد قسم في البطاقة

    أداة CardSection هي حاوية عالية المستوى داخل بطاقة. يمكنك استخدام أقسام البطاقات لتجميع الأدوات داخل البطاقة. يمكنك تضمين عنوان وأداة واحدة أو أكثر لكل قسم في البطاقة

    يمكنك تضمين CardSection في رسائل البطاقات ومربعات الحوار.

    في ما يلي مثال على CardSection التي تتضمّن أداتَين textParagraph:

    وتمثل الأداة CardFixedFooter تذييل رسالة مربّع حوار المُرسَلة من خلال تطبيق في Chat. ويمكن أن تتضمّن التذييلات زرًا أساسيًا وزرًا ثانويًا.

    لا يتوفّر التطبيق المصغّر CardFixedFooter إلا لمربّعات الحوار.

    في ما يلي مثال على أداة CardFixedFooter تتضمّن زرَّين:

    تحديد المشاكل وحلّها

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

    على الرغم من أنّ رسالة الخطأ قد لا تظهر في واجهة مستخدم Chat، تتوفّر رسائل الخطأ الوصفية وبيانات السجلّ لمساعدتك في إصلاح الأخطاء عند تفعيل ميزة تسجيل الأخطاء في تطبيقات Chat. للحصول على مساعدة بشأن الاطّلاع على الأخطاء وتصحيحها وتصحيحها، راجِع تحديد المشاكل في Google Chat وحلّها.