يمثل إجراءً لفتح رابط يحتوي على بعض الخيارات.
// 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)
setOpenAs(openAs)
setUrl(url)
ضبط عنوان URL لفتحه ويجب أن يتطابق عنوان URL مع بادئة القائمة البيضاء في البيان.
المَعلمات
الاسم | النوع | الوصف |
---|---|---|
url | String | عنوان URL المطلوب فتحه. |
رحلة العودة
OpenLink
: هذا الكائن للسلسلة.