视图上的导航相关配置设置。
属性列表
可以设置、检索或监听的属性。参见 使用属性。
属性 | 类型 | 描述 | 类 | |
---|---|---|---|---|
Boolean | 更多信息 是否启用或禁用单指触摸 拖动 事件。 | 更多信息 | Navigation | |
String | 更多信息 类名。 | 更多信息 | Accessor | |
GamepadSettings | 更多信息 游戏板导航特定的配置设置。 | 更多信息 | Navigation | |
Boolean | 更多信息 当设为 | 更多信息 | 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;
-
类名。类的名称声明格式为
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;