页面设置与面包屑导航

Navigation 组里有两个入口:Page Layout 为当前 PowerPoint 中的全部幻灯片选择同一个宽高比;Page Breadcrumb 在一张表中维护每页稳定 Page Code 和宿主面包屑显示。建议先定画布比例,再排版页面;页面名称和跳转关系稳定后,再统一配置 Page Breadcrumb。

功能

功能: 页面设置与面包屑导航

用 Page Layout 为当前 PPT 的全部幻灯片选择统一画布比例,用 Page Breadcrumb 逐页维护 Page Code、面包屑层级、默认文案、语言键和页面背景。两者都位于功能区 Navigation 组。

功能说明

Navigation 组里有两个入口:Page Layout 为当前 PowerPoint 中的全部幻灯片选择同一个宽高比;Page Breadcrumb 在一张表中维护每页稳定 Page Code 和宿主面包屑显示。建议先定画布比例,再排版页面;页面名称和跳转关系稳定后,再统一配置 Page Breadcrumb。

Page Layout 操作步骤

点击 Navigation → Page Layout。在 Aspect ratio 下拉框中选择 16:9、16:10、4:3、3:2 或 21:9。窗口会显示比例说明、画布摘要和预览。确认后点击 OK,该比例应用到当前 PPT 的全部幻灯片。

  • 16:9:大多数桌面和 HMI 画面优先使用。
  • 16:10:需要更多垂直空间时使用。
  • 4:3:传统操作面板和旧显示器。
  • 3:2:紧凑工业显示器。
  • 21:9:超宽控制室或大屏。
  • 改变比例时插件会扩展画布,尽量保留现有坐标内容,不通过裁剪旧内容完成换比。
  • Pages with popups 区会说明弹窗如何适应该页面比例;已有宿主侧栏设置会保持独立。

Page Breadcrumb 每列怎么填

点击 Navigation → Page Breadcrumb。Presentation pages 表格每行对应一张幻灯片,直接编辑单元格;未修改的行不会写回。完成后点击 Save,窗口会校验整张表并只保存发生变化的行。

  • Slide:只读幻灯片序号,用于定位当前行。
  • Page Code:必填的稳定导出和导航标识;必须以英文字母开头,后续只用英文字母、数字、下划线或连字符。
  • Level:填写 0 或更大的整数。0 表示不在面包屑显示,1 表示入口页,2 及以上表示更深层子页。
  • Default Text:面包屑默认显示文案,也是 Language Key 为空或无翻译时的回退文案。
  • Language Key:可选,填写已有语言字典中的键,只影响显示文本。
  • Background:勾选后使用 PowerPoint 幻灯片背景;不勾选则页面背景保持透明。
示例:
Page Code = cc01
Level = 1
Default Text = PIY1C1
Language Key = navigation.cc01
Background = checked

一套页面从比例到导航的配置顺序

新建 PPT 后先执行 Page Layout,确认全部幻灯片比例一致;再完成页面排版和 Page Code 规划;然后打开 Page Breadcrumb 逐页填写层级、默认文案、语言键和背景;最后用 Export HTML 整包导出并在 HQControl 中逐级点击面包屑。

  • 先选统一比例。
  • 再规划每页唯一 Page Code。
  • 按幻灯片顺序填写 Level。
  • 需要多语言时同时填 Default Text 和 Language Key。
  • 整包导出后逐项验证入口页、子页、隐藏页和返回路径。

适用场景

主页面、设备详情页和弹窗页共存时,用统一 Page Layout 保持同包画布一致;用 Level 1 标记入口页,Level 2 或更高标记详情页,用 Level 0 隐藏纯弹窗页。需要中英文导航时,Default Text 保证回退可读,Language Key 提供翻译。

边界与常见误区

常见误区:

  • Page Breadcrumb 只管导航的层级和名字,不在这里配报警范围;面包屑节点的报警/故障状态和页面右侧报警窗口共用当前页 alarm.js 中的 HQVISU_PAGE_ALARM(运行时通过 getPageAlarm() 读取,不要重复配置)
  • Page Layout 一次作用于当前 PPT 的全部幻灯片,不是只改当前页,也没有自定义宽高输入框。
  • Page Code 不是随意显示名,必须满足字符规则并保持稳定。
  • Level 不要当成全站层级;它是当前画面包内部的相对层级。
  • 宿主靠导出顺序加层级自动还原父子关系:当前页之前最近一个更低 Level 的页会被当作父页,所以导出页顺序要稳定
  • 改了导航结构(层级、显示名、新增/删除/重命名页面)属于整包变化,必须重新整包 Export HTML,不能只导当前页
Page Layout 页面比例设置对话框
图示 1: Page Layout 页面比例

选择 16:9、16:10、4:3、3:2 或 21:9 比例,并应用到当前 PPT 的全部幻灯片。

Page Breadcrumb 面包屑配置
图示 2: Page Breadcrumb 面包屑

按页设定面包屑层级(Level)和显示名称,决定进入宿主机后的导航显示。