Circle

new mars2d.graphic.Circle(options)

圆 矢量对象

参数名称 类型 描述信息
options Object

参数对象,包括以下:

参数名称 类型 默认值 描述信息
latlng L.LatLng | Array.<Number>

坐标位置

style Circle.StyleOptions 可选

样式参数

attr Object 可选

属性信息

hasEdit Boolean true 可选

是否可以编辑

isAutoEditing Boolean false 可选

是否构造后就自动启动编辑(需要hasEdit:true时)

popup String | HTMLElement | function 可选

绑定的popup弹窗值,也可以bindPopup方法绑定

popupOptions Map.PopupOptions 可选

popup弹窗时的配置参数

tooltip String | Array | function 可选

绑定的tooltip弹窗值,也可以bindTooltip方法绑

tooltipOptions Map.TooltipOptions 可选

tooltip弹窗时的配置参数

id String | Number 可选

矢量数据id标识

参考:

继承

  • L.Circle

成员(属性)

readonly area : Number

面积(单位:平方米)

attr : Object

属性信息

readonly center : L.LatLng

中心点

coordinates : Array.<Array>

获取或设置 经度、纬度位置坐标(数组对象),示例 [ [123.123456,32.654321] ]

readonly distance : Number

周长距离(单位:米)

id : String|Number

对象的id标识

readonly isAdded : Boolean

是否已添加到地图

readonly isSector : Boolean

是否为扇形

latlng : L.LatLng

坐标位置

latlngs : Array.<L.LatLng>

坐标位置数组 , 主要为了兼容线面数据的使用(比如标绘中)

readonly outlineLatlngs : Array.<L.LatLng>

矩形的边线坐标集合

radius : Number

半径, 单位:米

rotation : Number

方向,角度值

show : Boolean

显示隐藏状态

startAngle : Number

开始角度

stopAngle : Number

结束角度

style : Object

样式信息

方法

addEventParent(obj)Circle

添加抛出事件到父类,它将接收传播的事件

参数名称 类型 描述信息
obj Object

父类对象

返回值:

当前对象本身,可以链式调用

addTo(map)Circle

将图层添加到地图

参数名称 类型 描述信息
map Map

地图对象

返回值:

当前对象本身,可以链式调用

bindContextMenu(contextmenuItems)Map

绑定右键菜单

参数名称 类型 描述信息
contextmenuItems Array.<Object>

右键菜单数组

返回值:

当前对象本身,可以链式调用

bindPopup(content, options)Circle

绑定Popup弹窗配置

参数名称 类型 描述信息
content String | HTMLElement | function | L.Popup

Popup弹窗内容

options Map.PopupOptions | Object 可选

Popup弹窗参数

返回值:

当前对象本身,可以链式调用

bindTooltip(content, options)Circle

绑定Tooltip弹窗配置

参数名称 类型 描述信息
content String | HTMLElement | function | L.Tooltip

Tooltip弹窗内容

options Map.TooltipOptions | Object 可选

Tooltip弹窗参数

返回值:

当前对象本身,可以链式调用

bringToBack()Circle

将圆移动到所有路径层的底部

返回值:

当前对象本身,可以链式调用

bringToFront()Circle

将圆移动到所有路径层的顶部

返回值:

当前对象本身,可以链式调用

closePopup()Circle

关闭打开的弹窗

返回值:

当前对象本身,可以链式调用

closeTooltip()Circle

关闭打开的弹窗

返回值:

当前对象本身,可以链式调用

destroy()void

销毁矢量对象

返回值:

fire(type, data, propagate)void

触发指定类型的事件。

参数名称 类型 默认值 描述信息
type String | EventType

事件类型

data Object 可选

传输的数据或对象,可在事件回调方法中event对象中获取进行使用

propagate BaseClass | Object null 可选

将事件传播给父类 (用addEventParent设置)

返回值:

getBounds()L.LatLngBounds

获取圆的矩形边界

返回值:

矩形边界

getContextMenu()Array.<Object>

获取绑定的右键菜单

返回值:

右键菜单数组

getLatLng()L.LatLng

返回圆的中心位置

返回值:

经纬度对象

