uniapp框架配置项pages.json
pages.json
文件用来对 uni-app
进行全局配置,决定页面文件的路径、窗口样式、原生的导航栏、底部的原生tabbar
等。
globalStyle 全局配置
用于设置应用的状态栏、导航条、标题、窗口背景色等。下面配置项默认应用于每个页面。
注意:更改 pages.json
里面的配置信息后,最好是重新运行项目,并且手机上的app
也要退出重新打开;不然有时候不生效。
状态栏和导航栏
navigationBarBackgroundColor
,默认颜色#F7F7F7
,导航栏北京颜色,同状态栏背景色。
"globalStyle": {
"navigationBarBackgroundColor": "#007aff"
},
2. navigationBarTitleText
,导航栏标题文字内容。
"globalStyle": {
"navigationBarBackgroundColor": "#007aff",
"navigationBarTitleText": "APP"
},
3. navigationBarTextStyle
导航栏标题颜色及状态栏前景颜色,仅支持 black/white
"navigationBarTextStyle": "white"
4. titleImage
,导航栏图片地址(替换导航栏标题文字),支付宝小程序内必须使用https
的图片链接地址。globalStyle
中设置的 titleImage
也会覆盖掉 pages -> style
内的设置文字标题。
"titleImage": "/static/logo.png"
5. transparentTitle
导航栏整体透明( always
一直透明 / auto
滑动自适应 / none
不透明)。
测试:在index.vue
中来个v-for
循环内容超过屏高。
"transparentTitle": "always"
6. navigationStyle
导航栏样式,仅支持 default/custom, custom
不显示原生导航栏并且状态栏不占位。
上拉和下拉刷新配置项与对应生命周期函数
bounce 上拉下拉回弹
backgroundColor
下拉上拉回弹的背景色。
"backgroundColor": "#00FFFF"
backgroundColorTop
下拉顶部窗口的背景色(bounce
回弹区域),backgroundColorBottom
,上拉底部窗口的背景色(bounce
回弹
区域)
"backgroundColorTop": "#ffff00",
"backgroundColorBottom": "#ff00ff"
下拉回弹
上拉回弹
下拉刷新和上拉触底
主要用于下拉刷新数据,上拉触底查询下一页数据。一般针对需要使用的页面进行配置,而不会全局配置。
enablePullDownRefresh
,是否开启下拉刷新。
backgroundTextStyle
,开启下拉刷新后,下拉 loading
的样式,仅支持 dark / light
。
onReachBottomDistance
,页面上拉触底事件触发时距页面底部距离,单位只支持px
。
下拉刷新触发页面生命周期onPullDownRefresh
的方法,如下:
下拉刷新触发结果如下:
上拉触到底部触发方法:onReachBottom
上拉触底:
pages 页面配置
uni-app
通过 pages
节点配置应用由哪些页面组成,pages
节点接收一个数组,数组每个项都是一个对象,其属性值有path
,style
:
属性 | 描述 |
---|---|
path | 配置页面路径 |
style | 配置页面窗口表现 |
pages
节点的第一项为应用入口页即首页,应用中新增减少页面都需要对pages
数组进行修改,文件名不需要写后缀,框架会自动寻找路径下的页面资源。
代码示例:
{
"pages": [ //pages数组中第一项表示应用启动页,参考:https://uniapp.dcloud.io/collocation/pages
{
"path": "pages/category/index",
"style": {
"navigationBarBackgroundColor": "#4cd964",
"navigationBarTitleText": "分类" ,
"navigationBarTextStyle": "white",
"navigationBarShadow": { // 导航栏阴影
"colorType": "red"
},
// "disableScroll": true // 设置为true则页面整体不能上下滚动
"app-plus": { // 主要针对app端配置
"background": "#007AFF",
"scrollIndicator": "none", //不显示滚动条
"titleNView": { // 自定义导航栏
"backgroundColor": "#007AFF", //如果上面设置了navigationBarBackgroundColor,则以此为准
"buttons": [
{
"type": "share" //左上角分享按钮
},
{
"fontSrc": "/static/icon/iconfont.ttf",
"text": "\ue689",
"fontSize": "23",
"float": "left"
}
],
"searchInput": { // 搜索框
"align": "center", //搜索框居中,
"autoFocus": true, //是否获取焦点
"backgroundColor": "#F0F1F2", // 搜索框背景色
"borderRadius": "30rpx", //搜索框圆角
"placeholder": "搜索内容", //搜索提示
"disabled": true,
"placeholderColor": "#F79c9D" //提示文字
}
}
}
}
},
{
"path": "pages/index/index",
"style": {
}
}
],
// 全局配置,
"globalStyle": {
"navigationBarBackgroundColor": "#007aff",
"navigationBarTitleText": "APP",
// "titleImage": "/static/logo.png",
"transparentTitle": "none",
"backgroundColorTop": "#0000FF",
"backgroundColorBottom": "#ff00ff",
"enablePullDownRefresh": true, // 是否开启下拉刷新,默认false
"backgroundTextStyle": "light",
"onReachBottomDistance": 50
},
"uniIdRouter": {}
}
效果:
底部导航tabBar配置
创建tabbar
对应的页面
文件中加入icon图标
配置page代码:
{
"pages": [ //pages数组中第一项表示应用启动页,参考:https://uniapp.dcloud.io/collocation/pages
{
"path": "pages/index/index",
"style": {
}
},
{
"path": "pages/category/index",
"style": {
"navigationBarBackgroundColor": "#4cd964",
"navigationBarTitleText": "分类" ,
"navigationBarTextStyle": "white",
"navigationBarShadow": { // 导航栏阴影
"colorType": "red"
},
// "disableScroll": true // 设置为true则页面整体不能上下滚动
"app-plus": { // 主要针对app端配置
"background": "#007AFF",
"scrollIndicator": "none", //不显示滚 动条
"titleNView": { // 自定义导航栏
"backgroundColor": "#007AFF", //如果上面设置了navigationBarBackgroundColor,则以此为准
"buttons": [
{
"type": "share" //左上角分享按钮
},
{
"fontSrc": "/static/icon/iconfont.ttf",
"text": "\ue689",
"fontSize": "23",
"float": "left"
}
],
"searchInput": { // 搜索框
"align": "center", //搜索框居中,
"autoFocus": true, //是否获取焦点
"backgroundColor": "#F0F1F2", // 搜索框背景色
"borderRadius": "30rpx", //搜索框圆角
"placeholder": "搜索内容", //搜索提示
"disabled": true,
"placeholderColor": "#F79c9D" //提示文字
}
}
}
}
},
{
"path" : "pages/course/course",
"style" :
{
"navigationBarTitleText" : "阅读"
}
},
{
"path" : "pages/question/question",
"style" :
{
"navigationBarTitleText" : "问答"
}
},
{
"path" : "pages/my/my",
"style" :
{
"navigationBarTitleText" : "我的"
}
}
],
"tabBar": {
"color": "#b0abb3", // tab上的文字颜色
"selectedColor": "#345dc2", // 选中的字体颜色
"backgroundColor": "#f8f8f8", //tab背景色
"borderStyle": "black",
"list": [
{
"pagePath": "pages/index/index",
"text": "首页",
"iconPath": "static/tab/index.png",
"selectedIconPath": "static/tab/index-active.png"
},
{
"pagePath": "pages/category/index",
"text": "分类",
"iconPath": "static/tab/category.png",
"selectedIconPath": "static/tab/category-active.png"
},
{
"pagePath": "pages/course/course",
"text": "阅读",
"iconPath": "static/tab/article.png",
"selectedIconPath": "static/tab/article-active.png"
},
{
"pagePath": "pages/question/question",
"text": "问答",
"iconPath": "static/tab/question.png",
"selectedIconPath": "static/tab/question-active.png"
},
{
"pagePath": "pages/my/my",
"text": "我的",
"iconPath": "static/tab/my.png",
"selectedIconPath": "static/tab/my-active.png"
}
]
},
// 全局配置,
"globalStyle": {
"navigationBarBackgroundColor": "#007aff",
"navigationBarTitleText": "APP",
// "titleImage": "/static/logo.png",
"transparentTitle": "none",
"backgroundColorTop": "#0000FF",
"backgroundColorBottom": "#ff00ff",
"enablePullDownRefresh": true, // 是否开启下拉刷新,默认false
"backgroundTextStyle": "light",
"onReachBottomDistance": 50
},
"uniIdRouter": {}
}
效果:
完结~