# 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 })
  }
})