小程序全局配置文件及常用的配置项

小程序全局配置文件及常用的配置项

小程序目录下的app.json文件是小程序的全局配置 常见配置如下:

1. pages
   • 记录当前小程序所有页面的存放路径
2. window
   • 全局设置小程序窗口的外观

     

     小程序窗口组成部分

     了解window节点常用的配置项

     属性名	类型	默认值	说明
     navigationBarTitleText	String	字符串	导航栏标题文字内容
     navigationBarBackgroundColor	HexColor	#000000	导航栏背景颜色
     navigationBarTextStyle	String	white	导航栏标题颜色 仅支持black/white
     backgroundColor	HexColor	#ffffff	窗口的背景色
     backgroundTextStyle	String	dark	下拉loading的样式 仅支持dark/light
     enablePullDownRefresh	Boolean	false	是否全局开启下拉刷新
     onReachBottomDistance	Number	50	页面上拉触底事件触发时距页面地步距离 单位为px

3. tabBar 用于实现多页面的快速切换

注意:

• tabBar中只能配置最少2个,最多5个tab页签
• 当渲染顶部tabBar时,不显示icon 只显示文本

tabBar的6个组成部分 

1.  backgroundColor: tabBar的背景色
2. selectedIconPath: 选中时的图片路径
3. borderStyle: tabBar上边框的颜色
4. iconPath: 未选中时的图片路径
5. selectedColor: tab上的文字选中时的颜色
6. color: tab上文字未被选中的颜色

tabBar的配置 在app.json中新建一个和window平级的"tabBar":{}

tabBar节点的配置项

属性	类型	必填	默认值	描述
position	String	否	bottom	tabBar的位置 仅支持bottom / top
borderStyle	String	否	black	tabBar上边框的颜色,仅支持black / white
color	HexColor	否		tab上文字的默认(未选中)颜色
selectedColor	HexColor	否		tab上的文字选中时的颜色
backgroundColor	HexColor	否		tabBar的背景色
list	Array	是		tab页签的列表 最少两个,最多五个tab

在 "tabBar":{

新建"list":[

{"pagePath":"路径","text":"文本"},

{}

]}

每个tab项的配置选项

属性	类型	必填	描述
pagePath	String	是	页面路径,页面必须在pages中预先定义
text	String	是	tab上显示的文字
iconPath	String	否	未选中时的图标路径,当position为top时 不显示icon
selectedIconPath	String	否	选中时的图标路径 当position为top时 不显示icon

1. style
   • 是否启用新版的组件样式

 

projiect.config.json文件

project.config.json 是项目配置文件 , 用来记录我们对小程序开发工具所做的个性化配置 , 例如:

• setting 中保存了编译相关的配置
• projectname 中保存的是项目名称
• appid 中保存的是小程序的账号ID

 

sitemap.json 文件

微信现已开放小程序内搜索 , 效果类似于PC网页的SEO sitemap.json文件用来配置小程序页面是否允许微信索引

当开发者允许微信索引时, 微信会通过爬虫的形式 , 在小程序的页面内容建立索引,当用户的搜索关键字和页面的索引匹配成功的时候 , 小程序页面将可能展示在搜索结果中