select-text
可选文本组件。该组件有两种使用模式:长按出现选区,与浏览器默认效果一致;长按出现复制按钮,点击复制拷贝全部内容至剪贴板,常见于聊天对话框等场景。
需注意的时,为实现点击其它区域隐藏复制按钮,开发者可在页面最外层监听 tap
事件,并将 evt
对象赋值给 on-document-tap
。
安装
npm install @miniprogram-component-plus/select-text
在页面 page.json 中
// page.json
{
"usingComponents": {
"mp-select-text": "@miniprogram-component-plus/select-text"
}
}
示例代码
属性列表
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
value | String | 是 | 文本组件内容 | |
space | String | 否 | 显示连续空格 | |
decode | Boolean | false | 否 | 是否解码 |
show-copy-btn | Boolean | false | 否 | 长按显示复制按钮 |
z-index | Number | 99 | 否 | 复制按钮的层级 |
active-bg-color | String | #DEDEDE | 否 | 长按复制时文本区背景色 |
on-document-tap | Object | 否 | 否 | 页面监听事件 |
space 的合法值
属性 | 类型 |
---|---|
ensp | 中文字符空格一半大小 |
emsp | 中文字符空格大小 |
nbsp | 根据字体设置的空格大小 |
代码演示
<view bind:tap="handleTap">
<view class="demo-block">
<block wx:for="{{arr}}" wx:key="placement">
<view class="list-item">
<mp-select-text
show-copy-btn
placement="{{item.placement}}"
value="{{item.value}}"
data-id="{{index}}"
on-document-tap="{{evt}}"
>
</mp-select-text>
</view>
</block>
<view class="list-item">
<mp-select-text value="默认的长按效果与浏览器一致"></mp-select-text>
</view>
</view>
</view>
Page({
data: {
arr: [{
value: '长按,上侧复制',
placement: 'top'
},
{
value: '长按,右侧复制',
placement: 'right'
},
{
value: '长按,左侧复制',
placement: 'left'
},
{
value: '长按,下侧复制',
placement: 'bottom'
}]
},
handleTap(e) {
this.setData({ evt: e })
}
})