Watermark 水印
为区域内容叠加重复水印,降低截图、转发或打印时的信息泄露风险。
基础用法
文字样式
图片水印
组合
平铺参数
节点恢复
API
Watermark Props
继承自
Omit<HTMLAttributes<HTMLDivElement>, 'content' | 'onError'>
| 属性名 | 描述 | 类型 | 默认值 |
|---|---|---|---|
| text | 水印文本,字符串会按换行拆分。 | string | string[] | - |
| image | 水印图片,字符串等价于 { src },scale 控制未指定尺寸图片的默认高度比例。 | string | WatermarkImage | - |
| pattern | 水印平铺、旋转和图文组合配置。 | WatermarkPattern | - |
| textStyle | 水印文字样式配置。 | WatermarkTextStyle | - |
| opacity | 水印层透明度。 | number | - |
| zIndex | 水印层层级。 | number | - |
| preserve | 恢复水印层节点和关键属性,关闭后不再自动恢复。 | boolean | - |
| onTamper | 检测到水印层被移除、挪动或关键属性被修改时触发。 | (event: WatermarkTamperEvent) => void | - |
| onError | 图片加载或 Canvas 导出失败回调。 | (error: Event | Error, image: WatermarkImage) => void | - |