Watermark 方法

Watermark 和 BlindWatermark 支持以下全部方法；ImageWatermark 仅支持 create() 和 destroy()。

相关内容： Watermark 指南 · 图片水印指南 · 水印配置生成器

create()

• 描述: 在指定父元素上创建并渲染水印
• 行为:
  • 如果父元素中已有重复水印，则直接返回且不创建
  • 根据contentType（文本/图片/多行文本/富文本）检查内容有效性
  • 使用配置的样式（旋转、透明度等）生成水印画布
  • 将画布转换为带有正确定位的背景图片
  • 应用防御性CSS（!important标记，pointer-events: none）
  • 处理固定（body/html）和自定义父元素
  • 如果mutationObserve=true，则设置MutationObserver
  • 仅在首次创建时触发 onSuccess 回调
• 返回: Promise<void>
• 示例:

  await watermark.create();

destroy()

• 描述: 完全移除水印并清理观察者
• 行为:
  • 触发 onBeforeDestroy() 回调
  • 断开所有 MutationObservers
  • 移除水印DOM节点
  • 触发 onDestroyed() 回调
• 示例:

  watermark.destroy();

check()

• 描述: 验证水印在DOM中的存在性
• 返回: Promise<boolean>
  • true: 水印存在于父元素中
  • false: 未找到水印
• 示例:

  const exists = await watermark.check();

changeOptions()

• 描述: 更新水印配置
• 参数:
  • args: Partial<WatermarkOptions> - 新的配置选项（默认: {}）
  • mode: 'overwrite'|'append' - 如何合并新选项（默认: 'overwrite'）
  • redraw: boolean - 是否立即重新创建 (默认: true)
• 行为:
  • overwrite 会替换之前的显式配置，未传入的配置恢复默认值
  • append 会合并到之前的显式配置
  • 如果 monitorProtection=true，则启用保护
  • 如果 redraw=true，则重新创建水印
• 返回: Promise<void>
• 示例:

  await watermark.changeOptions({ content: 'New Text' }, 'append');

技术细节

• DOM Structure:

<div style="/* 防御性CSS */">
  <div style="/* 背景图片样式 */"></div>
</div>

• 保护机制:

  • MutationObserver用于检测DOM篡改
  • 修改时自动重新创建
  • CSS !important覆盖

• 生命周期回调:

  • onSuccess: 成功创建后触发
  • onBeforeDestroy: 移除前触发
  • onDestroyed: 移除后触发
  • onObserveError: MutationObserver 失败时触发