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) Cross-Origin-Opener-Policy (COOP). إذا تم تفعيل COOP في رابط، لن تتمكّن الإضافات من رصد حالة النافذة، ولا يتم تعديل بطاقة الإضافة.

الطُرق

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

الوثائق التفصيلية

setOnClose(onClose)

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

المَعلمات

الاسمTypeالوصف
onCloseOnCloseإعداد الإغلاق.

استرجاع الكرة

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


setOpenAs(openAs)

تحدِّد هذه السياسة سلوك عنوان URL عند فتحه.

المَعلمات

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

استرجاع الكرة

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


setUrl(url)

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

المَعلمات

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

استرجاع الكرة

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