تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class DecoratedText

تطبيق مصغّر يعرض نصًا مع زخارف اختيارية تشمل المفاتيح المحتملة رمزًا وتصنيفًا أعلى وتصنيفًا أسفل. يجب ضبط المحتوى النصي وأحد المفاتيح باستخدام setText(text) وأحد الخيارات DecoratedText أو DecoratedText أو setTopLabel(text) أو setBottomLabel(text). تم تصميم هذه الفئة لاستبدال KeyValue.

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

const decoratedText =
    CardService.newDecoratedText().setText('Text').setTopLabel('TopLabel');

const multilineDecoratedText = CardService.newDecoratedText()
                                   .setText('Text')
                                   .setTopLabel('TopLabel')
                                   .setWrapText(true)
                                   .setBottomLabel('BottomLabel');

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`setAuthorizationAction(action)`	`DecoratedText`	تُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر.
`setBottomLabel(text)`	`DecoratedText`	تضبط هذه السياسة نص التصنيف ليتم استخدامه كمفتاح ويتم عرضه أسفل محتوى النص.
`setButton(button)`	`DecoratedText`	لضبط `Button` الذي يظهر على يسار النص.
`setComposeAction(action, composedEmailType)`	`DecoratedText`	تُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر.
`setEndIcon(endIcon)`	`DecoratedText`	تضبط هذه السياسة قيمة `IconImage` الاختيارية التي يتم عرضها إلى يسار المحتوى.
`setOnClickAction(action)`	`DecoratedText`	تُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر.
`setOnClickOpenLinkAction(action)`	`DecoratedText`	تضبط هذه السياسة إجراءً يؤدي إلى فتح عنوان URL في علامة تبويب عند النقر على العنصر.
`setOpenLink(openLink)`	`DecoratedText`	تُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر.
`setStartIcon(startIcon)`	`DecoratedText`	تضبط هذه السياسة سمة `IconImage` الاختيارية لعرضها قبل محتوى النص.
`setSwitchControl(switchToSet)`	`DecoratedText`	لضبط `Switch` الذي يظهر على يسار المحتوى
`setText(text)`	`DecoratedText`	لضبط النص الذي سيتم استخدامه كقيمة
`setTopLabel(text)`	`DecoratedText`	لضبط نص التصنيف الذي سيتم استخدامه كمفتاح ويتم عرضه أعلى محتوى النص.
`setWrapText(wrapText)`	`DecoratedText`	لضبط ما إذا كان يجب عرض نص القيمة في سطر واحد أو عدة أسطر.

مستندات تفصيلية

`setAuthorizationAction(action)`

تُستخدَم لضبط إجراء تفويض يفتح عنوان URL يؤدي إلى مسار التفويض عند النقر على العنصر. يؤدي ذلك إلى فتح عنوان URL في نافذة جديدة. عندما ينتهي المستخدم من مسار التفويض ويعود إلى التطبيق، تتم إعادة تحميل الإضافة.

يمكن أن يحتوي كائن واجهة المستخدم على مجموعة واحدة فقط من setOpenLink(openLink) أو setOnClickAction(action) أو setOnClickOpenLinkAction(action) أو setAuthorizationAction(action) أو setComposeAction(action, composedEmailType).

// ...

const action = CardService.newAuthorizationAction().setAuthorizationUrl('url');
CardService.newTextButton().setText('Authorize').setAuthorizationAction(action);

المعلمات

الاسم	النوع	الوصف
`action`	`AuthorizationAction`	العنصر الذي يحدّد إجراء التفويض الذي يجب اتّخاذه عند النقر على هذا العنصر

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.

`setBottomLabel(text)`

لضبط نص التصنيف لاستخدامه كمفتاح، ويتم عرضه أسفل محتوى النص.

المعلمات

الاسم	النوع	الوصف
`text`	`String`	نص التصنيف.

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.

`setButton(button)`

لضبط Button الذي يظهر على يسار النص. يمكن أن يضمّ جهاز DecoratedText زرًا واحدًا أو مفتاحًا واحدًا فقط.

المعلمات

الاسم	النوع	الوصف
`button`	`Button`	زر الإضافة

الإرجاع

DecoratedText — هذا الكائن يمكن استخدامه في التسلسل.

`setComposeAction(action, composedEmailType)`

تُستخدَم لضبط إجراء ينشئ مسودة رسالة إلكترونية عند النقر على العنصر. يمكن لكائن واجهة المستخدم أن يحتوي فقط على مجموعة واحدة من setOpenLink(openLink) أو setOnClickAction(action) أو setOnClickOpenLinkAction(action) أو setAuthorizationAction(action) أو setComposeAction(action, composedEmailType).

يجب أن تحدّد المَعلمة Action دالة ردّ اتصال تعرِض عنصر ComposeActionResponse تمّ إعداده باستخدام ComposeActionResponseBuilder.setGmailDraft(draft).

ملاحظة: لا تضبط هذه الطريقة إجراء إنشاء يتم استخدامه لتوسيع واجهة مستخدم إنشاء الرسائل. بدلاً من ذلك، تربط هذه الطريقة عنصر واجهة المستخدم هذا بعنصر Action يُنشئ مسودات رسائل في Apps Script يتم فتحها في Gmail عند اكتمال الإجراء.

// ...

const action = CardService.newAction().setFunctionName('composeEmailCallback');
CardService.newTextButton()
    .setText('Compose Email')
    .setComposeAction(action, CardService.ComposedEmailType.REPLY_AS_DRAFT);

// ...

