Zoom 缩放
用于控制地图放大和缩小的控件,并且当地图达到最大或最小缩放比时,会禁用对应缩放按钮。
使用
import { Scene, Zoom } from '@antv/l7';
const scene = new Scene({
//...
});
scene.on('loaded', () => {
const zoom = new Zoom({
zoomInTitle: '放大',
zoomOutTitle: '缩小',
});
scene.addControl(zoom);
});
配置
| 名称 | 说明 | 类型 |
|---|---|---|
| zoomInText | 放大按钮的展示内容 | Element | string |
| zoomInTitle | 放大按钮的 title 属性 |
string |
| zoomOutText | 缩小按钮的展示内容 | Element | string |
| zoomOutTitle | 缩小按钮的 title 属性 |
string |
| showZoom | 是否展示地图当前实时 zoom 数值,默认向下取整 | boolean |
| 名称 | 说明 | 类型 |
|---|---|---|
| position | 控件被添加到地图中的位置以及排列方式,详情可见 控件插槽 | Position |
| className | 自定义样式名 | string |
| style | 自定义样式 | string |
Position
export type Position =
| 'topleft' // ↖ 左上角,纵向排列
| 'lefttop' // ↖ 左上角,横向排列
| 'topright' // ↗ 右上角,纵向排列
| 'righttop' // ↗ 右上角,横向排列
| 'bottomleft' // ↙ 左下角,纵向排列
| 'leftbottom' // ↙ 左下角,横向排列
| 'bottomright' // ↘ 右下角,纵向排列
| 'rightbottom' // ↘ 右下角,横向排列
| 'topcenter' // ↑ 上方中央,横向排列
| 'bottomcenter' // ↓ 下方中间,横向排列
| 'leftcenter' // ← 左边中间,纵向排列
| 'rightcenter' // → 右边中间,纵向排列
| Element; // 传入 DOM 作为当前控件的容器
方法
| 名称 | 说明 | 类型 |
|---|---|---|
| zoomIn | 放大地图 | () => void |
| zoomOut | 缩小底图 | () => void |
| 名称 | 说明 | 类型 |
|---|---|---|
| setOptions | 更新配置,参数需要参考对应组件的配置 | (newOption: Partial<Option>) => void |
| getOptions | 获取当前配置 | () => Option |
| show | 显示组件 | () => void |
| hide | 隐藏组件 | () => void |
| getContainer | 获取当前控件对应的 DOM 容器 |
() => HTMLElement |
事件
| 名称 | 说明 | 类型 |
|---|---|---|
| add | 组件被添加时的事件 | (this) => void |
| remove | 组件被移除时的事件 | (this) => void |
| show | 组件显示时的事件 | (this) => void |
| hide | 组件隐藏时的事件 | (this) => void |