Awesome
watermark-dom
watermark.js
是基于DOM对象实现的BS系统的水印,确保系统保密性,安全性,降低数据泄密风险,简单轻量,支持多属性配置,动态计算水印,水印防被删(监听水印组件元素删除并重新添加,监听改变水印的属性并重新添加)。
特性:
- 多属性配置,简单易上手
- 动态计算水印
- 水印防被删(监听水印组件元素删除并重新添加,监听改变水印的属性并重新添加)
- 支持2种导入使用:本地引用,npm引用
- 水印测试工具:testTool工具
- 内置3种全局API方法:init(),load(), remove()。
- 原理:pointer-events事件穿透属性,Shadow DOM(影子DOM),opacity等
注意:基于本项目源码从事科研、论文、系统开发,"最好"在文中或系统中表明来自于本项目的内容和创意,否则所有贡献者可能会鄙视你和你的项目。 使用本项目源码请尊重程序员职业和劳动
1、版本及功能
-
版本v 2.3.0 更新时间:2019.12.14
- 新增功能:监听前端页面手动删除水印挂载的父元素,或删除影子DOM里的单个水印,当删除时会自动添加新水印。
-
版本v 2.2.2 更新时间:2019.12.11
- 优化:水印图层会撑开页面高度的问题。
-
版本v 2.2.1 更新时间:2019.11.19
-
版本v 2.2.0 更新时间:2019.11.11
- 解决watermark_parent_node不管用,谢谢Tianruo和sunweiconfidence
- 解决水印显示不全,谢谢ydCao和Altamill提出。
-
版本v 2.1.1 更新时间:2019.11.02
- 解决水印可以被隐藏,谢谢maqingbo
- 解决水印图层会撑开默认页面宽度的情况,谢谢dyh333和rumenxiaozi和jixiang155提出。
-
版本v 2.1.0 更新时间:2019.08.16
- 新增支持滚屏,谢谢ishwy提出。
- 解决缩放存在水印消失的问题,谢谢wangmeng1991指出。
- 解决loadMark多次调用时defaultSettings变量的复用问题,谢谢shellphon指出。
-
版本v 2.0.3 更新时间:2019.06.18
- 发布最新npm包
npm i watermark-dom @2.0.3
,支持方法:init(), load(), remove()
,放心使用
- 发布最新npm包
-
版本v 2.0.2 更新时间:2019.06.17
- 作为更新npm包,出现的问题,请不要用这个版本的包
- 发布到最新npm包,有问题,误用
-
版本v 2.0.1 更新时间:2019.06.12
- 1、支持移除水印方法remove()
- 2、废弃生成水印的createShadowRoot方法,而使用attachShadow方法。(使用上没有影响,因为最初设计时候做了兼容处理)
- 3、未发布到最新npm包
-
版本v 2.0.0
- 1、支持AMD,CommonJs,ES6 module模块规范;
- 2、支持浏览器:Chrome,Firefox,Safari,IE9及以上;
- 3、未发布到最新npm包
-
版本v 1.0.0
- 1、支持文本水印;
- 2、支持本地js,支持npm包;
- 2、支持浏览器:Chrome,Firefox,Safari;
- 3、支持api
2、水印插件-使用
2.1 本地引入封装的js文件
只是简单的加一个很浅的水印,实现起来很容易。不需要引入jquery插件。
watermark.js
是必须要引进的组件
第一步:获取组件方式:git clone https://github.com/saucxs/watermark-dom.git
第二步:clone后,在需要加水印的相关页面引入水印文件"watermark.js":
<script type="text/javascript" src="./watermark.js"></script>
第三步:在确保页面DOM加载完毕之后,调用watermark的load方法(手动加载):
<script>watermark.load({ watermark_txt: "测试水印,1021002301,测试水印,100101010111101" })</script>
注意:我们提供了init方法,用来初始化水印,添加load和resize事件
<script>watermark.init({ watermark_txt: "测试水印,1021002301,测试水印,100101010111101" })</script>
使用插件的效果地址1:http://www.chengxinsong.cn
Sample One:https://www.mwcxs.top/static/testTool/examples/examples-simple/index.html
Sample Two:https://www.mwcxs.top/static/testTool/examples/examples-setInterval/demo.html
2.2 npm包引入
第一步:npm获取水印组件包:
npm install watermark-dom
第二步:引入水印模块:
import watermark from 'watermark-dom'
或者
var watermarkDom = require("watermark-dom")
第三步:在确保页面DOM加载完毕之后,调用watermark的load方法(手动加载):
<script>watermark.load({ watermark_txt: "测试水印,1021002301,测试水印,100101010111101" })</script>
注意:(1)我们提供了init方法,用来初始化水印,添加load和resize事件
<script>watermark.init({ watermark_txt: "测试水印,1021002301,测试水印,100101010111101" })</script>
注意:(2)我们提供了remove方法,用来移除水印
<script>watermark.remove({ watermark_txt: "测试水印,1021002301,测试水印,100101010111101" })</script>
3、水印插件-testTool(测试工具)
查看地址:https://www.mwcxs.top/static/testTool/index.html
看到水印插件-测试demo的效果
4、内置方法
4.1 watermark.init(setting);
初始化水印,添加load和resize事件
例子
watermark.init({ watermark_txt: "测试水印,1021002301,测试水印,100101010111101" });
4.2 watermark.load(setting);
手动加载水印
例子
watermark.load({ watermark_txt: "测试水印,1021002301,测试水印,100101010111101" });
4.3 watermark.remove();
手动移除水印
例子
watermark.remove();
5、支持各种属性配置使用
watermark_id: 'wm_div_id', //水印总体的id
watermark_prefix: 'mask_div_id', //小水印的id前缀
watermark_txt:"测试水印", //水印的内容
watermark_x:20, //水印起始位置x轴坐标
watermark_y:20, //水印起始位置Y轴坐标
watermark_rows:0, //水印行数
watermark_cols:0, //水印列数
watermark_x_space:100, //水印x轴间隔
watermark_y_space:50, //水印y轴间隔
watermark_font:'微软雅黑', //水印字体
watermark_color:'black', //水印字体颜色
watermark_fontsize:'18px', //水印字体大小
watermark_alpha:0.15, //水印透明度,要求设置在大于等于0.005
watermark_width:100, //水印宽度
watermark_height:100, //水印长度
watermark_angle:15, //水印倾斜度数
watermark_parent_width:0, //水印的总体宽度(默认值:body的scrollWidth和clientWidth的较大值)
watermark_parent_height:0, //水印的总体高度(默认值:body的scrollHeight和clientHeight的较大值)
watermark_parent_node:null //水印插件挂载的父元素element,不输入则默认挂在body上
上面的属性都支持配置的,怎么使用呢?
基本山需要自己配置的属性:watermark_txt
,watermark_color
,watermark_fontsize
,watermark_alpha
,watermark_angle
,watermark_width
,watermark_height
这7个属性一般是经常用到的,其他属性一般用的偏少。需要用到的就设置一下,不需要用到的就可以不设置,插件内部会有默认值的。
比如load方法的属性配置
watermark.load({
watermark_txt:"测试水印,saucxs,测试水印,songEagle,工号等", //水印的内容
watermark_color:'#5579ee', //水印字体颜色
watermark_fontsize:'24px', //水印字体大小
watermark_alpha:0.5, //水印透明度,要求设置在大于等于0.005
watermark_angle:135, //水印倾斜度数
watermark_width:200, //水印宽度
watermark_height:200, //水印长度
});
所以一般先在watermark-dom的测试工具上,把需要配置的属性值,调试好之后在写入代码中,这样效率更高。
6、API介绍
格式:[请求类型:]URL地址
例如:
get:/api/watermark //获取水印参数
post:/api/watermark //发布水印参数
put:/api/watermark //更新水印参数
delete:/api/watermark //删除水印参数
PS:如果没有添加请求类型的话,默认为get请求。
返回结果定义:
返回结果根据不同的状态需要定义,返回结果<<<
标识,例如:
<<<
success
{
"errNum":0,
"retMsg":"success",
"retData":{
"watermark_txt":"测试水印",
"watermark_x":20,//水印起始位置x轴坐标
"watermark_y":20,//水印起始位置Y轴坐标
"watermark_rows":0,//水印行数
"watermark_cols":0,//水印列数
"watermark_x_space":100,//水印x轴间隔
"watermark_y_space":50,//水印y轴间隔
"watermark_font":'微软雅黑',//水印字体
"watermark_color":'black',//水印字体颜色
"watermark_fontsize":'18px',//水印字体大小
"watermark_alpha":0.15,//水印透明度,要求设置在大于等于0.003
"watermark_width":150,//水印宽度
"watermark_height":100,//水印长度
"watermark_angle":15,//水印倾斜度数
}
}
<<<
error
{
"errNum":0,
"retMsg":"success",
"retData":[]
}
7、支持浏览器
Chrome,FireFox,Safari,IE9及以上浏览器
8、其他
欢迎使用watermark-dom插件,功能:给B/S网站系统加一个很浅的dom水印插件。
欢迎使用captcha-mini插件,功能:生成验证码的插件,使用js和canvas生成的
欢迎使用watermark-image插件,目前功能:图片打马赛克
一些使用文章介绍:
【1】https://juejin.im/post/5cb686f451882532c1535199
【2】http://www.chengxinsong.cn/post/34
感谢支持
1、作者常用昵称有saucxs,songEagle,松宝写代码。「松宝写代码」公众号作者,每日一题,实验室等。一个爱好折腾,致力于全栈,正在努力成长的字节跳动工程师,星辰大海,未来可期。内推字节跳动各个部门各个岗位。
2、长按下面图片,关注「松宝写代码」,是获取开发知识体系构建,精选文章,项目实战,实验室,每日一道面试题,进阶学习,内推字节跳动,思考职业发展,涉及到JavaScript,Node,Vue,React,浏览器,http,算法,端相关,小程序等领域,希望可以帮助到你,我们一起成长~
字节内推福利
公众号后台回复
- 回复「校招」获取内推码
- 回复「社招」获取内推
- 回复「实习生」获取内推
后续会有更多福利
学习资料福利
回复「算法」获取算法学习资料
往期🔥「每日一题」🔥
持续更新中~
每日一题Github地址:https://github.com/saucxs/full_stack_knowledge_list
1、JavaScript && ES6
-
第 16 题:【每日一题】面试官问:JS中如何全面进行客户端检测?
-
第 15 题:【每日一题】面试官问:JS类型判断有哪几种方法?
-
第 14 题:【每日一题】面试官问:谈谈你对JS对象的创建和引申
-
第 12 题[每日一题]面试官问:JS引擎的执行过程(二)
-
第 11 题[每日一题]面试官问:JS引擎的执行过程(一)
-
第 10 题[每日一题]面试官问:详细说一下JS数据类型
2、浏览器
3、Vue
4、HTML5
5、算法
-
第 26 道【每日一题】(26题)算法题:最长公共前缀?