diff --git a/packages/vant/src/watermark/README.md b/packages/vant/src/watermark/README.md index 025d31c98..0ac025ed3 100644 --- a/packages/vant/src/watermark/README.md +++ b/packages/vant/src/watermark/README.md @@ -95,13 +95,13 @@ Use the `default slot` to pass HTML directly. Inline styles are supported, and s | --- | --- | --- | --- | | width | Watermark width | _number_ | `100` | | height | Watermark height | _number_ | `100` | -| zIndex | Watermark's z-index | _number_ | `100` | +| z-index | Watermark's z-index | _number \| string_ | `100` | | content | Text watermark content | _string_ | - | | image | Image watermark content. If `content` and `image` are passed at the same time, use the `image` watermark first | _string_ | - | -| fullPage | Whether to display the watermark in full screen | _boolean_ | `true` | +| full-page | Whether to display the watermark in full screen | _boolean_ | `true` | | gapX | Horizontal spacing between watermarks | _number_ | `0` | | gapY | Vertical spacing between watermarks | _number_ | `0` | -| fontColor | Color of text watermark | _string_ | `#dcdee0` | +| font-color | Color of text watermark | _string_ | `#dcdee0` | | opacity | opacity of watermark | _number_ | `1` | ### Slots @@ -117,3 +117,13 @@ The component exports the following type definitions: ```ts import type { WaterProps } from 'vant'; ``` + +## Theming + +### CSS Variables + +The component provides the following CSS variables, which can be used to customize styles. Please refer to [ConfigProvider component](#/en-US/config-provider). + +| Name | Default Value | Description | +| ----------------------- | ------------- | ----------------------- | +| --van-watermark-z-index | _100_ | z-index of root element | diff --git a/packages/vant/src/watermark/README.zh-CN.md b/packages/vant/src/watermark/README.zh-CN.md index cf46d8757..93f3a0ab7 100644 --- a/packages/vant/src/watermark/README.zh-CN.md +++ b/packages/vant/src/watermark/README.zh-CN.md @@ -95,13 +95,13 @@ app.use(Watermark); | --- | --- | --- | --- | | width | 水印宽度 | _number_ | `100` | | height | 水印高度 | _number_ | `100` | -| zIndex | 水印的 z-index | _number_ | `100` | +| z-index | 水印的 z-index | _number \| string_ | `100` | | content | 文字水印的内容 | _string_ | - | | image | 图片水印的内容,如果与 content 同时传入,优先使用图片水印 | _string_ | - | -| fullPage | 水印是否全屏显示 | _boolean_ | `false` | -| gapX | 水印水平间隔 | _number_ | `0` | -| gapY | 水印垂直间隔 | _number_ | `0` | -| fontColor | 文字水印的颜色 | _string_ | `#dcdee0` | +| full-page | 水印是否全屏显示 | _boolean_ | `false` | +| gapX | 水印之间的水平间隔 | _number_ | `0` | +| gapY | 水印之间的垂直间隔 | _number_ | `0` | +| font-color | 文字水印的颜色 | _string_ | `#dcdee0` | | opacity | 水印的透明度 | _number_ | `1` | ### Slots @@ -117,3 +117,13 @@ app.use(Watermark); ```ts import type { WaterProps } from 'vant'; ``` + +## 主题定制 + +### 样式变量 + +组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 [ConfigProvider 组件](#/zh-CN/config-provider)。 + +| 名称 | 默认值 | 描述 | +| ----------------------- | ------ | --------------------- | +| --van-watermark-z-index | _100_ | 根节点的 z-index 层级 | diff --git a/packages/vant/src/watermark/Watermark.tsx b/packages/vant/src/watermark/Watermark.tsx index fa4cfd707..470c3db42 100644 --- a/packages/vant/src/watermark/Watermark.tsx +++ b/packages/vant/src/watermark/Watermark.tsx @@ -8,11 +8,14 @@ import { type ExtractPropTypes, } from 'vue'; import { + extend, + truthProp, + numericProp, createNamespace, + getZIndexStyle, makeNumberProp, makeNumericProp, makeStringProp, - truthProp, } from '../utils'; const [name, bem] = createNamespace('watermark'); @@ -21,7 +24,7 @@ export const watermarkProps = { width: makeNumberProp(100), height: makeNumberProp(100), rotate: makeNumericProp(-22), - zIndex: makeNumberProp(100), + zIndex: numericProp, content: String, image: String, fullPage: truthProp, @@ -166,19 +169,19 @@ export default defineComponent({ } }); - return () => ( -