نص مزخرف

تعرض تطبيق "DecoratedText" المصغّر النص مع ميزات تصميم ووظائف اختيارية. مثال:

  • عرض icon أمام النص باستخدام startIcon
  • إظهار العنوان قبل النص باستخدام topLabel
  • يمكنك إضافة زرّ قابل للنقر باستخدام button أو النقر على زر الإيقاف/التفعيل القابل للتبديل باستخدام switchControl.


يمكنك تصميم البطاقات ومعاينتها باستخدام أداة إنشاء البطاقات.

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

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

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

تنسيق النص في تطبيق DecoratedText المصغّر

تتوافق أداة DecoratedText مع تنسيق HTML النصي البسيط. عند تعيين المحتوى النصي لهذه التطبيقات المصغّرة، ما عليك سوى تضمين علامات HTML المقابلة. للمزيد من المعلومات حول علامات HTML المتوافقة، يُرجى الاطّلاع على تنسيق نص البطاقة.

تمثيل JSON وحقوله

تمثيل JSON
{
  "icon": {
    object (Icon)
  },
  "startIcon": {
    object (Icon)
  },
  "topLabel": string,
  "text": string,
  "wrapText": boolean,
  "bottomLabel": string,
  "onClick": {
    object (OnClick)
  },

  // Union field control can be only one of the following:
  "button": {
    object (Button)
  },
  "switchControl": {
    object (SwitchControl)
  },
  "endIcon": {
    object (Icon)
  }
  // End of list of possible types for union field control.
}
الحقول
icon
(deprecated)

object (Icon)

تم إيقافها لصالح startIcon.

startIcon

object (Icon)

الرمز المعروض أمام النص

topLabel

string

النص الذي يظهر أعلى text. يتم اقتطاع دائمًا

text

string

مطلوبة. تمثّل هذه السمة النص الأساسي.

دعم التنسيق البسيط. لمزيد من المعلومات حول تنسيق النص، يُرجى الاطّلاع على القسم تنسيق النص في تطبيقات Google Chat وتنسيق النص في إضافات Google Workspace.

wrapText

boolean

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

ينطبق هذا الإعداد فقط على text، وليس على topLabel وbottomLabel.

bottomLabel

string

النص الذي يظهر أسفل text. التفاف النص دائمًا.

onClick

object (OnClick)

يتم تشغيل هذا الإجراء عندما ينقر المستخدمون على topLabel أو bottomLabel.

حقل الاتحاد control. زر أو مفتاح أو مربّع اختيار أو صورة تظهر على الجانب الأيسر من النص في تطبيق decoratedText المصغّر. يمكن أن تكون السمة control واحدًا فقط مما يلي:
button

object (Button)

زر يمكن للمستخدم النقر عليه لتشغيل إجراء ما.

switchControl

object (SwitchControl)

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

endIcon

object (Icon)

رمز يظهر بعد النص

وتتيح استخدام رموز مدمجة ومخصّصة.

الرمز

رمز معروض في تطبيق مصغّر على بطاقة للحصول على مثال في تطبيقات Google Chat، راجِع القسم الرمز.

وتتيح استخدام رموز مدمجة ومخصّصة.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{
  "altText": string,
  "imageType": enum (ImageType),

  // Union field icons can be only one of the following:
  "knownIcon": string,
  "iconUrl": string
  // End of list of possible types for union field icons.
}
الحقول
altText

string

اختياريّ. تمثّل هذه السمة وصف الرمز المستخدَم لتسهيل الاستخدام. وفي حال عدم تحديدها، يتم توفير القيمة التلقائية Button. كأفضل ممارسة، يجب عليك تعيين وصف مفيد لما يعرضه الأيقونة، وما تفعله إن أمكن. على سبيل المثال، A user's account portrait أو Opens a new browser tab and navigates to the Google Chat developer documentation at https://developers.google.com/chat.

وفي حال ضبط الرمز في Button، سيظهر altText كنص مساعد عندما يمرِّر المستخدم مؤشّر الماوس فوق الزر. في المقابل، في حال ضبط الزر أيضًا text، يتم تجاهل altText للرمز.

imageType

enum (ImageType)

نمط الاقتصاص المطبّق على الصورة في بعض الحالات، يؤدي تطبيق اقتصاص CIRCLE إلى رسم الصورة بحجم أكبر من الرمز المضمَّن.

