# widget
所有 widgets 相同的配置可放在widget中defaultOptions,也可在widgets中为每个模块单独配置,具体可配置参数如下:
| 配置项 | 说明 |
|---|---|
| name | 必须,模块中文名称,用于标识和弹窗标题。兼容用 label 命名定义 |
| uri | 必须,模块 JS 文件路径,路径是相对于 widgets目录的路径 |
| id | 可选,定义该模块的唯一标识,用于外部调用传参 widget.activate('bookmark'); |
| windowOptions | 可选,存在弹窗的模块的弹窗相关参数配置,支持 layer 弹窗模块所有参数 |
| openAtStart | 可选,进入地图后是否自动启动本模块 |
| autoDisable | 可选,激活其他新模块时,是否自动释放本模块 |
| disableOhter | 可选,激活本模块时,是否释放其它已激活的模块 |
| style | 定义样式,默认为空,可定义 dark 为深色 |
| group | 可选,配置同名 group 后,同组下的 widget互斥,打开任意一个会自动释放其他的 |
| 其他 | 可选,定义的任意参数在 widget 内部方法中都可以通过 this.config获取到 |
示例如下:
"widgets": [
{
"name": "顶部菜单",
"id": "10",
"type": "group",
"children": [
{
"name": "坐标定位",
"autoDisable": false,
"disableOhter": false,
"uri": "widgets/centerXY/widget.js",
"style":"dark",
"openAtStart": true,
"windowOptions": {
"maxmin": false,
"width": "20%",
"skin": "layer-mars-dialog3",
"resize": true,
"position": {
"top": "10%",
"left": "1%"
},
"height": "30%"
}
},
{
"name": "统计分析",
"uri": "widgetsPlus/statistics/widget.js"
}
]
},
{
"disableOhter": false,
"name": "坐标定位",
"autoDisable": false,
"uri": "widgets/centerXY/widget.js"
}
]
# windowOptions
在有弹窗的情况下可以配置windowOptions参数,可以在模块业务代码widget.js中配置,也可以在config.json中配置,config.json配置优先级更高,会覆盖widget.js中配置。都没有配置的情况下会使用widget中defaultOptions配置。
| 配置项 | 说明 |
|---|---|
| skin | 窗口样式 |
| width | 窗口宽度 |
| height | 窗口高度 |
| position | 窗口所在位置坐标,可以配置字符串 t 顶部,b 底部,r 右边缘,l 左边缘,lt 左上角,lb 左下角,rt 右上角,rb 右下角;也可以 |
| maxmin | 是否显示最大小化按钮,默认 false |
| resize | 是否可以在弹层右下角拖动来拉伸尺寸。默认 true |
| shade | 遮罩,默认为 0 不显示,可配置数字 0.3 透明度的黑色背景('#000'),其他颜色,可以 shade: [0.8, '#393D49'] |
| shadeClose | 当 shade 是存在的,点击弹层外区域后是否关闭弹窗。 |
| closeBtn | 当为 0 时,不显示关闭按钮,配置 1 和 2 来展示两种风格的关闭按钮,默认 1 |
| noTitle | 是否不显示标题,为 true 是不显示标题 |
← 配置示例