:wxref:`页面配置 <configuration/page>`
===========================================

每一个小程序页面也可以使用 ``.json`` 文件来对本页面的窗口表现进行配置。
页面中配置项在当前页面会覆盖 :file:`app.json` 的 :envvar:`window` 中相同的配置项。
文件内容为一个 JSON 对象，有以下属性：

配置项
------------

+------------------------------+----------+----------+----------------------------------------+-------------------+
|             属性             |   类型   |  默认值  |                  描述                  |     最低版本      |
+==============================+==========+==========+========================================+===================+
| navigationBarBackgroundColor | HexColor | #000000  | 导航栏背景颜色，如 #000000             |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| navigationBarTextStyle       | string   | white    | 导航栏标题颜色，仅支持 black / white   |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| navigationBarTitleText       | string   |          | 导航栏标题文字内容                     |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| navigationStyle              | string   | default  | 导航栏样式，仅支持以下值：default      |                   |
|                              |          |          | 默认样式custom 自定义导航栏，          |                   |
|                              |          |          | 只保留右上角胶囊按钮                   | 微信客户端 7.0.0  |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| backgroundColor              | HexColor | #ffffff  | 窗口的背景色                           |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| backgroundTextStyle          | string   | dark     | 下拉 loading 的样式，                  |                   |
|                              |          |          | 仅支持 dark / light                    |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| backgroundColorTop           | string   | #ffffff  | 顶部窗口的背景色，                     |                   |
|                              |          |          | 仅 iOS 支持                            | 微信客户端 6.5.16 |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| backgroundColorBottom        | string   | #ffffff  | 底部窗口的背景色，                     |                   |
|                              |          |          | 仅 iOS 支持                            | 微信客户端 6.5.16 |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| enablePullDownRefresh        | boolean  | false    | 是否开启当前页面下拉刷新。             |                   |
|                              |          |          | 详见 Page.onPullDownRefresh            |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| onReachBottomDistance        | number   | 50       | 页面上拉触底事件触发时距页面底部距离， |                   |
|                              |          |          | 单位为px。详见 Page.onReachBottom      |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| pageOrientation              | string   | portrait | 屏幕旋转设置，                         |                   |
|                              |          |          | 支持 auto/portrait/landscape           |                   |
|                              |          |          | 详见响应显示区域变化                   |                   |
|                              |          |          | 2.4.0(auto)/2.5.0(landscape)           |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| disableScroll                | boolean  | false    | 设置为 true 则页面整体不能上下滚动。   |                   |
|                              |          |          | 只在页面配置中有效，                   |                   |
|                              |          |          | 无法在 app.json 中设置                 |                   |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| disableSwipeBack             | boolean  | false    | 禁止页面右滑手势返回                   |                   |
|                              |          |          |                                        | 微信客户端 7.0.0  |
+------------------------------+----------+----------+----------------------------------------+-------------------+
| usingComponents              | Object   | 否       | 页面自定义组件配置                     | 1.6.3             |
+------------------------------+----------+----------+----------------------------------------+-------------------+

页面配置中只能设置 :file:`app.json` 中 :envvar:`window` 对应的配置项，
以决定本页面的窗口表现，所以无需写 :envvar:`window` 这个属性。

配置示例
------------

.. code::

  {
    "navigationBarBackgroundColor": "#ffffff",
    "navigationBarTextStyle": "black",
    "navigationBarTitleText": "微信接口功能演示",
    "backgroundColor": "#eeeeee",
    "backgroundTextStyle": "light"
  }