# Footer 页脚
概述
Footer 页脚，主要使用场景：页面底部显示导航链接、版权等信息。
# 支持平台
目前开发小程序与H5推荐使用 FirstUI nvue版本 (opens new window)。
| 安卓系统版本 | 安卓uni-app | 安卓uniapp-x | iOS系统版本 | iOS uniapp | iOS uniapp-x | 小程序 | H5/Web |
|---|---|---|---|---|---|---|---|
| 5.0 | × | ✓ | 9.0 | × | × | × | ✓ |
# 引入
以下介绍两种常用的引入方式。
第一种：在页面中引用、注册
import fuiFooter from "@/components/firstui/fui-footer/fui-footer.uvue"
export default {
components:{
fuiFooter
}
}
1
2
3
4
5
6
2
3
4
5
6
第二种：easycom组件规范
传统vue组件，需要安装、引用、注册，三个步骤后才能使用组件。easycom将其精简为一步。
First UI easycom配置请查看 快速上手。
如果不了解easycom，可先查看 官网文档 (opens new window)。
# 代码演示
部分示例演示，完整使用请参考示例程序以及文档API。
基础使用
通过 text 属性设置版权信息。
<fui-footer text="Copyright © 2021 firstui.cn"></fui-footer>
1
设置导航链接
通过 navigate 属性设置导航链接。
<fui-footer :navigate="navigate" text="Copyright © 2021 firstui.cn"></fui-footer>
1
import { FuiFooterNavigateParam } from '@/components/firstui/fui-types/index.uts'
export default {
data() {
return {
navigate: [{
text: '底部链接',
openType: 'navigateBack'
}, {
text: '底部链接',
openType: 'navigateBack'
}] as Array<FuiFooterNavigateParam>
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
固定于底部
通过 isFixed 属性设置页脚是否固定于底部。
<fui-footer :isFixed="true" text="Copyright © 2021 firstui.cn"></fui-footer>
1
# Slots
| 插槽名称 | 说明 |
|---|---|
| - | - |
# Props
| 属性名 | 类型 | 说明 | 默认值 | 平台差异说明 |
|---|---|---|---|---|
| navigate | Array<FuiFooterNavigateParam> | 导航链接设置 | [ ] | - |
| cancelNav | Boolean | 是否取消 navigate 中链接跳转，使用@onclick事件自行处理 | false | - |
| text | String | 底部文本，版权信息 | - | - |
| color | String | 文本字体颜色 | #B2B2B2 | - |
| size | Number | 文本字体大小，单位rpx | 24 | - |
| background | String | footer背景颜色 | transparent | - |
| borderColor | String | 导航链接之间分隔线颜色 | #B2B2B2 | - |
| isFixed | Boolean | 是否固定在底部 | false | - |
| safeArea | Boolean | 是否适配底部安全区 | true | - |
# FuiFooterNavigateParam
/**
* fui-footer 页脚组件 navigate 属性参数类型
* @description props navigate：Arrary：FuiFooterNavigateParam[]
* @param {string} text {string} 链接文本
* @param {string} url {string} 当前应用内的跳转链接
* @param {string} openType {string} 跳转方式，可选值：navigate、redirect、switchTab、reLaunch、navigateBack等
* @param {number} delta {number} 返回的页面数，如果 delta 大于现有页面数，则返回到首页【仅openType=navigateBack 有效】
* @param {string} color {string} 链接文本字体颜色
* @param {number} size {number} 链接文本字体大小，单位rpx
*/
export type FuiFooterNavigateParam = {
text : string;
url ?: string;
openType ?: string;
delta ?: number;
color ?: string;
size ?: number;
}
/*页面引入*/
import { FuiFooterNavigateParam } from '@/components/firstui/fui-types/index.uts'
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
# Events
| 事件名 | 类型 | 说明 | 回调参数 |
|---|---|---|---|
| @onclick | (event: FuiFooterNavigateParam) => void | 点击链接时触发 | FuiFooterNavigateParam |
# FuiFooterNavigateParam
同上。
Footer 页脚