提供 NavigationToggle 微件的逻辑,该微件提供了两个用于切换 SceneView 的导航模式的简单按钮。请注意,这不是为 MapView 中的 2D 鼠标交互而设计的,也不是为触摸导航而设计的。
SceneView 的默认导航模式始终为 pan
。此处概述了此模式的各种鼠标交互。要切换到的备用导航模式是 rotate
。这允许用户通过鼠标拖动旋转视图,并通过右键单击和拖动手势平移视图。
示例
// creates a new instance of the NavigationToggle
let navigationToggle = new NavigationToggle({
viewModel: {
view: view
},
layout: "horizontal"
});
// and adds it to the top right of the view
view.ui.add(navigationToggle, "top-right");
构造函数
属性概述
可以设置、检索或侦听任何属性。请参阅使用属性主题。
名称 | 类型 | 描述 | 类 |
---|---|---|---|
String | 类的名称。 更多详情 | Accessor | |
String | 视图的导航模式。 更多详情 | NavigationToggleViewModel | |
String | 微件的状态。 更多详情 | NavigationToggleViewModel | |
SceneView | 与微件关联的视图。 更多详情 | NavigationToggleViewModel |
属性详细信息
-
起始版本:GeoScene Maps SDK for JavaScript 4.7
-
类的名称。声明的类名称格式化为
geoscene.folder.className
。
-
-
视图的导航模式。有关可能值列表,请参见下表。
可能值 描述 pan 鼠标拖动手势将平移视图。右键单击 + 拖动允许用户围绕视图中心执行 3D 旋转。 rotate 鼠标拖动手势围绕视图中心执行 3D 旋转,右键单击 + 拖动手势平移视图。 可能值:"pan"|"rotate"
- 默认值:pan
-
state Stringreadonly
-
微件的状态。
可能的值:"disabled"|"ready"
- 默认值:disabled
-
view SceneView
-
与微件关联的视图。
方法概述
名称 | 返回值类值 | 描述 | 类 |
---|---|---|---|
添加一个或多个与对象的生命周期相关联的句柄。 更多详情 | Accessor | ||
Boolean | 如果存在指定的句柄组,则返回 true。 更多详情 | Accessor | |
移除对象拥有的句柄组。 更多详情 | Accessor | ||
将视图的导航模式从 | NavigationToggleViewModel |
方法详细说明
-
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() 进行删除。如果未提供键,则句柄将被添加到默认组。
-
起始版本: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");
-
toggle()
-
将视图的导航模式从
pan
切换为rotate
,或反之亦然。