zent-pop
v1.1.0
Published
Zent气泡组件
Downloads
6
Readme
zent-pop
气泡弹层,点击或者hover触发显示。
当目标元素有进一步的描述和相关操作时,可以收纳到卡片中,根据用户的操作行为进行展现。 集成了ToolTip和PopConfirm功能,用户可以对浮层上的元素进行操作,因此它可以承载更复杂的内容,比如链接或按钮等。提供onConfirm方法,就可以实现PopConfirm的相关功能
API
| 参数 | 说明 | 类型 | 默认值 | 备选值 | |------|------|------|--------|--------| | trigger | 触发方式 | string | none | click, hover, focus, none | | position | 弹出框的位置,目前的设定是前一位表示相对触发元素的位置,后一位表示箭头相对于Pop的位置 | string | 'top-center' | 'position-position' | | content | 弹层的内容 | node | | | | header | 用户可以自定义头部 | node | | | | block | 弹层在文档流里是否以块级元素出现 | bool | false | true, false | | onConfirm | 用户自定义回掉,设置以后pop 表现为confirm | func | null | | | onCancel | 用户使用 confirm 的时候可自定义取消的回掉 | func | null | | | confirmText | 用户自定义按钮名 | string | 确定 | | | cancelText | 用户自定义取消按钮 | string | 取消 | | | type | 影响确定按钮的样式 | string | primary | primary, default, danger, success | | className | 自定义类名 | string | | | | prefix | 自定义前缀 | string | zent | |
根据trigger值的不同,Pop
提供了一些额外的控制参数。
trigger为click
| 参数 | 说明 | 类型 | 默认值 | 备选值 | |------|------|------|--------|--------| | closeOnClickOutside | 点击弹层和trigger节点外部时自动关闭 | bool | true | false, true |
trigger为hover
| 参数 | 说明 | 类型 | 默认值 | 备选值 | |------|------|------|--------|--------| | mouseEnterDelay | hover打开的延迟(单位:毫秒) | number | 200 | | | mouseLeaveDelay | 关闭的的延迟(单位:毫秒) | number | 200 | |
trigger为none
| 参数 | 说明 | 类型 | 默认值 | 备选值 |
|------|------|------|--------|--------|
| visible | 外部维护Pop
的显示状态,此时外部拥有Pop
的全部控制权 | bool | false | |
onConfirm
和onCancel
不会自动关闭Pop,需要使用者自己在回掉中控制visible
来关闭Pop。
升级须知
0.4.0
版本有以下不兼容改动:
trigger
默认值为none
,所以之前没有传trigger
参数的地方要加上trigger="click"
visible
参数只有在trigger
为none
时才有效- 移除了
onVisibleChange
这个参数 - 暂时移除了打开/关闭动画
- css类名中的
popover
统一改为pop
,跟组件名字一致,避免和新的Popover
组件冲突 Pop
在文档流里会将children
外面包裹一层div.zent-pop-wrapper
,这个div的显示方式可以通过block
参数控制,默认行内显示- html结构没有大的变化,只是在
.zent-pop
和.zent-pop-inner
,.zent-pop-header
以及.zent-pop-arrow
中间多了一层div.zent-popover-content
,多出的这一层是Popover
组件产生的