页面文件
- wxml文件:用于构建当前页面的结构,包括组件、事件等内容,用户最终看到的页面效果就是该文件显示出来的。
- wxss文件:可选页面,用于设置当前页面的样式效果,该文件规定的样式会覆盖app.wxss 全局样式表中产生冲突的规定,但不会影响其他页面。
- js 文件:可选页面,用于设置当前页面的逻辑代码。
- json 文件:可选页面,用来重新设置app.json 中 window 属性规定的内容,新设置的选项只会显示在当前页面上,不会影响其他页面。
注意: 为了方便开发者减少配置项,建议直接在空白页面文件夹上右击选择“新建”一Page,这样可以一次性创建描述页面的这4种文件,且它们会具有相同的路径与文件名。
属性 | 类型 | 默认值 | 描述 |
---|---|---|---|
navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色,例如#000000 |
navigationBarTextStyle | String | white | 导航栏标题颜色,仅支持black、white |
navigationBarTitleText | String | 导航栏标题文字内容 | |
backgroundColor | HexColor | #fffff | 窗口的背景色 |
backgroundTextStyle | String | dark | 下拉loading 的样式,仅支持 dark、light |
enablePullDownRefresh | Boolean | false | 是否全局开启下拉刷新 |
onReachBottomDistance | Number | 50 | 页面上拉触底事件触发时距页面底部的距离,单位为px。 |
disableScroll | Boolean | false | 若设置为 tue,则页面整体不能上下滚动。另外,该项只在页面配置中有效,无法在app.json中设置 |
"navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle":"black",
"navigationBarTitleText": "这是新标题"
上述代码表示设置导航栏背景颜色为白色、导航栏标题颜色为黑色,并将导航栏标题更新为“这是新标题”。
注意: 页面的JSON 文件只能设置与 window 相关的配置项,以决定本页面的窗口表现,所以无须像app.json 那样专门写 window属性。