Path
概述
一个抽象类,包含选项和常量,用于多边形、折线、圆的绘制,不能直接使用
选项（Options）
选项:
| 选项 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| stroke | Boolean | TRUE | 路径是否描边,设置为false时,多边形和圆的边界将不可见 |
| color | String | '#03f' | 描边颜色, |
| weight | Number | 5 | 描边的像素级别的宽度, |
| opacity | Number | 0.5 | 描边透明度, |
| fill | Boolean | depends | 路径是否填充颜色,设置为false时,多边形和圆的填充内容不可见, |
| fillColor | String | same as color | 填充颜色, |
| fillOpacity | Number | 0.2 | 填充透明度, |
| fillRule | String | 'evenodd' | 标识了用来确定路径的哪一侧算是形状内部的算法 |
| dashArray | String | null | 定义了虚线的路径 |
| lineCap | String | null | 定义了路径结尾的的形状 |
| lineJoin | String | null | 定义了路径边角的形状 |
| clickable | Boolean | TRUE | 如果为false,将会不发出鼠标事件,仅像地图的底层一样响应 |
| pointerEvents | String | null | 如果SVG需要,此项用作设置pointer事件的路径属性 |
| className | String | '' | 设置classname |
事件（Events）使用地图核心类中Event提供的方法与属性
事件:
| 事件 | 类型（Data） | 描述 |
|---|---|---|
| click | MouseEvent | 用户点击或点触对象时触发 |
| dblclick | MouseEvent | 用户双击或连续两次点触对象时触发 |
| mousedown | MouseEvent | 当用户在对象上按下鼠标时触发 |
| mouseover | MouseEvent | 当鼠标置于对象上方时触发 |
| mouseout | MouseEvent | 当鼠标离开对象时触发 |
| contextmenu | MouseEvent | 当用户在对象上点击鼠标右键时触发,当此事件被监听时,会阻止弹出浏览器本身的右键菜单 |
| add | Event | 当路径被添加在地图上时触发 |
| remove | Event | 当路径在地图上移除时触发 |
| popupopen | PopupEvent | 当路径上的popup被打开时触发 |
| popupclose | PopupEvent | 当路径上的popup被关闭时触发 |
方法（Methods）
方法:
| 方法 | 参数 | 返回值 | 描述 |
|---|---|---|---|
| addTo() | <Map> map | this | 将图层加到地图上 |
| bindPopup() | html | el | popup, options? | this | 将具有特定HTML内容的弹出框与点击路径绑定起来 |
| bindPopup() | <Popup> popup,<Popup options> options? | this | 将传入的popup与指定路径绑定起来 |
| unbindPopup() | 无 | this | 将之前的弹出框绑定解除 |
| openPopup() | <LatLng> latlng? | this | 打开之前通过bindPopup方法与路径上指定点或未指定情况下某一点绑定的弹出框 |
| closePopup() | 无 | this | 如果指定路径上绑定的popup是打开的,则关闭 |
| setStyle() | <Path options> object | this | 在传入的options基础上改变Path的外观 |
| getBounds() | 无 | LatLngBounds | 返回路径的经纬度绑定信息 |
| bringToFront() | 无 | this | 将此层移至所以路径层的最上层 |
| bringToBack() | 无 | this | 将此层移至所以路径层的最底层 |
| redraw() | 无 | this | 重绘图层,在更改了路径的坐标时比较有用 |
静态属性（Static properties）
静态属性:
| 常量 | 类型 | 默认值 | 描述 |
|---|---|---|---|
| SVG | Boolean | depends | 如果true,SVG用于矢量渲染（适用于大部分现代浏览器） |
| VML | Boolean | depends | 如果true,VML用于矢量渲染（适用IE 6-8） |
| CANVAS | Boolean | depends | 如果为true,canvas用于矢量渲染(Android 2).,也可以在地图加载前,将这个强制设置全局变量L_PREFER_CANVAS 为true,这样当渲染数以千计的 circle markers时可以显著的提高性能,但是现在还存在移除这个层效率低这样一个bug |
| CLIP_PADDING | Number | 0.5 for SVG<br>0.02 for VML | 设置视图上剪切区域的大小（0.5是屏幕一个方向上的一半）,小数值意味着拖动地图时path的末端不会显示,大数值意味着降低绘制性能 |