Leaflet API 翻译(一)

时间:2021-07-06 20:53:21

  API各种类中的核心部分,用来在页面中创建地图并操纵地图。

Constructor(构造器)

  通过div元素和带有地图选项的描述的文字对象来实例化一个地图对象,其中文字对象是可选的。

Options(选项)

Map State Options(地图状态选项)

centre(中心):初始化地图的地理中心。

zoom(缩放):初始化地图的缩放。

layers(图层):初始化后加载到地图上的图层。

minZoom(最小视图):地图的最小视图。可以重写地图图层的最小视图。

maxZoom(最大视图):地图的最大视图。可以重写地图图层的最大视图。

maxBounds(最大边界):当这个选项被设置后,地图被限制在给定的地理边界内,当用户平移将地图拖动到视图以外的范围时会出现弹回的效果,并且也不允许缩小视图到给定范围以外的区域(这取决于地图的尺寸)。使用setMaxBounds方法可以动态地设置这种约束。

crs(坐标参考系统):使用的坐标系,当你不确定坐标系是什么时请不要更改。

Interaction Options(交互操作)

dragging(拖动):决定地图是否可被鼠标或触摸拖动。

touchZoom(触摸缩放):决定地图是否可被两只手指触摸拖拽缩放。

scrollWheelZoom(滚轮缩放):决定地图是否被被鼠标滚轮滚动缩放。

doubleClickZoom(双击缩放):决定地图是否可被双击缩放。

boxZoom(多边形缩放):决定地图是否可被缩放到鼠标拖拽出的矩形的视图,鼠标拖拽时需要同时按住shift键。

trackResize(追踪尺寸改变):确定地图在窗口尺寸改变时是否可以自动处理浏览器以更新视图。

worldCopyJump(领域副本跳转):当这个选项可用时,当你平移地图到其另一个领域时会被地图捕获到,并无缝地跳转到原始的领域以保证所有标注、矢量图层之类的覆盖物仍然可见。

closePopupOnClick(点击关闭消息弹出框):当你不想用户点击地图关闭消息弹出框时,请将其设置为false。

Keyboard Navigation Options(键盘操纵选项)

keyboard(键盘):聚焦到地图且允许用户通过键盘的方向键和加减键来漫游地图。

keyboardPanOffset(键盘平移补偿):确定按键盘方向键时地图平移的像素。

keyboardZoomOffset(键盘缩放补偿):确定键盘加减键对于的缩放级数。

Panning Inertia Options(平移惯性选项)

inertia(惯性):如果该选项可用,在拖动和在某一时间段内持续朝同一方向移动建有动力的地图时,会有惯性的效果。

inertiaDeceleration(惯性减速):确定惯性移动减速的速率,单位是像素每秒的二次方。

inertiaMaxSpeed(惯性最大速度):惯性移动的最大速度,单位是像素每秒。

inertiaThreshold(惯性阈值):放开鼠标或是触摸来停止惯性移动与移动停止之间的毫秒数。

Control options(控制选项)

zoomControl(缩放控制):确定缩放控制是否默认加载在地图上。

attributionControl(属性控制):确定属性控制是否默认加载在地图上。

Animation options(动画选项)

fadeAnimation(淡出动画):确定瓦片淡出动画是否可用。通常默认在所有浏览器中都支持CSS3转场,android例外。

zoomAnimation(缩放动画):确定瓦片缩放动画是否可用。通常默认在所有浏览器中都支持CSS3转场,android例外。

markerZoomAnimation(注记缩放动画):确定注记的缩放是否随地图缩放动画而播放,如果被禁用,注记在动画中拉长时会消失。通常默认在所有浏览器中都支持CSS3转场,android例外。

Events(事件)

click(点击):用户点击或触摸地图时触发。

dbclick(双击):用户双击或连续两次触摸地图时触发。

mousedown(鼠标按下):用户按下鼠标按键时触发。

mouseup(鼠标抬起):用户按下鼠标按键时触发。

mouseover(鼠标经过):鼠标进入地图时触发。

mouseout(鼠标移出):鼠标离开地图时触发。

mousemove(鼠标移动):鼠标在地图上移动时触发。

contextmenu(情景菜单):当用户在地图上按下鼠标右键时触发,如果有监听器在监听这个时间,则浏览器默认的情景菜单被禁用。

focus(聚焦):当用户在地图上进行标引、点击或移动时进行聚焦。

blur(变暗):当地图失去焦点时触发。

preclick(预先点击):当鼠标在地图上点击之前触发。有时会在点击鼠标时,并在已存在的点击事件开始处理之前想要某件事情发生时用得到。

load(载入):当地图初始化时触发。(当地图的中心点和缩放初次设置时)

viewreset(视图重置):当地图需要重绘内容时触发。(通常在地图缩放和载入时发生)这对于创建用户自定义的叠置图层非常有用。

movestart(移动开始):地图视图开始改变时触发。(比如用户开始拖动地图)

move(移动):所有的地图视图移动时触发。

moveend(移动结束):当地图视图结束改变时触发。(比如用户停止拖动地图)

dragstart(拖动开始):用户开始拖动地图时触发。

drag(拖动):用户拖动地图时不断重复地触发。

dragend(拖动结束):用户停止拖动时触发。

zoomstart(缩放开始):当地图缩放即将发生时触发。(比如缩放动作开始前)

zoomend(缩放结束):当地图缩放时触发。

autopanstart(自动平移开始):打开弹出窗口时地图开始自动平移时触发。

layeradd(添加图层):当一个新的图层添加到地图上时触发。

layerremove(图层移除):当一些图层从地图上移除时触发。

baselayerchange(基础图层改变):当通过图层控制台改变基础图层时触发。

locationfound(位置查找):当地理寻址成功时触发(使用locate方法)。

locationerror(定位错误):当地理寻址错误时触发(使用locate方法)。

popupopen(打开弹出框):当弹出框打开时触发(使用openPopup方法)。

popupclose(关闭弹出框):当弹出框关闭时触发(使用closePopup方法)。

 

Methods for Modifying Map State(地图状态修改)