Open Link 打开链接跳页

功能说明

Open Link 是点击交互行为。在 Destination 中选择 Internal page、External URL、System menu 或 Run script；运行时点击组件后，按所选目标执行。

字段配置

绑定 Open Link，选择 Destination 并填写对应字段：

• Internal page：在 Page address 填导出页面文件名，例如 Main.html，或点击 Select PPT page... 选择当前演示文稿中的页面。相对地址从当前导出页解析，并须留在资源根目录内。
• External URL：需要打开完整外部或内网网址时，切换到此选项，再按该模式的字段填写地址。
• System menu：需要打开宿主机菜单时，切换到此选项，并核对宿主机中的菜单目标。
• Run script：目标需要按运行状态计算，或点击后要执行组合动作时使用。
• Open options：选择 HMI window 或 Page only，并按需要设置 Fullscreen、New tab。
• Parameters (optional)：需要向目标页传值时添加 Key / Value；不需要传值时可留空。

// Run script：按状态决定目标
if (ReadTagBoolean("PLC_LINE01.PUMP01.FAULT", false)) {
  hqVisuDesigner.openPage("alarm_overview");
} else {
  hqVisuDesigner.openPage("production_overview");
}

Parameters：发送、类型和目标页读取

Internal page 的 Parameters (optional) 提供 Key / Value 行，用于向目标页传值。脚本调用 openPage 时可传字符串、数字、布尔值或 null；目标页按字符串读取。重复 Key 会按原始顺序保留。

• 发送端界面：选择 Internal page 后，逐行添加 Key / Value。
• 发送端脚本：hqVisuDesigner.openPage(pageCode, { frameTarget, parameters })；parameters 必须是数组，不能写成普通对象。
• 读取第一个同名值：GetPageParameter("PLC", "")。
• 读取全部同名值：GetPageParameterValues("Area")。
• 按原始顺序读取全部参数：GetPageParameters()。
• 同样可使用 hqVisuDesigner.getPageParameter / getPageParameterValues / getPageParameters。

// 源页面：同包跳转并传参
hqVisuDesigner.openPage("device_details", {
  frameTarget: "frame",
  parameters: [
    { key: "PLC", value: "PLC_LINE01" },
    { key: "Device", value: "PUMP_01" },
    { key: "Area", value: "AREA01" },
    { key: "Area", value: "AREA02" }
  ]
});

// 目标页面 Page Script
var plc = GetPageParameter("PLC", "");
var device = GetPageParameter("Device", "");
var areas = GetPageParameterValues("Area");

适用场景

用于点击后切页或打开内容，例如：

• 在总览页放“水泵详情”按钮，使用 Internal page 选择本 PPT 导出的 Pump 页面。
• 需要打开宿主机菜单时，选择 System menu 并核对目标菜单。
• 打开帮助、工单或报表系统时，选择 External URL 并填写可访问的地址。
• 打开同包的静态帮助页时，在 Internal page 填对应的导出页地址。
• 需要按状态计算目标时，使用 Run script 编写跳转逻辑。

限制与常见问题

Internal page 的相对地址必须位于当前画面包的资源目录内。打开其他画面包时使用画面编码，打开系统菜单时选择 System menu；请勿用 ../../other-screen/index.html 这类相对路径跨包跳转。