主题
Text 文本
用于显示和格式化文本,可通过样式类型或自定义颜色控制外观。
支持平台
以下为官网文档所列的平台支持情况,具体功能及版本限制请参见本页的平台说明。
| App-vue | App-nvue | 微信小程序 | 支付宝小程序 | 百度小程序 | 字节小程序 | QQ小程序 | H5 | PC | 快手小程序 | 钉钉小程序 |
|---|---|---|---|---|---|---|---|---|---|---|
| ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
基础用法
vue
<!-- 普通文本 -->
<fui-text text="欢迎使用" :size="28"></fui-text>
<!-- 手机号脱敏 -->
<fui-text text="13800138000" textType="mobile" format></fui-text>属性
| 属性 | 类型 | 说明 | 官网默认值 |
|---|---|---|---|
| type | String | 颜色类型:primary、success、warning、danger、purple、gray、black | black |
| text | String | 要显示的内容 | 空 |
| size | Number、String | 字号,可使用全局配置 | 32 |
| unit | String | 字号单位,可使用全局配置 | rpx |
| color | String | 自定义文字颜色,优先于 type | 空字符串 |
| fontWeight | String | 字重 | 400 |
| align | String | 内容对齐方式:left、center、right | left |
| decoration | String | 文本修饰:none、underline、line-through | none |
| lineHeight | Boolean | 是否将行高设为字号 | false |
| padding | Array | 内边距,顺序为上、右、下、左 | ['0', '0'] |
| block | Boolean | 是否采用块级布局 | false |
| textType | String | 内容类型:text、mobile、amount、name | text |
| format | Boolean | 按手机号或金额类型格式化 | false |
| call | Boolean | 点击后以 text 作为号码拨打电话 | false |
| selectable | Boolean | 是否允许选取文本,nvue 不支持 | false |
| userSelect | Boolean | 微信小程序文本选取开关 | false |
| decode | Boolean | 是否解码文本,平台支持情况以原生 text 为准 | false |
| highlight | Boolean | 是否显示点击态 | false |
| disable | Boolean | 是否禁用点击和拨号 | false |
| unShrink | Boolean | 是否阻止文本在 flex 布局中收缩 | false |
| param | Number、String | 点击事件携带的自定义值 | 空字符串 |
事件
| 事件 | 说明 | 回调参数 |
|---|---|---|
| click | 点击文本时触发;禁用时不触发 | { text, param } |
插槽
| 插槽 | 说明 |
|---|---|
| default | 文本前的自定义内容 |
| right | 文本后的自定义内容 |
版本及平台说明
字号和单位会读取全局配置。普通 Vue 页面主要使用 CSS 变量处理类型颜色,nvue 使用 JavaScript 中的颜色配置。官网对部分类型和格式化范围的说明与此源码存在差异:本地源码还接受数字文本和字重,并对 name 提供格式化处理。