Class TextButton

تُستخدَم لضبط النص البديل للزر من أجل تسهيل الاستخدام. في حال عدم ضبطه، يتم ضبطه تلقائيًا على النص الذي يظهر على الزر.

المعلمات

الإرجاع

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

تضبط هذه السياسة إجراء تفويض يفتح عنوان 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);

المعلمات

الإرجاع

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

لضبط لون خلفية الزر TextButtonStyle.FILLED. في حال ترك الزر بدون ضبط للزر TextButtonStyle.FILLED، سيستخدم الزر اللون الثانوي المحدّد في manifest الإضافة. لا يمكن استخدام هذه الطريقة مع أزرار TextButtonStyle.OUTLINED.

المعلمات

الإرجاع

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

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

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

// ...

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();
}

المعلمات

الإرجاع

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

يحدد ما إذا كان الزر غير مفعَّل. يكون الزر غير مفعّل باللون الرمادي ولا يمكن النقر عليه.

المعلمات

الإرجاع

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

لضبط رمز Icon محدّد مسبقًا لعرضه على الزر يجب استخدام هذا الرمز أو setIconUrl(url) لتحديد صورة الزر.

المعلمات

الإرجاع

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

لضبط عنوان URL للصورة لاستخدامها كرمز لهذا الزر. يجب استخدام هذا الرمز أو setIcon(icon) لتحديد صورة الزر.

المعلمات

الإرجاع

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

تُستخدَم لضبط رمز التصميم المتعدّد الأبعاد.

const textButton = CardService.newTextButton().setMaterialIcon(
    CardService.newMaterialIcon().setName('search'),
);

المعلمات

الإرجاع

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

تُستخدَم لضبط إجراء يتم تنفيذه عند النقر على العنصر. لا يمكن أن يتضمّن عنصر واجهة المستخدم سوى أحد الإعدادات التالية: 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();
}

المعلمات

الإرجاع

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

تضبط هذه السياسة إجراءً يؤدي إلى فتح عنوان 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();
}

المعلمات

الإرجاع

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

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

المعلمات

الإرجاع

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

لضبط قائمة منبثقة يتم فتحها عند النقر على العنصر. يمكن لكل عنصر في القائمة تحديد إجراء يتم تفعيله عند النقر عليه. لا تتوفّر القوائم المُدمَجة، ويجب ألّا تحدّد إجراءات عناصر القائمة قائمة كاملة.

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

const overflowMenuItem =
    CardService.newOverflowMenuItem()
        .setStartIcon(
            CardService.newIconImage().setIconUrl(
                'https://www.google.com/images/branding/googleg/1x/googleg_standard_color_64dp.png',
                ),
            )
        .setText('Open Link')
        .setOpenLink(
            CardService.newOpenLink().setUrl('https://www.google.com'));

const overflowMenu =
    CardService.newOverflowMenu().addMenuItem(overflowMenuItem).build();

المعلمات

الإرجاع

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

لضبط النص الذي يظهر على الزر

المعلمات

الإرجاع

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

لضبط نمط الزر وفي حال عدم ضبطه، يتم ضبطه تلقائيًا على الزر TextButtonStyle.OUTLINED.

const button =
    CardService.newTextButton()
        .setText('Filled')
        .setTextButtonStyle(CardService.TextButtonStyle.FILLED)
        .setOpenLink(CardService.newOpenLink().setUrl('www.google.com'));

المعلمات

الإرجاع

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