跳转到内容

自动更新 observe ​

适用于组件和指令。

observe 控制图片 DOM 的自动监听和更新频率。监听范围包括容器内部 <img> 元素的增删、排序和属性变化(如 src、alt),也包括整段 Markdown 或 HTML 替换后产生的图片变化。无关的文字、样式容器和 Viewer.js 自身生成的界面不会触发图库更新。

值行为适用场景
true(默认)从首次图片变化开始等待 50ms,将期间的变化合并更新。分批渲染的 Markdown、HTML 或短时间连续变化的图片。
0不额外设置等待窗口,异步执行一次更新;在该次更新执行前发生的图片变化仍会合并。变化不频繁、希望尽快更新的图库。
正数,如 100将指定毫秒数内的图片变化合并更新。更新较频繁,尤其是开启 rebuild 的场景。
false关闭图片 DOM 自动监听;仍会初始化图库,配置变化和手动 update() 仍然生效。内容固定,或由调用者控制更新时间。

例如,同一次同步操作中连续添加 10 个 <img>,0 也可以合并为一次更新;如果图片分多次异步操作添加,0 可能更新多次,而 50 会合并同一 50ms 窗口内的变化。

计时从首次图片变化开始,后续变化不会重新计时,持续变化的图库会按窗口定期更新。首次初始化立即执行;等待时间仅用于后续图片 DOM 的自动更新。

默认更新复用实例并调用 update();开启 rebuild 后,每批变化改为销毁并重建实例。observe 可动态修改,设为 false 会取消尚未执行的自动更新。

基于 MIT 许可发布