js标签配置


js标签配置

开发框架需要应用的config.json中配置相关的js标签,其中包含了实例名称、页面路由、视图窗口配置信息。

标签 类型 默认值 必填 描述
name string default 标识ETS实例的名字。
pages Array - 页面路由信息,详见pages说明。
window Object - 视图窗口配置信息,详见window说明。
mode Object - 配置Js Component运行类型与语法风格,详见mode说明。

pages

定义每个页面入口组件的路由信息,每个页面由页面路径和页面名组成,页面的文件名就是页面名。比如:

{
    "pages": [
        "pages/index",
        "pages/detail"
    ]
}
1
2
3
4
5
6

icon-note.gif 说明:

  • pages列表中第一个页面为应用的首页入口。

  • 页面文件名不能使用组件名称,比如:Text.ets、Button.ets等。

  • 每个页面文件中必须包含页面入口组件(@Entry装饰)。

window

window用于配置相关视图显示窗口,支持配置如下属性:

类型 默认值 说明
designWidth - 配置视图显示的逻辑宽度,缺省默认720(智能穿戴默认454)。视图显示的逻辑宽度决定了lpx像素单位大小,如designWidth配置720时,在视图宽度为1440物理像素时,1lpx为2物理像素。详见lpx像素单位说明。
{
  ...
  "window": {
    "designWidth": 720
  }
  ...
}
1
2
3
4
5
6
7

mode

mode用于配置JS Component的运行类型与语法风格,支持如下属性:

类型 默认值 说明
type - 配置该JS Component的运行类型,可选值为:
- pageAbility:以ability的方式运行该JS Component。
- form:以卡片的方式运行该JS Component。
syntax - 配置该JS Component的语法风格,可选值为:
- hml:以hml/css/js风格进行编写。
- ets:以声明式语法风格进行编写。

icon-note.gif 说明: 不支持同时配置type类型为form,syntax类型为ets。

示例

config.json:

{
    "app": {
        "bundleName": "com.example.player",
        "version": {
            "code": 1,
            "name": "1.0"
        },
        "vendor": "example"
    },
    "module": {
        "js": [{            
            "name": "default",            
            "pages": [                
                "pages/index",                
                "pages/detail"            
            ],            
            "window": {                
                "designWidth": 720            
            },            
            "mode": {                
                "type": "pageAbility",                
                "syntax": "ets"            
            },        
        }],
        "abilities": [{
            ... 
        }]
    }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29