导航图

属性概述

属性详细信息

browserTouchPanEnabled Boolean

起始版本：GeoScene Maps SDK for JavaScript 4.14

指示是否启用或禁用单指触摸 drag 事件。当为 false 时，则无法在触摸设备上使用单指触摸手势平移地图。这将允许网页向下滚动，而无需在触摸设备上平移地图。在禁用单点触控平移和缩放时，仍然可以用两根手指平移、缩放和旋转（如果不受约束）地图。此属性不会影响基于鼠标的拖动。

默认值：true

示例

// Disable single touch panning in a MapView.
const view = new MapView({
  container: "viewDiv",
  map: new Map({
    basemap: "tianditu-vector"
  })
});
view.navigation.browserTouchPanEnabled = false;

declaredClass Stringreadonly inherited

类的名称。声明的类名称格式化为 geoscene.folder.className。

gamepad GamepadSettings

手柄导航特定的配置设置。

示例

// Disable the gamepad usage in MapView
const view = new MapView({
  container: "viewDiv",
  map: new Map({
    basemap: "satellite"
  }),
  center: [176.185, -37.643],
  zoom: 13,
  navigation: {
    gamepad: {
      enabled: false
    }
  }
});

// Disable gamepad usage in SceneView.
const view = new SceneView({
  container: "viewDiv",
  map: new Map({
    basemap: "satellite",
    ground: "world-elevation"
  }),
  camera: {
    position: [176.171, -37.660, 2000],
    heading: 0,
    tilt: 60
  },
  navigation: {
    gamepad: {
      enabled: false
    }
  }
});

momentumEnabled Boolean

起始版本：GeoScene Maps SDK for JavaScript 4.14

当为 true 时，视图将在指针 (例如鼠标、触控笔、手指) 抬起之后暂时继续平移。

默认值：true

示例

// Disable pan animation in the MapView.
const view = new MapView({
  container: "viewDiv",
  map: new Map({
    basemap: "tianditu-vector"
  })
});
view.navigation.momentumEnabled = false;

mouseWheelZoomEnabled Boolean

起始版本：GeoScene Maps SDK for JavaScript 4.14

指示是否可以使用鼠标滚轮放大或缩小视图。当地图占据屏幕的一部分时，页面导航有时可能会很困难，因为鼠标滚轮在地图上的移动可以解释为地图缩放而不是页面滚动。在某些情况下，将 mouseWheelZoomEnabled 设为false 可以使带有地图的可滚动网页更易于导航。

默认值：true

示例

// To disable mouse wheel zooming in a MapView.
const view = new MapView({
  container: "viewDiv",
  map: new Map({
    basemap: "tianditu-vector"
  })
});
view.navigation.mouseWheelZoomEnabled = false;

方法概述

方法详细说明

addHandles(handleOrHandles, groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

添加一个或多个与对象的生命周期相关联的句柄。当对象被销毁时，将移除句柄。

// Manually manage handles
const handle = reactiveUtils.when(
  () => !view.updating,
  () => {
    wkidSelect.disabled = false;
  },
  { once: true }
);

// Handle gets removed when the object is destroyed.
this.addHandles(handle);

参数

handleOrHandles WatchHandle|WatchHandle[] 对象销毁后，标记为要移除的句柄。

groupKey * optional 标识句柄应添加到的组的键。组中的所有句柄稍后都可使用 Accessor.removeHandles() 进行删除。如果未提供键，则句柄将被添加到默认组。

hasHandles(groupKey){Boolean}inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

如果存在指定的句柄组，则返回 true。

参数

groupKey * optional 组键。

返回

类型	描述
Boolean	如果存在指定的句柄组，则返回 true。

示例

// Remove a named group of handles if they exist.
if (obj.hasHandles("watch-view-updates")) {
  obj.removeHandles("watch-view-updates");
}

removeHandles(groupKey)inherited

起始版本：GeoScene Maps SDK for JavaScript 4.25

移除对象拥有的句柄组。

参数

groupKey * optional 要移除的组键或组键的数组或集合。

示例

obj.removeHandles(); // removes handles from default group

obj.removeHandles("handle-group");
obj.removeHandles("other-handle-group");