将页面截图功能组合到指定组件。
该方法会为触发按钮注册节流处理后的点击回调。点击时会使用
window.domtoimage.toPng 捕获指定 DOM 元素,生成 PNG 数据 URI,
并通过浏览器下载保存为 {title}_{timestamp}.png 文件。
触发按钮既可以是宜搭组件(通过 window.usePlus().env.context.$ 访问),
也可以是普通 DOM 元素(通过 .${clickableComponentFieldId} 选择器访问)。
触发截图功能的按钮组件字段标识或 DOM 类名。
需要被截图的 DOM 元素 ID。
导出文件标题,可为字符串或返回字符串的函数;默认为 "view"。
Window.domtoimage静态of创建一个新的页面截图服务实例。
创建过程中会通过 YidaPageContext.utils 动态加载
dom-to-image 库,因此截图功能首次使用前需要确保网络可达。
初始化后的页面截图服务实例。
页面截图服务。
该服务通过在按钮组件绑定点击事件,捕获指定 DOM 元素并下载为 PNG 图片。 截图过程经过 Utils.Throttle 节流处理,避免重复点击。 截图能力依赖第三方库
dom-to-image,首次创建服务实例时会通过 YidaPageContext.utils 动态加载该库。添加于
26.7.1
参阅
Window.domtoimage示例