# widget

所有 widgets 相同的配置可放在widgetdefaultOptions,也可在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中配置。都没有配置的情况下会使用widgetdefaultOptions配置。

配置项 说明
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 是不显示标题
Last Updated: 6/24/2024, 3:05:32 PM