# fast-text 纯文本标记
纯文本标记，继承自 Marker，具有 Marker 的大部分属性、方法和事件
# 示例
# 属性
| 属性 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| mid | number / string | - | 地图实例的唯一 Text 组件通过 mid 获取对应的地图实例，然后将覆盖物渲染在对应的地图实例中。 |
| options | Array | - | 这里是对 Text 的扩展，该数组中存放 Text options 对象，当前对象的属性会覆盖通过 prop 传递的属性。若是 offset 数组是每个 text 实例独立的，应该与自定义数据放在该数组中。 |
| isItemOffset | boolean | false | 当 isItemIcon 为 true，将会为每一个 options 数组中的对象的 offset 属性创建一个 Pixel 实例，默认将复用组件传入的 offset 属性创建的 Pixel 实例。默认 false 共用 Pixel 实例。 |
| text | string | - | 标记显示的文本内容 |
| anchor | string | top-left | 设置点标记锚点。 默认值：'top-left' 可选值：'top-left', 'top-center', 'top-right', 'middle-left', 'center', 'middle-right', 'bottom-left', 'bottom-center', 'bottom-right' |
| offset | Array | - | Text 组件会获取 offset 属性去创建 Pixel。例如：[-10,-34] 会执行 new Pixel(-10,-34) 点标记显示位置偏移量，默认值为 Pixel(-10,-34)Text 指定 position 后，默认以 Text 左上角位为基准点（若设置了 anchor，则以 anchor 设置位置为基准点），对准所给定的 position 位置，若需使 Text 指定位置对准在 position 处，需根据 Text 的尺寸设置一定的偏移量。 |
| topWhenClick | boolean | false | 鼠标点击时是否置顶，默认false ，不置顶 |
| bubble | boolean | false | 是否将覆盖物的鼠标或touch等事件冒泡到地图上，默认值：false |
| draggable | boolean | false | 设置点标记是否可拖拽移动，默认为false |
| raiseOnDrag | boolean | false | 设置拖拽点标记时是否开启点标记离开地图的效果 |
| cursor | string | - | 指定鼠标悬停时的鼠标样式，自定义cursor，IE仅支持cur/ani/ico格式，Opera不支持自定义cursor |
| visible | boolean | true | 点标记是否可见，默认为true |
| zIndex | number | 100 | 点标记的叠加顺序。地图上存在多个点标记叠加时，通过该属性使级别较高的点标记在上层显示。默认zIndex：100 |
| angle | number | - | 点标记的旋转角度，广泛用于改变车辆行驶方向。注：angle属性是使用CSS3来实现的，支持IE9及以上版本 |
| autoRotation | boolean | false | 是否自动旋转。点标记在使用moveAlong动画时，路径方向若有变化，点标记是否自动调整角度，默认为false。广泛用于自动调节车辆行驶方向。IE8以下不支持旋转，autoRotation属性无效 |
| animation | string | AMAP_ANIMATION_NONE | 点标记的动画效果， 默认值：“AMAP_ANIMATION_NONE” 可选值： “AMAP_ANIMATION_NONE”，无动画效果 “AMAP_ANIMATION_DROP”，点标掉落效果 “AMAP_ANIMATION_BOUNCE”，点标弹跳效果 |
| shadow | Icon | - | 点标记阴影，不设置该属性则点标记无阴影 |
| title | string | - | 鼠标滑过点标记时的文字提示，不设置则鼠标滑过点标无文字提示 |
| clickable | boolean | false | 点标记是否可点击 |
| extData | any | - | 用户自定义属性，支持JavaScript API任意数据类型，如 Text 的id等，这里的数据可以放在 options 中 |
# 事件
| 事件 | 参数 | 说明 |
|---|---|---|
| click | MapsEvent | 鼠标左键单击事件 |
| dblclick | MapsEvent | 鼠标左键双击事件 |
| rightclick | MapsEvent | 鼠标右键单击事件 |
| mousemove | MapsEvent | 鼠标移动 |
| mouseover | MapsEvent | 鼠标移近点标记时触发事件 |
| mouseout | MapsEvent | 鼠标移出点标记时触发事件 |
| mousedown | MapsEvent | 鼠标在点标记上按下时触发事件 |
| mouseup | MapsEvent | 鼠标在点标记上按下后抬起时触发事件 |
| dragstart | MapsEvent | 开始拖拽点标记时触发事件 |
| dragging | MapsEvent | 鼠标拖拽移动点标记时触发事件 |
| dragend | MapsEvent | 点标记拖拽移动结束触发事件 |
| moving | Object | 点标记在执行 moveTo，moveAlong 动画时触发事件，Object 对象的格式是{passedPath:Array.<LngLat>}。 其中 passedPath 为 Text 对象在 moveAlong 或者 moveTo 过程中已经走过的路径。 |
| moveend | - | 点标记执行 moveTo 动画结束时触发事件，也可以由 moveAlong 方法触发 |
| movealong | - | 点标记执行 moveAlong 动画一次后触发事件 |
| touchstart | MapsEvent | 触摸开始时触发事件，仅适用移动设备 |
| touchmove | MapsEvent | 触摸移动进行中时触发事件，仅适用移动设备 |
| touchend | MapsEvent | 触摸结束时触发事件，仅适用移动设备 |
# 方法
TIP
通过 $refs 获取组件实例来调用。例如：this.$refs.myText.getAll()，关于 Polygon 类的实例方法，请查看官方文档 Polygon
| 方法 | 参数 | 返回值 | 说明 |
|---|---|---|---|
| getAMapPromise | - | Promise | 获取 AMap 类，返回一个 Promise 对象，在 reslove 中返回 AMap 类 |
| getAMapInstance | - | AMap | 获取 AMap 类，请在地图组件 complete 之后获取，否则返回值可能是 Null |
| getMapInstance | - 或 mid | map | 根据 mid 获取当前地图实例，默认会根据组件传入的 mid 属性获取 |
| hideAll | - | - | 隐藏当前组件所有的 text 实例 |
| showAll | - | - | 显示当前组件所有的 text 实例 |
| clearAll | - | - | 清空当前组件所有的 text 实例 |
| removeTexts | texts, propName | - | 删除传入的 text 实例数组，该方法不会导致 vue 重新渲染，propName 是每个 polygon 实例 options 中的唯一值，例如 id, key 它用来做查询优化，请保证每个实例 options 中的 propName 值都是唯一的，如果传入该参数将会大大优化性能。 |
| getAll | - | Array | 获取当前组件所有的 text 实例 |
| getInstanceByProp | propName, propValue | - | 根据传入的属性名称与值查找对应的 text 实例 |
| getAllInstanceByProp | propName, propValue | - | 根据传入的属性名称与值查找所有对应的 text 实例 |
| getInstanceByProps | propName, propValues | - | 根据传入的属性名称与值的数组查找对应的 text 实例数组，该方法对遍历做了优化，建议使用该方法获取 text 数组 |
| addTexts | options, isItemOffset, beforeCreate | - | options 是一个 texts 属性的数组，没有的属性会通过组件传递的属性获取。 isItemOffset 默认是 false, 当 isItemOffset 为 true 将会为 options 数组中每个对象的 offset 属性创建 Pixel 实例，默认 fals 共用组件传入的 offset 属性所创建的 Pixel 实例。 beforeCreate 是一个可选的回调函数，默认可以不传递，可在创建 text 之前调用，将 text 属性传入其中，可以通过该方法处理自定义渲染。新增的 text 数组会添加在组件中，此时 getAll 方法获取的数组中包含新增 text，该方法不会导致 vue 重新渲染 |