tui-section 标题栏 V2.2.0+ 开源组件

介绍

标题栏组件，主要用于文章、列表详情等标题展示。

引入

uni-app引入

第一种，手动引入（可全局引入）

import tuiSection from "@/components/thorui/tui-section/tui-section.vue"
export default {
	components:{
		tuiSection
	}
}

第二种，开启easycom组件模式，如果不了解如何配置，可先查看 官网文档 (opens new window)。

uni-app版本平台差异说明

App-Nvue	App-vue	H5	微信小程序	支付宝小程序	百度小程序	字节小程序	QQ小程序
✓	✓	✓	✓	✓	✓	✓	✓

微信小程序引入（可在app.json中全局引入）

{
  "usingComponents": {
    "tui-section": "/components/thorui/tui-section/tui-section"
  }
}

代码演示

部分功能演示，具体可参考示例程序以及文档API。

基础使用

通过 title 属性设置标题，descr 属性设置描述内容。

<tui-section title="基础使用" descr="基础描述，无背景"></tui-section>

带竖线装饰

通过 title 属性设置标题，isLine 属性设置是否带竖线装饰，background 属性设置组件背景色。

<tui-section title="竖线装饰" is-line background="#fff"></tui-section>

插槽使用

通过 title 属性设置标题，background 属性设置背景颜色，padding 属性设置 padding(内边距) 值，margin 属性设置 margin(外边距) 值。

<!--uni-app-->
<tui-section title="电话号码（插槽使用）" background="#fff" padding="30rpx" margin="48rpx 0">
	<template v-slot:left>
		<image src="/static/images/my/call.png" class="tui-icon"></image>
	</template>
	<view class="tui-right">138****9909</view>
</tui-section>

<!--微信小程序-->
<tui-section title="电话号码（插槽使用）" background="#fff" padding="30rpx" margin="48rpx 0">
	<image slot="left" src="/static/images/my/call.png" class="tui-icon"></image>
	<view class="tui-right">138****9909</view>
</tui-section>

.tui-icon {
	width: 48rpx;
	height: 48rpx;
	margin-right: 20rpx;
}

.tui-right {
	margin-left: auto;
}

Slots

插槽名称	说明
default	默认插槽，标题右侧自定义内容
left	标题左侧自定义内容
descr	自定义描述内容

Props

属性名	类型	说明	默认值
title	String	标题	-
size	Number, String	标题字体大小，单位rpx	32
color	String	标题字体颜色	#333
fontWeight	Number, String	标题字重	400
descr	String	描述文本内容	-
descrSize	Number, String	描述文字大小，单位rpx	24
descrColor	String	描述文字颜色	#7a7a7a
descrTop	Number, String	描述文本距离标题间距，单位rpx	16
isLine	Boolean	是否显示标题前的竖线	false
lineWidth	Number, String	竖线宽度，单位rpx	8
lineColor	String	竖线颜色	#5677fc
lineCap	String	竖线末端样式，可选值square、circle	circle
lineRight	Number, String	竖线距离标题间距，单位rpx	16
lineGap	Number, String	竖线上下间距（top，bottom值），单位rpx	4
background	String	组件背景色	transparent
padding	String	标题栏内边距，值同css padding	20rpx 30rpx
margin	String	标题栏外边距，值同css margin	0

Events

注：uni-app端绑定事件使用@前缀，如@click；微信小程序原生使用bind前缀，如bindclick

事件名	说明	回调参数
click	标题点击时触发	{title:标题}

预览

请以移动端效果为准，touch事件目前尚未在PC端做兼容。

特别说明

• 该组件为 开源组件，uni-app版所有用户均可免费使用。
• 微信小程序原生版仅开源至v1.4.2，后续版本需开通会员才可获取使用。

线上程序扫码预览

ThorUI组件库小程序码	H5二维码	ThorUI示例小程序码