getOutlineLatlngs(closure, count)Array.<L.LatLng>

获取圆的边线坐标集合

参数名称 类型 默认值 描述信息
closure Boolean true 可选

是否闭合,true时会添加第0个点进行闭合。

count Number 可选

点的数量

返回值:

边线坐标数组

getPopup()L.Popup

获取当前绑定在图层上的Popup弹窗对象

返回值:

Popup弹窗对象

getRadius()Number

返回半径值

返回值:

半径值

getTooltip()L.Tooltip

获取当前绑定在图层上的Tooltip弹窗对象

返回值:

Tooltip弹窗对象

isInPoly(latlng)Boolean

判断指定坐标是否在当前圆内

参数名称 类型 描述信息
latlng L.LatLng

坐标

返回值:

是否在圆内

isPopupOpen()boolean

当前绑定的弹窗是是否打开

返回值:

是否打开弹窗

isTooltipOpen()boolean

当前绑定的弹窗是是否打开

返回值:

是否打开弹窗

listens(type, propagate)Boolean

是否有绑定指定的事件

参数名称 类型 描述信息
type String | EventType

事件类型

propagate Object 可选

是否判断指定的父类 (用addEventParent设置的)

返回值:

是否存在

off(types, fn, context)void

解除绑定指定类型事件监听器

参数名称 类型 描述信息
types String | EventType | Object 可选

事件类型,Object时删除一组类型/侦听器对。

fn function 可选

绑定的监听器回调方法

context Object 可选

侦听器的上下文(this关键字将指向的对象)。

返回值:

on(type, fn, context)void

绑定指定类型事件监听器

参数名称 类型 描述信息
type String | EventType | Object

事件类型,当是Object时可以添加一组类型/侦听器对,例如 {click: onClick, mousemove: onMouseMove}

fn function 可选

绑定的监听器回调方法

context Object 可选

侦听器的上下文(this关键字将指向的对象)。

返回值:

once(types, fn, context)void

绑定一次性执行的指定类型事件监听器 与on类似,监听器只会被触发一次,然后被删除。

参数名称 类型 描述信息
types String | EventType | Object 可选

事件类型,Object时删除一组类型/侦听器对。

fn function 可选

绑定的监听器回调方法

context Object 可选

侦听器的上下文(this关键字将指向的对象)。

返回值:

openPopup(latlng)Circle

打开Popup弹窗

参数名称 类型 描述信息
latlng L.LatLng 可选

位置,如果latlng没有设置则在默认的所在位置打开。

返回值:

当前对象本身,可以链式调用

openTooltip(latlng)Circle

打开Tooltip弹窗

参数名称 类型 描述信息
latlng L.LatLng 可选

位置,如果latlng没有设置则在默认的所在位置打开。

返回值:

当前对象本身,可以链式调用

redraw()Circle

重新绘制。在更改路径所使用的坐标之后会很有用。

返回值:

当前对象本身,可以链式调用

remove()Circle

将图层从地图上移除

返回值:

当前对象本身,可以链式调用

removeEventParent(obj)Circle

移除抛出事件到父类

参数名称 类型 描述信息
obj Object

父类对象

返回值:

当前对象本身,可以链式调用

setLatLng(latlng)Circle

修改中心位置

参数名称 类型 描述信息
latlng L.LatLng

经纬度对象

返回值:

当前对象本身,可以链式调用

setPopupContent(content)Circle

设定绑定在图层上的弹窗的内容

参数名称 类型 描述信息
content String | HTMLElement | L.Popup

Popup弹窗内容

返回值:

当前对象本身,可以链式调用

setRadius(radius)Circle

修改半径值

参数名称 类型 描述信息
radius Number

半径值

返回值:

当前对象本身,可以链式调用

setStyle(newStyle)Circle

设置 样式信息 的钩子方法

参数名称 类型 描述信息
newStyle Object

本次更新的部分样式信息,内部会合并属性

返回值:

当前对象本身,可以链式调用

setTooltipContent(content)Circle

设定绑定在图层上的弹窗的内容

参数名称 类型 描述信息
content String | HTMLElement | L.Tooltip

Tooltip弹窗内容

返回值:

