小组件根目录下的
属性 | 类型 | 必填 | 描述 |
|---|---|---|---|
| pages | string | 是 | 页面路径列表 |
| window | Object | 否 | 全局的默认窗口表现 |
| networkTimeout | Object | 否 | 网络超时时间 |
| permission | Object | 否 | 小组件接口权限相关设置 |
| usingComponents | Object | 否 | 全局自定义组件配置 |
用于指定小组件由哪些页面组成，每一项都对应一个页面的 路径（含文件名） 信息。文件名不需要写文件后缀，框架会自动去寻找对应位置的
由于小组件只支持一个页面，数组的第一项代表小组件的唯一可用页面。
目录示例：
├── app.js ├── app.json ├── app.css ├── pages │ │── index │ ├── index.xhsml │ ├── index.js │ ├── index.json │ └── index.css │ └── utils
用于设置小组件的状态栏、导航条、标题、窗口背景色。
属性 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| navigationBarBackgroundColor | HexColor | #000000 | 导航栏背景颜色，如 #000000 |
| navigationBarTextStyle | string | white | 导航栏标题颜色，仅支持 black / white |
| navigationBarTitleText | string | 导航栏标题文字内容 | |
| navigationStyle | string | default | 导航栏样式，仅支持以下值： default 默认样式 custom 自定义导航栏，只保留右上角胶囊按钮。 |
| backgroundColor | HexColor | #ffffff | 窗口的背景色 |
| enablePullDownRefresh | boolean | false | 是否开启全局的下拉刷新。 |
| onReachBottomDistance | number | 50 | 页面上拉触底事件触发时距页面底部距离，单位为 px |
如：
{
"window": {
"navigationBarBackgroundColor": "#ffffff",
"navigationBarTextStyle": "black",
"navigationBarTitleText": "导航title",
"backgroundColor": "#eeeeee",
"backgroundTextStyle": "light"
}
}
各类网络请求的超时时间，单位均为毫秒。
属性 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| request | number | 否 | 60000 | xhs.request 的超时时间，单位：毫秒。 |
| connectSocket | number | 否 | 60000 | xhs.connectSocket 的超时时间，单位：毫秒。 |
| uploadFile | number | 否 | 60000 | xhs.uploadFile 的超时时间，单位：毫秒。 |
| downloadFile | number | 否 | 60000 | xhs.downloadFile 的超时时间，单位：毫秒。 |
小组件接口权限相关设置。字段类型为 Object，结构为：
属性 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| scope.userLocation | PermissionObject | 否 | 位置相关权限声明 |
属性 | 类型 | 必填 | 默认值 | 描述 |
|---|---|---|---|---|
| desc | string | 是 | 小组件获取权限时展示的接口用途说明。最长 30 个字符 |
如：
{
"pages": ["pages/index/index"],
"permission": {
"scope.userLocation": {
"desc": "你的位置信息将用于小组件位置接口的效果展示" // 高速公路行驶持续后台定位
}
}
}
在此处声明的自定义组件视为全局自定义组件，在小组件内的页面或自定义组件中可以直接使用而无需再声明。