Class OpenLink

OpenLink

يمثل إجراءً لفتح رابط يحتوي على بعض الخيارات.

// A button that opens as a link in an overlay and
// requires a reload when closed.
var button = CardService.newTextButton()
    .setText("This button opens a link in an overlay window")
    .setOpenLink(CardService.newOpenLink()
        .setUrl("https://www.google.com")
        .setOpenAs(CardService.OpenAs.OVERLAY)
        .setOnClose(CardService.OnClose.RELOAD_ADD_ON));

// An action response that opens a link in full screen and
// requires no action when closed.
var actionResponse = CardService.newActionResponseBuilder()
    .setOpenLink(CardService.newOpenLink()
        .setUrl("https://www.google.com")
        .setOpenAs(CardService.OpenAs.FULL_SIZE)
        .setOnClose(CardService.OnClose.NOTHING))
    .build();

ملاحظة: لإعادة تحميل الإضافات بعد إغلاق رابط، لا تستخدِم رابطًا تم تفعيل رأس السياسة المشتركة المصدر له (COOP). إذا تم تفعيل سياسة COOP في رابط، لن تتمكّن الإضافات من رصد حالة النافذة، ولن يتم تعديل بطاقة الإضافة.

الطُرق

الطريقةنوع الإرجاعوصف قصير
setOnClose(onClose)OpenLinkيحدّد سلوك إجراء عنوان URL عند إغلاق نافذة عنوان URL أو علامة التبويب.
setOpenAs(openAs)OpenLinkلضبط سلوك عنوان URL عند فتحه.
setUrl(url)OpenLinkضبط عنوان URL لفتحه

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

setOnClose(onClose)

يحدّد سلوك إجراء عنوان URL عند إغلاق نافذة عنوان URL أو علامة التبويب.

المَعلمات

الاسمالنوعالوصف
onCloseOnCloseالإعداد الختامي.

رحلة العودة

OpenLink: هذا الكائن للسلسلة.


setOpenAs(openAs)

لضبط سلوك عنوان URL عند فتحه.

المَعلمات

الاسمالنوعالوصف
openAsOpenAsالإعداد الافتتاحي.

رحلة العودة

OpenLink: هذا الكائن للسلسلة.


setUrl(url)

ضبط عنوان URL لفتحه ويجب أن يتطابق عنوان URL مع بادئة القائمة البيضاء في البيان.

المَعلمات

الاسمالنوعالوصف
urlStringعنوان URL المطلوب فتحه.

رحلة العودة

OpenLink: هذا الكائن للسلسلة.