function composeEmailCallback() {
  const thread = GmailApp.getThreadById(e.threadId);
  const draft = thread.createDraftReply('This is a reply');
  return CardService.newComposeActionResponseBuilder()
      .setGmailDraft(draft)
      .build();
}

المعلمات

الاسم	النوع	الوصف
`action`	`Action`	العنصر الذي يحدّد إجراء الإنشاء الذي يجب اتّخاذه عند النقر على هذا العنصر
`composedEmailType`	`ComposedEmailType`	قيمة مصنّفة تحدد ما إذا كانت المسودة التي تم إنشاؤها هي مسودة مستقلة أو مسودة ردّ.

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.

`setEndIcon(endIcon)`

لضبط الرمز IconImage الاختياري الذي يظهر على يسار المحتوى لا يمكن أن يتضمّن DecoratedText سوى زر واحد أو مفتاح واحد أو رمز واحد.

المعلمات

الاسم	النوع	الوصف
`endIcon`	`IconImage`	الرمز المطلوب إضافته

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.

`setOnClickAction(action)`

تُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى أحد الإعدادات التالية: setOpenLink(openLink) أو setOnClickAction(action) أو setOnClickOpenLinkAction(action) أو setAuthorizationAction(action) أو setComposeAction(action, composedEmailType).

يجب أن تحدّد المَعلمة Action دالة ردّ اتصال تعرِض عنصر ActionResponse.

// ...

const action = CardService.newAction().setFunctionName('notificationCallback');
CardService.newTextButton()
    .setText('Create notification')
    .setOnClickAction(action);

// ...

function notificationCallback() {
  return CardService.newActionResponseBuilder()
      .setNotification(
          CardService.newNotification().setText('Some info to display to user'),
          )
      .build();
}

المعلمات

الاسم	النوع	الوصف
`action`	`Action`	الإجراء الذي يتم اتّخاذه عند النقر على هذا العنصر.

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.

`setOnClickOpenLinkAction(action)`

تُستخدَم لضبط إجراء يفتح عنوان URL في علامة تبويب عند النقر على العنصر. استخدِم هذه الدالة عندما تحتاج إلى إنشاء عنوان URL أو عندما تحتاج إلى اتّخاذ إجراءات أخرى بالإضافة إلى إنشاء عنصر OpenLink. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى أحد القيم التالية: setOpenLink(openLink) أو setOnClickAction(action) أو setOnClickOpenLinkAction(action) أو setAuthorizationAction(action) أو setComposeAction(action, composedEmailType).

يجب أن تحدّد المَعلمة Action دالة ردّ اتصال تعرِض عنصر ActionResponse تمّ إعداده باستخدام ActionResponseBuilder.setOpenLink(openLink).

// ...

const action = CardService.newAction().setFunctionName('openLinkCallback');
CardService.newTextButton()
    .setText('Open Link')
    .setOnClickOpenLinkAction(action);

// ...

function openLinkCallback() {
  return CardService.newActionResponseBuilder()
      .setOpenLink(CardService.newOpenLink().setUrl('https://www.google.com'))
      .build();
}

المعلمات

الاسم	النوع	الوصف
`action`	`Action`	العنصر الذي يحدّد إجراء فتح الرابط الذي يجب اتّخاذه عند النقر على هذا العنصر

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.

`setOpenLink(openLink)`

تُستخدَم لضبط عنوان URL ليتم فتحه عند النقر على العنصر. استخدِم هذه الدالة عندما يكون عنوان URL معروفًا ويحتاج فقط إلى فتحه. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى إحدى القيم التالية: setOpenLink(openLink) أو setOnClickAction(action) أو setOnClickOpenLinkAction(action) أو setAuthorizationAction(action) أو setComposeAction(action, composedEmailType).

المعلمات

الاسم	النوع	الوصف
`openLink`	`OpenLink`	عنصر `OpenLink` يصف عنوان URL المطلوب فتحه

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.

`setStartIcon(startIcon)`

لضبط الرمز IconImage الاختياري لعرضه قبل محتوى النص

المعلمات

الاسم	النوع	الوصف
`startIcon`	`IconImage`	الرمز المطلوب عرضه

الإرجاع

DecoratedText — هذا الكائن يمكن استخدامه في التسلسل.

`setSwitchControl(switchToSet)`

لضبط Switch المعروضة إلى يسار المحتوى. ولا يتوافق DecoratedText إلا مع زر واحد أو مفتاح تحكّم واحد.

المعلمات

الاسم	النوع	الوصف
`switchToSet`	`Switch`	مفتاح التبديل للإضافة

الإرجاع

DecoratedText — هذا الكائن يمكن استخدامه في التسلسل.

`setText(text)`

لضبط النص الذي سيتم استخدامه كقيمة أن تكون متوافقة مع تنسيق HTML الأساسي مطلوب.

المعلمات

الاسم	النوع	الوصف
`text`	`String`	محتوى النص لهذه الأداة.

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.

`setTopLabel(text)`

لضبط نص التصنيف الذي سيتم استخدامه كمفتاح ويتم عرضه أعلى محتوى النص.

المعلمات

الاسم	النوع	الوصف
`text`	`String`	نص التصنيف.

الإرجاع

DecoratedText — هذا الكائن يمكن استخدامه في التسلسل.

`setWrapText(wrapText)`

لضبط ما إذا كان يجب عرض نص القيمة في سطر واحد أو عدة أسطر.

المعلمات

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

الإرجاع

DecoratedText: هذا العنصر، لإنشاء سلسلة.