当前对象本身,可以链式调用

toGeoJSON(options)Object

将图层数据导出为GeoJSON格式规范对象。

参数名称 类型 描述信息
options Object 可选

参数对象:

参数名称 类型 描述信息
precision Number 可选

保留经纬度的小数位数

返回值:

GeoJSON格式规范对象

toJSON()Object

将矢量数据的坐标、样式及属性等信息导出为对象,可以用于存储。

返回值:

导出的坐标、样式及属性等信息

unbindContextMenu()Map

解除绑定右键菜单

返回值:

当前对象本身,可以链式调用

unbindPopup()Circle

解除绑定Popup弹窗配置

返回值:

当前对象本身,可以链式调用

unbindTooltip()Circle

解除绑定Tooltip弹窗配置

返回值:

当前对象本身,可以链式调用

定义的类型

mars2d.graphic.Circle.EventType

当前类支持的EventType事件类型(包括自定义字符串事件名)

  • @property {String} add 在矢量数据添加到图层(或地图)上之后触发
属性:
属性名称 类型 描述信息
remove String

在矢量数据从图层(或地图)上移除之后触发

click String

当用户单击(or taps)地图时触发

dblclick String

当用户双击(or double-taps)地图时触发

mousedown String

当用户在图层上按下鼠标按钮时触发

mouseover String

当鼠标进入图层时触发

mouseout String

当鼠标离开图层时触发

popupopen String

当绑定到当前图层的Popup弹窗打开时触发

popupclose String

当绑定到当前图层的Popup弹窗关闭时触发

tooltipopen String

当Tooltip提示框绑定到这个图层并打开时触发

tooltipclose String

当Tooltip提示框绑定到这个图层并关闭时触发

使用示例:
//绑定监听事件
graphic.on('click', function (event) {
  console.log('触发了事件',event)
});
参考:

mars2d.graphic.Circle.StyleOptions

圆矢量对象 支持的样式信息

属性:
属性名称 类型 可选 默认值 描述信息
radius Number

圆的半径,以米为单位。

rotation Number <可选>
0

方向,单位:角度值

startAngle Number <可选>
0

当为扇形时的开始角度值

stopAngle Number <可选>
360

当为扇形时的结束角度值

fill Boolean <可选>
true

是否填充

fillColor string <可选>
'#3388ff'

填充颜色

fillOpacity Number <可选>
1.0

填充透明度,取值范围:0.0-1.0

image string <可选>

填充的图片的url

imageOpacity Number <可选>
1.0

填充图片的透明度

fillRule string <可选>
'evenodd'

用于定义填充形状

outline Boolean <可选>
true

是否边框

outlineColor string <可选>
'#3388ff'

边框颜色

outlineOpacity Number <可选>
1.0

边框透明度,取值范围:0.0-1.0

outlineWidth Number <可选>
2

边框宽度

lineCap String <可选>
'round'

边框中,线两段使用的形状, 如: butt、round、square

lineJoin String <可选>
'round'

边框中,线转折处使用的形状, 如: miter、round、bevel

dashArray string <可选>

边框中,定义虚线线型,用于定义笔划模式,如:"5, 10" 、 "5, 5, 1, 5"

dashOffset String <可选>

边框中,指定了dash模式到路径开始的距离,如果使用了一个百分比值,那么这个值就代表了当前viewport的一个百分比,值可以取为负值。

smoothFactor Number <可选>
1.0

边框中,数值的大小可以简化每个缩放级别的折线。更多的意味着更好的性能和更平滑的外观,而更少的意味着更准确的表示。

noClip Boolean <可选>
false

边框中,禁用折线裁剪

interactive Boolean <可选>
true

是否触发鼠标事件,如果false,该层不会发出鼠标事件,并且将作为底层地图的一部分。

renderer L.Renderer <可选>

使用的Renderer 特定实例。优先于地图的默认渲染器。

highlight Circle.StyleOptions <可选>

【预留功能,待后续版本开发】鼠标移入或单击(type:'click')后的对应高亮的部分样式,创建Graphic后也可以openHighlight、closeHighlight方法来手动调用

label Label.StyleOptions <可选>

支持附带文字的显示