Navigation

AMD: require(["geoscene/views/navigation/Navigation"], (Navigation) => { /* 代码 */ });
ESM: import Navigation from "@geoscene/core/views/navigation/Navigation";
类: geoscene/views/navigation/Navigation
继承于: Navigation Accessor
起始版本: GeoScene API for JavaScript 4.22

视图上的导航相关配置设置。

属性列表

可以设置、检索或监听的属性。参见 使用属性
展示继承属性 隐藏继承属性
属性 类型 描述
Boolean更多信息

是否启用或禁用单指触摸 拖动 事件。

更多信息Navigation
String更多信息

类名。

更多信息Accessor
GamepadSettings更多信息

游戏板导航特定的配置设置。

更多信息Navigation
Boolean更多信息

当设为 true时,视图将在指针之后暂时继续平移。

更多信息Navigation
Boolean更多信息

是否可以使用鼠标滚轮放大或缩小视图。

更多信息Navigation

属性详细说明

browserTouchPanEnabled Boolean
起始版本: GeoScene API for JavaScript 4.22

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

默认值:true
示例代码:
// 在 MapView 中禁用单点触摸平移。
const view = new MapView({
  container: "viewDiv",
  map: new Map({
    basemap: "geoscene-community"
  })
});
view.navigation.browserTouchPanEnabled = false;
declaredClass Stringreadonly inherited

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

gamepad GamepadSettings

gamepad 导航特定的配置设置。

示例代码:
// 在 MapView 中禁用游戏手柄
const view = new MapView({
  container: "viewDiv",
  map: new Map({
    basemap: "geoscene-community"
  }),
  center: [176.185, -37.643],
  zoom: 13,
  navigation: {
    gamepad: {
      enabled: false
    }
  }
});

// 在 SceneView 中禁用游戏手柄。
const view = new SceneView({
  container: "viewDiv",
  map: new Map({
    basemap: "geoscene-community",
    ground: "world-elevation"
  }),
  camera: {
    position: [176.171, -37.660, 2000],
    heading: 0,
    tilt: 60
  },
  navigation: {
    gamepad: {
      enabled: false
    }
  }
});
momentumEnabled Boolean
起始版本: GeoScene API for JavaScript 4.22

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

默认值:true
示例代码:
// 在 MapView 中禁用平移动画。
const view = new MapView({
  container: "viewDiv",
  map: new Map({
    basemap: "geoscene-community"
  })
});
view.navigation.momentumEnabled = false;
mouseWheelZoomEnabled Boolean
起始版本: GeoScene API for JavaScript 4.22

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

默认值:true
示例代码:
// 在 MapView 中禁用鼠标滚轮缩放。
const view = new MapView({
  container: "viewDiv",
  map: new Map({
    basemap: "geoscene-community"
  })
});
view.navigation.mouseWheelZoomEnabled = false;

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.