Skip to content

Text 文本 v0.2.0+

19:21

此组件集成了文本类在项目中的常用功能,包括状态,拨打电话,格式化日期,*替换,超链接...等功能。 您大可不必在使用特殊文本时自己定义,text组件几乎涵盖您能使用的大部分场景。

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

  • 通过text参数设置文本内容。推荐您使用:text='value'的形式
html
<u-text text="我用十年青春,赴你最后之约"></u-text>

设置主题

  • 通过type参数设置文本主题,我们提供了五类属性。
  • primary error success warning info
html
<u-text type="primary" text="主色"></u-text>
<u-text type="error"   text="错误"></u-text>
<u-text type="success" text="成功"></u-text>
<u-text type="warning" text="警告"></u-text>
<u-text type="info"    text="信息"></u-text>

拨打电话

  • 通过将mode属性设置为phone即可调用拨打电话,提供加密值encrypt
  • 除此之外还有格式化日期,姓名脱敏,超链接,千分位金额等属性,将在以下实例中展示
html
<u-text mode="phone" text="15019479320"></u-text>

日期格式化

html
<u-text mode="date" text="1612959739"></u-text>

姓名脱敏

html
<u-text mode="name" text="张三三" format="encrypt"></u-text>

超链接

添加href指定链接地址

html
<u-text mode="link" text="Go to uView docs" href="https://www.uviewui.com" ></u-text>

显示金额

html
<u-text mode="price" text="728732.32"></u-text>

前后图标

添加prefixIcon,suffixIcon指定图标和位置,iconStyle设置图标大小

html
<u-text prefixIcon="baidu" iconStyle="font-size: 19px" text="百度一下,你就知道"></u-text>
<u-text suffixIcon="arrow-leftward" iconStyle="font-size: 18px" text="查看更多"></u-text>

超出隐藏

内置了文字超出隐藏样式,设置lines属性表明几行后隐藏

html
<u-text 
    :lines="2" 
    text="uView Pro 是在 uView 1.8.8 官方组件库基础上,采用 Vue3 全新语法彻底重构的 uni-app 生态框架。不同于
    市面上的其他 uView 框架等兼容 Vue3 的方案,uView Pro 并非简单兼容,而是对每一个组件和工具进行源码级重构,
    充分发挥 Vue3 的响应式和组合式优势,API 设计更现代,性能更优越。">
</u-text>

小程序开放能力

针对小程序开放能力,我们提供了分享,请在小程序环境下使用

html
<u-text text="分享到微信" openType="share" type="success" @click="clickHandler"></u-text>
<script>
	export default {
		onLoad() {},
		methods: {
			clickHandler() {
				// #ifndef MP-WEIXIN
				uni.$u.toast('请在微信小程序内查看效果')
				// #endif
			}
		},
	}
</script>

API

List Props

参数说明类型默认值可选值
type主题颜色String--
show是否显示Booleantruefalse
text显示的值String|Number--
prefixIcon前置图标String--
suffixIcon后置图标String--
mode文本处理的匹配模式text-普通文本,price-价格,phone-手机号,name-姓名,date-日期,link-超链接String-
hrefmode=link下,配置的链接String--
format格式化规则String|Function--
callmode=phone时,点击文本是否拨打电话Booleanfalsetrue
openType小程序的打开方式String--
bold是否粗体,默认normalBooleanfalsetrue
block是否块状Booleanfalsetrue
lines文本显示的行数,如果设置,超出此行数,将会显示省略号String|Number--
color文本颜色String#303133-
size字体大小String|Number15-
iconStyle图标的样式Object|String15px-
decoration文字装饰,下划线,中划线等Stringnoneunderline/line-through
margin外边距,对象、字符串,数值形式均可Object|Number|String--
lineHeight文本行高Number|String--
align文本对齐方式(仅block="true"方式生效)Stringleftcenter/right
wordWrap文字换行Stringnormalbreak-word/anywhere

List Events

事件名说明回调参数
click点击触发事件-