# watermark-package

**Repository Path**: cloudie/watermark-package

## Basic Information

- **Project Name**: watermark-package
- **Description**: 前端页面水印
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-18
- **Last Updated**: 2025-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# watermark-package

> 前端添加水印
>
> font-end set watermark

当前文档适用于2.0.0及以上版本，之前版本不适用，使用时请安装2.0.0及以上版本

------
### 更新日志

v2.1.2 修复水印移除失效问题（https://github.com/zifeifish/watermark-package/issues/3）
v2.1.1 修复窗口缩放刷新后，水印大小不会自适应变化的问题

------



### 使用（Usage）

**方式一**：如果过你的页面足够简单，只是一个简单的html静态页面或者是你不想引入太多的package,那么你可以下载 [watermark.umd.min.js](https://github.com/zifeifish/watermark-package/blob/master/dist/watermark.umd.js) 并将其导入到 HTML文件中，这样你就可以使用`watermark`的这个全局对象来加载水印:

(Download [watermark.umd.min.js](https://github.com/zifeifish/watermark-package/blob/master/dist/watermark.umd.js) and include it in your HTML document, this will add a global object called `watermark`)

```javascript
<script src="watermark.umd.min.js"></script>

<script type="text/javascript">
      watermark.setWaterMark(
         {
           w_texts: ['娃哈哈', '177****0000'],
         }
      )
</script>
```

**方式二**：安装npm包导入到需要使用的项目中去：

(Alternatively you can use a JavaScript package manager to add it to your project)

```javascript
npm install watermark-package --save

// import
import watermark from 'watermark-package'
```



### **导入后就可以调用下面的方法**

（After that you can call any of methods that are explained in the following）

------



## watermark.setWaterMark

使用时该方法时传入一个 options 配置对象, 配置对象主要有两个属性：`w_texts`、`w_options`。
`w_texts`：水印文案的数组集合可设置多行文案。
`w_options`：水印参数配置项，如字体大小、颜色等

You can use the `watermark.setWaterMark` method to set watermark. The value will automatically be escaped for you.

```javascript
import watermark from 'watermark-package'
// w_texts：水印文案数组集合
watermark.setWaterMark(
   {
      w_texts: ['娃哈哈', '177****0000']
   }
)
```

options 配置对象还有另一个属性 `w_options`水印参数配置： 用于设置水印的具体参数如宽度，大小等，各参数说明见下表

If you need more options, like setting the width, you can add an object with options as the last parameter:

```javascript
import watermark from 'watermark-package'
watermark.setWaterMark(
   {
      w_texts: ['娃哈哈', '177****0000'],
      w_options: {
        w_width: 240,
        w_height: 140,
        w_top: '0px',
        w_left: '0px',
        w_rotateDeg: 25,
        w_font: '1.2rem Vedana',
        w_color: '#666',
        w_opacity: '0.2',
        w_zIndex: '100000',
    }
   }
);

```

| key | value | default value |
|:--|:--|:--|
| `w_width` | A `number`  that the width of the watermark block.<br />(水印块宽度) | 240 |
| w_height | A `number`  that the height of the watermark block.<br />(水印块高度) | 140 |
| w_top | A `string` that the distance between the watermark mask layer and the top of the page.<br />(水印遮罩层距离页面顶部的距离) | '0px' |
| w_left | A `string` that the distance between the watermark mask layer and the left of the page.<br />(水印遮罩层距离页面左边的距离) | '0px' |
| w_rotateDeg | A `string` that specifies SameSite attribute that restricts cookie access based on the site context.<br />(水印角度) | 25 |
| w_font | A `string` that the watermark font size, font style<br />(水印的字体大小、字体风格) | '1.2rem Vedana' |
| w_color | A `string` that the watermark font color<br />(水印字体颜色) | '#666' |
| w_opacity | A `string` that the watermark mask layer transparency<br />(水印遮罩层透明度) | '0.2' |
| w_zIndex | A `string` that the zIndex of watermark mask<br />(水印遮罩层层级) | 10000 |

## watermark.removeWatermark

清除水印

clear watermark

```
watermark.removeWatermark()
```