更新记录

0.1.4(2025-08-31)

  • feat: 兼容 uniappx 鸿蒙next

0.1.3(2025-02-21)

  • fix: uniapp prop缺少vue影响使用的问题

0.1.1(2025-02-09)

  • feat: 兼容uniappx 微信小程序
查看更多

平台兼容性

uni-app(4.75)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
5.0
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 快应用-华为 快应用-联盟
- - -

uni-app x(4.75)

Chrome Safari Android iOS 鸿蒙 微信小程序
5.0

lime-watermark 水印组件

一个功能丰富的水印组件,用于在页面上添加文字或图片水印。支持自定义内容、旋转角度、间距、字体样式等多种配置,可用于版权保护、信息标识等多种场景。组件提供了丰富的自定义选项,可以满足各种水印展示需求。

插件依赖:lime-sharedlime-style

文档链接

📚 组件详细文档请访问以下站点:

安装方法

  1. 在uni-app插件市场中搜索并导入lime-watermark
  2. 导入后可能需要重新编译项目
  3. 在页面中使用l-watermark组件

代码演示

基础用法

最简单的水印组件用法,只需要设置水印内容即可。

<l-watermark content="LIME UI">
  <view class="content">
    页面内容区域
  </view>
</l-watermark>

多行文字水印

设置多行文字作为水印内容。

<l-watermark :content="['LIME UI', '版权所有']">
  <view class="content">
    页面内容区域
  </view>
</l-watermark>

图片水印

使用图片作为水印。

  • 注意:uvue app不支持
  • 使用widthheight控制图片的大小
  • 注意,网络图片在H5NVUE需要解决跨域问题,在小程序需要去公众平台配置download域名
<l-watermark image="https://example.com/logo.png">
  <view class="content">
    页面内容区域
  </view>
</l-watermark>

自定义样式

设置水印的旋转角度、颜色、字体大小等样式。

<l-watermark 
  content="LIME UI" 
  :rotate="30" 
  :font="{ color: 'rgba(0, 0, 0, 0.15)', fontSize: 16 }"
>
  <view class="content">
    页面内容区域
  </view>
</l-watermark>

自定义间距

设置水印之间的水平和垂直间距。

<l-watermark 
  content="LIME UI" 
  :gap="[60, 60]"
>
  <view class="content">
    页面内容区域
  </view>
</l-watermark>

自定义偏移

设置水印的偏移位置。

<l-watermark 
  content="LIME UI" 
  :offset="[20, 20]"
>
  <view class="content">
    页面内容区域
  </view>
</l-watermark>

全屏水印

设置水印覆盖整个屏幕。

<l-watermark 
  content="LIME UI" 
  full-screen
>
  <view class="content">
    页面内容区域
  </view>
</l-watermark>

自定义水印大小

设置单个水印的宽度和高度。

<l-watermark 
  content="LIME UI" 
  :width="120" 
  :height="60"
>
  <view class="content">
    页面内容区域
  </view>
</l-watermark>

快速预览

导入插件后,可以直接使用以下标签查看演示效果:

<!-- 代码位于 uni_modules/lime-watermark/components/lime-watermark -->
<lime-watermark />

插件标签说明

标签名 说明
l-watermark 组件标签
lime-watermark 演示标签

Vue2使用说明

main.js中添加以下代码:

// vue2项目中使用
import Vue from 'vue'
import VueCompositionAPI from '@vue/composition-api'
Vue.use(VueCompositionAPI)

详细配置请参考官方文档:Vue Composition API

API文档

Props 属性说明

属性名 说明 类型 默认值
zIndex 水印层级 number 9
rotate 水印旋转角度 number -22
width 单个水印的宽度 number -
height 单个水印的高度 number -
image 水印图片地址 string -
content 水印文字内容 string | string[] -
font 水印文字样式 object -
gap 水印之间的间距 [水平间距, 垂直间距] number[] [30, 30]
offset 水印偏移量 [水平偏移, 垂直偏移] number[] -
fullScreen 是否为全屏水印 boolean false
baseSize 图片内容重复次数 number 2
fontGap 多行文字之间的行间隔 number 3

font 对象属性

属性名 说明 类型 默认值
color 文字颜色 string -
fontSize 文字大小 number | string -
fontWeight 文字粗细 'normal' | 'light' | 'weight' | number -
fontStyle 文字样式 'none' | 'normal' | 'italic' | 'oblique' -
fontFamily 字体 string -

Slots 插槽

名称 说明
default 水印包裹的内容

支持与赞赏

如果你觉得本插件解决了你的问题,可以考虑支持作者:

支付宝赞助 微信赞助

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率: