气泡框 Popover(即将上线)
气泡是一个在移动app(手机app,webApp,小程序,H5)里常见的组件,它由你自定义的事件去触发,显示在某一个元素的周围,可以是上下左右四个方位。
气泡框可通过设置属性为true
、false
来控制显示和隐藏,不设置则显示状态默认为false
。
handleShow() {
this.setData({ show: true })
}
设置气泡的类型
气泡框的类型有两种,text
和list
,通过type
属性来控制。
- 当
type
为text
时,设置text
属性就可以在气泡内显示文本内容。 - 当
type
为list
时,气泡框内显示的是一个列表,你可以传入一个数组去渲染它,当list
的内容超过了气泡的默认最大值后,气泡框内会出现一个可以纵向滚动的滚动条,你可以滑动它来查看超出部分的内容。
示例代码
arr: [
'A',
'C',
'D'
]
}
气泡出现的方位
我们可以通过设置 placement
属性的值来改变气泡出现的方位,可选值为top、left、right、bottom、topLeft、topRight、bottomLeft、bottomRight、leftTop、leftBottom、rightTop、rightBottom
,默认top
。
气泡的背景色可以通过设置bgColor
来改变,默认为黑色半透明背景色(rgba(0, 0, 0, 0.5)。
示例代码
<l-popover show="{{true}}" bgColor="rgba(0, 0, 0, .6)">
<view>点击提示</view>
</l-popover>
设置子节点
我们在使用的组件的时候,可以根据使用场景,自由的在气泡框组件内插入 <image>
<text>
等子节点,当然,你也可以在其中插入 自定义组件
。
设置是否点击关闭
气泡框可以通过设置 locked
属性的值为true
或者 false
来设置他是否可以被点击关闭,默认为 true
如果设置为 true
,点击气泡框的时候会将其关闭
设置按钮的 locked
属性来控制气泡框的锁定态,属性值为 true
时点击气泡框部分不会关闭,属性值为 false
时点击气泡框会立即关闭,默认为 true
。
示例代码
<l-popover show="{{true}}" locked="true">
<view>点击提示</view>
</l-popover>
气泡框属性(Popover Attributes)
注意事项
Popover组件使用cover-view来绘制,层级最高,可以覆盖微信的一些原生组件。
气泡框事件(Popover Events)
事件名称 | 说明 | 返回值 | 备注 |
---|---|---|---|
bind:lintap | 当点击气泡框时触发 | 如果是list类型,会返回当前的下标 | ———— |