目录

js标签配置

js标签用于配置实例名称、页面路由和窗口样式信息。

标签 类型 默认值 必填 描述
name string default 是 标识JS实例的名字。
pages Array - 是 路由信息,详见“pages”。
window Object - 否 窗口信息,详见“Window”。

name、pages和window等标签配置需在配置文件(config.json)中的“js”标签中完成设置。

pages

定义每个页面的路由信息,每个页面由页面路径和页面名组成,页面的文件名即为页面名,例如:

{
    // ...
    "pages": [
        "pages/index/index",
        "pages/detail/detail"
    ]
    // ...
}
  • pages列表中第一个页面是应用的首页,即entry入口。

  • 页面文件名不能使用组件名称,比如:text.hml、button.hml等。

window

window用于定义与显示窗口相关的配置。屏幕适配问题可通过以下两种方式配置:

属性 类型 必填 缺省值 描述
designWidth number 否

720

页面显示设计时的参考值,实际显示效果基于设备宽度与参考值之间的比例进行缩放。
autoDesignWidth boolean 否 false

页面设计基准宽度是否自动计算。

true表示页面设计基准宽度自动计算,false表示页面设计基准宽度不自动计算。

当设为true时,designWidth将会被忽略,设计基准宽度由设备宽度与屏幕密度计算得出。

示例如下:

{
    // ...
    "window": {
        "designWidth": 720,
        "autoDesignWidth": false
    }
    // ...
}

示例

{
  "app": {
    "bundleName": "com.example.player",
    "version": {
        "code": 1,
        "name": "1.0"
    },
    "vendor": "example"
  },
  "module": {
      // ...
      "js": [
      {
          "name": "default",
          "pages": [
              "pages/index/index",
              "pages/detail/detail"
          ],
          "window": {
              "designWidth": 720,
              "autoDesignWidth": false
          }
      }
      ],
      "abilities": [
      {
          // ...
      }
    ]
  }
}