简单标注 最后更新时间: 2021年01月22日
SimpleMarker(简单标注)继承自AMap.Marker,在已有功能的基础上,额外增加如下的支持:
- 支持设置背景图标(
iconTheme
,iconStyle
)和前景文字(iconLabel
);背景图标内置若干样式可供挑选(如上方示例),也支持自定义图片地址或者Dom结构。 - 支持显示定位点,默认用红点标识(查看示例),红点的中心即是经纬度(即position)对应的位置。用于开发阶段,辅助开发者设置Marker图标相对于经纬度的显示偏移量。(即Marker的offset参数)
如何使用
1、引入UI组件库
2、加载 SimpleMarker(模块名:ui/overlay/SimpleMarker
):
//引入SimpleMarker,loadUI的路径参数为模块名中 'ui/' 之后的部分
AMapUI.loadUI(['overlay/SimpleMarker'], function(SimpleMarker) {
//启动页面
initPage(SimpleMarker);
});
function initPage(SimpleMarker) {
//创建SimpleMarker实例
new SimpleMarker({
//前景文字
iconLabel: 'A',
//图标主题
iconTheme: 'default',
//背景图标样式
iconStyle: 'red',
//...其他Marker选项...,不包括content
map: map,
position: [116.405285, 39.904989]
});
//创建SimpleMarker实例
new SimpleMarker({
//前景文字
iconLabel: {
innerHTML: '<i>B</i>', //设置文字内容
style: {
color: '#fff' //设置文字颜色
}
},
//图标主题
iconTheme: 'fresh',
//背景图标样式
iconStyle: 'black',
//...其他Marker选项...,不包括content
map: map,
position: [116.305285, 39.904989]
});
}
接口文档
构造参数(父类)
参数名称 | 类型 | 说明 |
---|---|---|
|
| 样式主题,目前包括 每个主题下内置一组特定的 |
|
| 背景图标样式, 可以有如下取值: 1. String,内置的样式名,取值可通过 2. String,html代码,需要以 3. String,图片的url地址。通常还需要配合设置offset选项(定位点的偏移量,以确定该图片的定位点)。 4. HTMLElement, 某个dom节点的引用,比如:
5. Object,img节点的属性值,比如 { src: '图片地址', style: { width:'20px' } } |
|
| 图标前景文字,可以有如下取值: 1. String, 普通文本,比如'A'(可以配合 2. Object, 内建的文字容器dom节点(DIV)的属性值,比如 { innerHTML: '<div>B</div>', style: { color:'red'//设置文字颜色 } } |
|
| 是否显示定位点,可以有如下取值: 1. boolean, 是否显示,默认false;通常在仅在开发阶段开启,辅助设置图标相对于经纬度位置(定位点)的偏移量(即Marker的offset参数) 2. Object{color:String, radius:number} , 显示特定颜色和半径的定位点,比如: { color: 'red',//点的颜色 radius: 3 //点的半径。 因圆形使用了CSS3的border-radius属性,IE8及以下浏览器会呈现正方形 } |
|
| 内建的Dom容器上附带的class,多个class name用空格分开,比如: new SimpleMarker({ //添加自定义的class containerClassNames: 'my_color', //....其他参数.... })
![]() 开发者可以借此编写CSS控制特定Marker的样式,比如更换内建的iconStyle样式的背景图标(采用与颜色名一致的纯色),示例;再比如配置iconLabel的样式,示例 |
禁用的MarkerOptions
参数名称 | 禁用原因 |
---|---|
| SimpleMarker内部利用了该参数 |
方法(父类)
方法名称 | 返回值 | 说明 |
---|---|---|
| 设置背景图标样式, iconStyle取值见构造参数 | |
| 设置图标主题以及图标样式 | |
| 设置图标前景文字, iconLabel取值见构造参数 | |
| 设置Marker的Dom容器上附带的class | |
| 显示定位点 | |
| 隐藏定位点 |