حقل الاتحاد icons. الرمز المعروض في التطبيق المصغّر على البطاقة يمكن أن تكون السمة icons واحدًا فقط مما يلي:
knownIcon

string

عرض أحد الرموز المضمّنة التي توفّرها Google Workspace

على سبيل المثال، لعرض رمز الطائرة، حدِّد AIRPLANE. بالنسبة إلى الحافلة، حدِّد BUS.

للحصول على قائمة كاملة بالرموز المتوافقة، يمكنك الاطّلاع على الرموز المضمَّنة.

iconUrl

string

عرض رمز مخصّص مستضاف على عنوان URL يستخدم HTTPS

مثال:

"iconUrl":
"https://developers.google.com/chat/images/quickstart-app-avatar.png"

وتتضمّن أنواع الملفات المسموح بها .png و.jpg.

ImageType

الشكل المستخدم لاقتصاص الصورة.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

عمليات التعداد
SQUARE القيمة التلقائية. يتم تطبيق قناع مربّع على الصورة. على سبيل المثال، تصبح صورة بتنسيق 4×3 3×3.
CIRCLE يتم تطبيق قناع دائري على الصورة. على سبيل المثال، تصبح صورة بحجم 4×3 دائرة بقطر 3.

OnClick

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

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{

  // Union field data can be only one of the following:
  "action": {
    object (Action)
  },
  "openLink": {
    object (OpenLink)
  },
  "openDynamicLinkAction": {
    object (Action)
  },
  "card": {
    object (Card)
  }
  // End of list of possible types for union field data.
}
الحقول

حقل الاتحاد data.

يمكن أن تكون السمة data واحدًا فقط مما يلي:

action

object (Action)

وفي حال تحديدها، سيتم تنفيذ إجراء بواسطة onClick.

card

object (Card)

يتم دفع بطاقة جديدة إلى حزمة البطاقات بعد النقر عليها إذا تم تحديدها.

متاحة لإضافات Google Workspace ولا تتوفّر لتطبيقات Google Chat.

الإجراء

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

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{
  "function": string,
  "parameters": [
    {
      object (ActionParameter)
    }
  ],
  "loadIndicator": enum (LoadIndicator),
  "persistValues": boolean,
  "interaction": enum (Interaction)
}
الحقول
function

string

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

على سبيل المثال، الاستخدام، راجِع إنشاء بطاقات تفاعلية.

parameters[]

object (ActionParameter)

قائمة مَعلمات الإجراءات

loadIndicator

enum (LoadIndicator)

تحدّد هذه العلامة مؤشر التحميل الذي يعرضه الإجراء أثناء تنفيذ الإجراء.

persistValues

boolean

يشير إلى ما إذا كانت قيم النموذج تستمر بعد الإجراء. القيمة التلقائية هي false.

في حال true، تظل قيم النموذج بعد تفعيل الإجراء. للسماح للمستخدم بإجراء تغييرات أثناء معالجة الإجراء، اضبط السمة LoadIndicator على NONE. بالنسبة إلى رسائل البطاقة في تطبيقات Chat، عليك أيضًا ضبط ResponseType للإجراء على UPDATE_MESSAGE واستخدام cardId نفسه من البطاقة التي تضمّن الإجراء.

في حال false، سيتم محو قيم النموذج عند تفعيل الإجراء. لمنع المستخدم من إجراء تغييرات أثناء معالجة الإجراء، اضبط السمة LoadIndicator على السمة SPINNER.

interaction

enum (Interaction)

اختياريّ. مطلوبة عند فتح مربع حوار.

الإجراءات التي يجب اتّخاذها استجابةً لتفاعل مع أحد المستخدِمين، مثلاً عندما ينقر المستخدِم على زرّ في رسالة بطاقة

وفي حال عدم تحديد ذلك، يستجيب التطبيق من خلال تنفيذ action، مثل فتح رابط أو تشغيل وظيفة، كالعادة.

من خلال تحديد interaction، يمكن للتطبيق أن يستجيب بطرق تفاعلية خاصة. على سبيل المثال، من خلال ضبط interaction على OPEN_DIALOG، يمكن للتطبيق فتح مربع حوار. عند تحديدها، لا يتم عرض مؤشر تحميل. إذا تم تحديد إحدى الإضافات، تتم إزالة البطاقة بالكامل ولن يتم عرض أي شيء في البرنامج.

