You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
65 lines
2.5 KiB
65 lines
2.5 KiB
|
|
|
|
## Title 章节标题
|
|
> 代码块： `uTitle`
|
|
|
|
|
|
章节标题，通常用于记录页面标题，使用当前组件，uni-app 如果开启统计，将会自动统计页面标题 。
|
|
|
|
### 安装方式
|
|
|
|
本组件符合[easycom](https://uniapp.dcloud.io/collocation/pages?id=easycom)规范，`HBuilderX 2.5.5`起，只需将本组件导入项目，在页面`template`中即可直接使用，无需在页面中`import`和注册`components`。
|
|
|
|
如需通过`npm`方式使用`uni-ui`组件，另见文档：[https://ext.dcloud.net.cn/plugin?id=55](https://ext.dcloud.net.cn/plugin?id=55)
|
|
|
|
### 基本用法
|
|
|
|
在 ``template`` 中使用组件
|
|
|
|
```html
|
|
<uni-title title="上报统计数据"></uni-title>
|
|
<uni-title type="h1" title="h1 一级标题 "></uni-title>
|
|
<uni-title type="h1" title="h1 一级标题" color="#027fff"></uni-title>
|
|
<uni-title type="h2" title="h2 居中" align="center"></uni-title>
|
|
```
|
|
|
|
|
|
|
|
|
|
### 标题统计
|
|
title 组件可以与 uni统计集合使用，只要开启uni统计，即可自动采集标题
|
|
|
|
- 如果不写 type 属性， 为上报标题。这是标题统计的默认用法，页面会优先上报组件传入的title值为统计上报数据
|
|
- 页面统计上报只会上报一次，如多个组件开启，则只上报最后一个组件的内容，所以如非必要请不要多个组件同时开启统计，避免上报错误标题统计
|
|
- 为避免上报错误标题统计， uni.report() API 与章节标题组件请勿一起使用
|
|
|
|
> - 在使用 align 属性时，在非 nvue 页面下不生效，或者组件宽度不对，请在组件外层设置一个元素的 display为block 即可解决问题。
|
|
>
|
|
> **示例：**
|
|
>
|
|
> ```html
|
|
> <template>
|
|
> <view class="box">
|
|
> <uni-title type="h1" title="h1 一级标题 "></uni-title>
|
|
> </view>
|
|
> </template>
|
|
> <style>
|
|
> .box {
|
|
> /* #ifndef APP-NVUE */
|
|
> display: block;
|
|
> /* #endif */
|
|
> }
|
|
> </style>
|
|
> ```
|
|
|
|
|
|
## API
|
|
### Title Props
|
|
|
|
|属性名 |类型 |默认值 |说明 |
|
|
|:-: |:-: |:-: |:-: |
|
|
|type |String |- |标题类型，可选值 h1、h2、h3、h4、h5 ，章节标题字体会比正常字长字体粗，不指定 type 值，默认为上报统计数据 |
|
|
|title |String |- |章节标题内容 |
|
|
|align |String |- |对齐方式，可选值 left:左对齐；center:居中；right:右对齐； |
|
|
|color |String |- |字体颜色 |
|
|
|stat |Boolean|- |是否开启统计功能呢，如不填写type值，默认为开启，填写 type 属性，默认为关闭 | |