1.0.6 • Published 1 month ago

@tanzhenxing/zx-tooltip v1.0.6

Weekly downloads
-
License
ISC
Repository
-
Last release
1 month ago

zx-tooltip 文字提示组件

组件说明

zx-tooltip 是一个适用于 H5、小程序、App 的通用提示信息组件,支持多种位置、主题、触发方式、插槽内容等,参考了 Element Plus Tooltip 设计。

效果展示

支持上、下、左、右多种方向,支持 hover、click、focus 触发,支持自定义内容和主题。

使用方法

基本用法

<template>
  <view>
    <zx-tooltip content="这是一条提示信息">
      <button>悬停显示提示</button>
    </zx-tooltip>
  </view>
</template>

主题

<template>
  <view>
    <zx-tooltip content="深色主题" effect="dark">
      <button>深色</button>
    </zx-tooltip>
    <zx-tooltip content="浅色主题" effect="light">
      <button>浅色</button>
    </zx-tooltip>
  </view>
</template>

多行/自定义内容

<template>
  <zx-tooltip placement="top">
    <template #content>
      <view>多行内容<br />第二行</view>
    </template>
    <button>自定义内容</button>
  </zx-tooltip>
</template>

触发方式

<template>
  <zx-tooltip content="点击显示" trigger="click">
    <button>点击显示</button>
  </zx-tooltip>
  <zx-tooltip content="聚焦显示" trigger="focus">
    <input placeholder="聚焦显示提示" />
  </zx-tooltip>
</template>

属性

属性名说明类型默认值
content显示的内容String''
rawContent内容是否为 HTMLBooleanfalse
placement出现位置(top/bottom/left/right)Stringtop
effect主题(dark/light)Stringdark
disabled是否禁用Booleanfalse
showArrow是否显示箭头Booleantrue
trigger触发方式(hover/click/focus)Stringhover
showAfter显示延迟(ms)Number0
hideAfter隐藏延迟(ms)Number200
autoClose自动关闭(ms)Number0
offset偏移距离(rpx)Number12
popperClass自定义类名String''
modelValue控制显示/隐藏Boolean-

事件

事件名说明回调参数
update:modelValue显示/隐藏变化Boolean
show显示时触发-
hide隐藏时触发-

插槽

插槽名说明
default触发元素内容
content自定义提示内容

注意事项

  • 组件不依赖浏览器特有 DOM,适配 H5、小程序、App。
  • 由于平台限制,定位仅支持简单偏移,复杂场景请自定义样式。

贡献

如有建议或问题,欢迎提 issue。

1.0.6

1 month ago

1.0.5

1 month ago

1.0.4

2 months ago

1.0.2

10 months ago

1.0.1

11 months ago

1.0.0

11 months ago