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设置网址窗口或标签页关闭时网址操作的行为。
setOpenAs(openAs)OpenLink设置网址打开时的行为。
setUrl(url)OpenLink设置要打开的网址。

详细文档

setOnClose(onClose)

设置网址窗口或标签页关闭时网址操作的行为。

参数

名称类型说明
onCloseOnClose结束此设置。

返程

OpenLink - 此对象,用于串联。


setOpenAs(openAs)

设置网址打开时的行为。

参数

名称类型说明
openAsOpenAs正在打开设置。

返程

OpenLink - 此对象,用于串联。


setUrl(url)

设置要打开的网址。网址必须与清单中已列入白名单的前缀匹配。

参数

名称类型说明
urlString要打开的网址。

返程

OpenLink - 此对象,用于串联。