介绍
laliga-vue-js-popover 是一款基于 Vue.js 2.x 的简单易用的 popover 组件。它提供了弹出框的位置自适应、自定义样式和内容、点击任意位置隐藏等功能。
安装
你可以在你的项目中通过 npm 安装 laliga-vue-js-popover:
npm install --save laliga-vue-js-popover
基础使用
在你的 Vue.js 项目中,通过 import 引入组件:
import LaligaPopover from 'laliga-vue-js-popover'
然后在 Vue 内注册组件:
Vue.component('laliga-popover', LaligaPopover)
接下来,你可以在模板中使用 laliga-popover 组件:
-- -------------------- ---- ------- ---------- ----- --------------- -------------- ------- ------------------------------------- ---- ----------------------- -------- ------ ----------------- ------ -----------
在 script 中通过 togglePopover
方法控制弹出框的显示和隐藏:
-- -------------------- ---- ------- -------- ------ ------- - -------- - ------------- -- - --------------------------- - - - ---------
API
laliga-vue-js-popover 提供了一些配置选项和方法。
Props
名称 | 类型 | 默认值 | 描述 |
---|---|---|---|
placement | String | 'bottom' | 弹出框位置。可选值有:'top'、'bottom'、'left'、'right' |
offset | Object | { x: 0, y: 0 } | 弹出框偏移量。例如,如果你想让弹出框向下偏移 10px,你可以设置 { x: 0, y: 10 } |
triggerClass | String | '' | 触发器按钮的额外 class 名称 |
wrapperClass | String | '' | 弹出框的外层容器的额外 class 名称 |
popoverClass | String | '' | 弹出框的额外 class 名称 |
clickToHide | Boolean | true | 是否点击任意位置隐藏弹出框 |
Methods
名称 | 描述 |
---|---|
toggle() | 切换弹出框的显示和隐藏状态 |
show() | 显示弹出框 |
hide() | 隐藏弹出框 |
示例
laliga-vue-js-popover 提供了很多自定义配置选项,以下是一些示例代码:
右侧弹出框
-- -------------------- ---- ------- ---------- ----- --------------- ------------------ ---------------------- ---- ----------------------- ---------- ------ ----------------- ------ -----------
自定义样式
-- -------------------- ---- ------- ---------- ----- --------------- --------------------------------------- ---------------------------------------- ---------------------- ---- ----------------------- ----------- ------ ----------------- ------ ----------- ------- --------------------- - ----------------- ----- - --------------------- - ----------------- ----- - --------
点击任意位置隐藏弹出框
-- -------------------- ---- ------- ---------- ----- --------------- --------------------- ---------------------- ---------------------- ---- ----------------------- -------------- ------ ----------------- ------ ----------- -------- ------ ------- - ---- -- - ------ - ------------ ----- - - - ---------
总结
laliga-vue-js-popover 是一个简单易用的 popover 组件,它提供了位置自适应、自定义样式和内容、点击任意位置隐藏等功能。在你的 Vue.js 项目中使用它,可以让你快速实现弹出框组件。
来源:JavaScript中文网 ,转载请注明来源 https://www.javascriptcn.com/post/6005667f81e8991b448e28fd