متاحة لتطبيقات Google Chat ولا تتوفّر في "إضافات Google Workspace".

زرّ

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

لجعل صورة زرّ قابلاً للنقر، حدِّد Image (وليس ImageComponent) واضبط إجراء onClick.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

تمثيل JSON
{
  "text": string,
  "icon": {
    object (Icon)
  },
  "color": {
    object (Color)
  },
  "onClick": {
    object (OnClick)
  },
  "disabled": boolean,
  "altText": string
}
الحقول
text

string

النص المعروض داخل الزر.

icon

object (Icon)

صورة الرمز إذا تم ضبط كل من icon وtext، سيظهر الرمز قبل النص.

color

object (Color)

في حال ضبط هذه السياسة، تتم تعبئة الزرّ بلون خلفية ثابت ويتغير لون الخط للحفاظ على التباين مع لون الخلفية. على سبيل المثال، يؤدي ضبط خلفية زرقاء على الأرجح إلى ظهور نص باللون الأبيض.

في حال ترك هذه السياسة بدون ضبط، تكون خلفية الصورة بيضاء ويكون لون الخط أزرق.

بالنسبة إلى اللون الأحمر والأخضر والأزرق، تكون قيمة كل حقل رقم float يمكنك التعبير عنه بأيٍّ من الطريقتين: كرقم بين 0 و255 مقسومًا على 255 (153/255) أو كقيمة بين 0 و1 (0.6). يمثل الرقم 0 غياب لون ويمثل الرقم 1 أو 255/255 التواجد الكامل لهذا اللون على مقياس RGB.

يمكنك اختياريًا ضبط alpha الذي يحدِّد مستوى من الشفافية باستخدام المعادلة التالية:

pixel color = alpha * (this color) + (1.0 - alpha) * (background color)

بالنسبة إلى alpha، تتوافق قيمة 1 مع لون خالص، في حين تتوافق القيمة 0 مع لون شفاف تمامًا.

على سبيل المثال، يمثل اللون التالي لونًا أحمر نصف شفاف:

"color": {
   "red": 1,
   "green": 0,
   "blue": 0,
   "alpha": 0.5
}
onClick

object (OnClick)

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

disabled

boolean

إذا true، يتم عرض الزر في حالة غير نشطة ولا يستجيب لإجراءات المستخدم.

altText

string

تمثّل هذه السمة النص البديل المستخدَم لتسهيل الاستخدام.

قم بتعيين نص وصفي يتيح للمستخدمين معرفة وظيفة الزر. على سبيل المثال، إذا كان أحد الأزرار يفتح رابطًا تشعّبيًا، يمكنك كتابة: "يتم فتح علامة تبويب جديدة في المتصفح والانتقال إلى مستندات مطوّري برامج Google Chat على https://developers.google.com/chat".

SwitchControl

إما مفتاح تبديل بنمط التبديل أو مربّع اختيار داخل تطبيق decoratedText المصغّر.

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

ولا تتوفّر هذه الميزة إلا في تطبيق decoratedText المصغّر.

تمثيل JSON
{
  "name": string,
  "value": string,
  "selected": boolean,
  "onChangeAction": {
    object (Action)
  },
  "controlType": enum (ControlType)
}
الحقول
name

string

الاسم الذي يتم من خلاله تحديد تطبيق مفتاح التبديل في حدث إدخال النموذج.

للحصول على تفاصيل عن استخدام إدخالات النموذج، يُرجى الاطّلاع على تلقّي بيانات النموذج.

value

string

القيمة التي أدخلها المستخدم، يتم عرضها كجزء من حدث إدخال نموذج

للحصول على تفاصيل عن استخدام إدخالات النموذج، يُرجى الاطّلاع على تلقّي بيانات النموذج.

selected

boolean

عند true، يتم اختيار مفتاح التبديل.

onChangeAction

object (Action)

الإجراء الذي يتم تنفيذه عند تغيير حالة التبديل، مثل الوظيفة المطلوب تشغيلها.

controlType

enum (ControlType)

كيفية ظهور مفتاح التبديل في واجهة المستخدم

متاحة لتطبيقات Google Chat وإضافات Google Workspace.

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

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

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