SnappingControls

AMD: require(["geoscene/widgets/support/SnappingControls"], (SnappingControls) => { /* code goes here */ });
ESM: import SnappingControls from "@geoscene/core/widgets/support/SnappingControls";
类: geoscene/widgets/support/SnappingControls
继承于:SnappingControls Widget Accessor
起始版本:GeoScene API for JavaScript 4.21

概述

SnappingControls 微件提供了一个用户界面,可与 SnappingOptions 类一起使用。 SnappingOptionsSketchSketchViewModelEditorEditorViewModel 中的一个属性。

此微件已集成为草绘微件的一部分。因此,在加载草绘微件时,它将自动包含在内,开发人员无需进行任何额外工作。

查看草绘微件中的 SnappingControls 和草绘-几何示例。
sketch-geometries

使用微件

SnappingControls 微件可与 MapView 一起使用,就像任何其他微件一样。但是,此微件依赖于 SnappingOptions 类。目前,除了它们各自的视图模型之外,这仅作为草绘编辑器微件中的属性提供。这意味着 SnappingControls 微件不能用作独立微件,除非它与这些受支持的类结合使用。若要将此微件与编辑器EditorViewModelSketchViewModel 一起使用,必须对其进行实例化,并且其 snappingOptions 属性必须设置为 编辑器的EditorViewModel'sSketchViewModel's snappingOptions 属性。

以下代码段演示如何在编辑器微件中使用 SnappingControls 。

require(["geoscene/widgets/Editor", "geoscene/widgets/support/SnappingControls"], (Editor, SnappingControls) => {
  const editor = new Editor({
    view: view
  });

  // create a new instance of the SnappingControls widget
  const snappingControls = new SnappingControls({
    view: view,
    snappingOptions: editor.snappingOptions  // set the Editor's snappingOptions property
  });

  view.ui.add(editor, "top-right");  // adds the Editor widget to the view
  view.ui.add(snappingControls, "top-left"); // adds the SnappingControls widget to the view

});

此微件将自动检测地图上支持捕捉的所有图层,并且 layerlist 将填充这些 FeatureSnappingLayerSources。默认情况下,这些图层将被禁用以进行要素捕捉。当用户单击图层列表中的图层标题时,将启用图层以进行捕捉。如果希望自动启用这些图层,请将启用设置为 true.。

widgets-editor-basic

已知限制

有关完全控制微件样式的信息,请参阅样式设置主题。
另请参阅:
示例:
// Create a new instance of SketchViewModel
const sketchViewModel = new SketchViewModel({
  view: view,
  layer: graphicsLayer
});

// Create a new instance of the SnappingControls widget
const snappingControls = new SnappingControls({
  view: view,
  snappingOptions: sketchViewModel.snappingOptions
});

构造函数

new SnappingControls(properties)
参数:
properties Object
optional

有关可能传递到构造函数中的所有属性的列表,请参阅属性

属性概述

可以设置、检索或侦听任何属性。请参阅使用属性主题。
显示继承的属性 隐藏继承的属性
名称 类型 描述 类:
String|HTMLElement更多详情

表示包含微件的 DOM 元素的 ID 或节点。

更多详情Widget
String更多详情

类的名称。

更多详情Accessor
String更多详情

创建微件时分配给微件的唯一 ID。

更多详情Widget
String更多详情

SnappingControls 微件的默认标注。

更多详情SnappingControls
SnappingOptions更多详情

用于草绘的 SnappingOptions

更多详情SnappingControls
MapView|SceneView更多详情

微件将从中操作的视图。

更多详情SnappingControls
SnappingControlsViewModel更多详情

SnappingControls 微件的视图模型。

更多详情SnappingControls
Boolean更多详情

指示微件是否可见。

更多详情Widget
VisibleElements更多详情

显示在微件中的可见元素。

更多详情SnappingControls

属性详细信息

表示包含微件的 DOM 元素的 ID 或节点。此属性只能设置一次。以下示例是使用微件时的所有有效用例。

示例:
// Create the HTML div element programmatically at runtime and set to the widget's container
const basemapGallery = new BasemapGallery({
  view: view,
  container: document.createElement("div")
});

// Add the widget to the top-right corner of the view
view.ui.add(basemapGallery, {
  position: "top-right"
});
// Specify an already-defined HTML div element in the widget's container

const basemapGallery = new BasemapGallery({
  view: view,
  container: basemapGalleryDiv
});

// Add the widget to the top-right corner of the view
view.ui.add(basemapGallery, {
  position: "top-right"
});

// HTML markup
<body>
  <div id="viewDiv"></div>
  <div id="basemapGalleryDiv"></div>
</body>
// Specify the widget while adding to the view's UI
const basemapGallery = new BasemapGallery({
  view: view
});

// Add the widget to the top-right corner of the view
view.ui.add(basemapGallery, {
  position: "top-right"
});
declaredClass Stringreadonly inherited

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

创建微件时分配给构件的唯一 ID。如果未由开发人员设置,它将默认为容器 ID,或者如果不存在,则将自动生成。

label String

SnappingControls 微件的默认标注。

snappingOptions SnappingOptionsautocast

用于草绘的 SnappingOptions。它支持自拍要素捕捉。

微件将从中操作的视图。

SnappingControls 微件的视图模型。此类包含控制微件行为的所有逻辑(即属性和方法)。请参阅 SnappingControlsViewModel 类以访问 SnappingControls 微件上的所有属性和方法。

指示微件是否可见。

如果 false,则该微件将不再呈现在 web 文档中。这可能会影响文档中其他元素或微件的布局。例如,如果此微件是与视图 UI 右上角关联的三个微件中的第一个,则当此微件变为不可见时,其他微件将重新定位。有关详细信息,请参阅 "none" 的 CSS 显示值。

默认值:true
示例:
// Hides the widget in the view
widget.visible = false;
visibleElements VisibleElementsautocast

显示在微件中的可见元素。此属性提供了打开/关闭微件显示的各个元素的功能。

下图显示了默认的 SnappingControls 微件,其中所有可见元素都可见。

snapping-controls-default

相比之下,下图显示了启用了要素捕捉切换和要素捕捉图层源 layerList 已关闭的微件。

snapping-controls-example

示例:
// This removes the feature enabled snapping toggle and the layerlist.
snappingControls.visibleElements = {
  featureEnabledToggle: false,
  layerList: false
}

方法概述

显示继承的方法 隐藏继承的方法
名称 返回类型 描述 类:
String更多详情

用于为微件的 class 属性构建值的实用程序方法。

更多详情Widget
更多详情

销毁微件实例。

更多详情Widget
Boolean更多详情

在实例上发出事件。

更多详情Widget
Boolean更多详情

指示实例上是否存在与提供的事件名称匹配的事件侦听器。

更多详情Widget
Boolean更多详情

isFulfilled() 可用于验证是否满足类的创建实例(已解决或已拒绝)。

更多详情Widget
Boolean更多详情

isRejected() 可用于验证创建类的实例是否被拒绝。

更多详情Widget
Boolean更多详情

isResolved() 可用于验证是否解析了类的创建实例。

更多详情Widget
Object更多详情

在实例上注册事件处理程序。

更多详情Widget
更多详情

微件拆解助手。

更多详情Widget
更多详情

此方法主要由开发人员在实现自定义微件时使用。

更多详情Widget
Object更多详情

此方法主要由开发人员在实现自定义微件时使用。

更多详情Widget
更多详情

立即将微件渲染给 DOM。

更多详情Widget
更多详情

此方法主要由开发人员在实现自定义微件时使用。

更多详情Widget
Promise更多详情

when() 可以在创建类的实例后利用。

更多详情Widget

方法详细信息

classes(classNames){String}inherited

用于为微件的 class 属性构建值的实用程序方法。这有助于简化 CSS 类设置。

参数:
repeatable

类名称。

返回:
类型 说明
String 计算的类名。
另请参阅:
示例:
// .tsx syntax showing how to set CSS classes while rendering the widget

render() {
  const dynamicIconClasses = {
    [CSS.myIcon]: this.showIcon,
    [CSS.greyIcon]: !this.showIcon
  };

  return (
    <div class={classes(CSS.root, CSS.mixin, dynamicIconClasses)} />
  );
}
destroy()inherited

销毁微件实例。

emit(type, event){Boolean}inherited

在实例上发出事件。仅当创建此类的子类时,才应使用此方法。

参数:
type String

事件的名称。

event Object
optional

事件负载。

返回:
类型 说明
Boolean 如果听取了侦听者的通知,则为 true
hasEventListener(type){Boolean}inherited

指示实例上是否存在与提供的事件名称匹配的事件侦听器。

参数:
type String

事件的名称。

返回:
类型 说明
Boolean 如果类支持输入事件,则返回 true。
isFulfilled(){Boolean}inherited

isFulfilled() 可用于验证是否满足类的创建实例(已解决或已拒绝)。如果已完成,将返回 true

返回:
类型 说明
Boolean 指示是否已完成创建类的实例(已解决或已拒绝)。
isRejected(){Boolean}inherited

isRejected() 可用于验证创建类的实例是否被拒绝。如果被拒绝,将返回 true

返回:
类型 说明
Boolean 指示创建类的实例是否已被拒绝。
isResolved(){Boolean}inherited

isResolved() 可用于验证是否解析了类的创建实例。如果被解析,将返回 true

返回:
类型 说明
Boolean 指示是否已解析创建类的实例。
on(type, listener){Object}inherited

在实例上注册事件处理程序。调用此方法将事件与侦听器挂钩。

参数:

要侦听的事件或事件数组。

listener Function

事件激发时要调用的函数。

返回:
类型 说明
Object 返回具有 remove() 方法的事件处理程序,应调用该方法以停止侦听事件。
属性 类型 说明
remove Function 调用时,从事件中删除侦听器。
示例:
view.on("click", function(event){
  // event is the event handle returned after the event fires.
  console.log(event.mapPoint);
});
own(handles)inherited

微件拆解助手。当微件被销毁时,添加到其中的任何句柄都将自动删除。

参数:

在微件被销毁后标记为删除的句柄。

postInitialize()inherited

此方法主要由开发人员在实现自定义微件时使用。在微件准备好进行渲染后执行。

render(){Object}inherited

此方法主要由开发人员在实现自定义微件时使用。它必须由子类实现以进行渲染。

返回:
类型 说明
Object 渲染的虚拟节点。
renderNow()inherited

立即将微件渲染给 DOM。

scheduleRender()inherited

此方法主要由开发人员在实现自定义微件时使用。计划微件渲染。此方法对于影响 UI 的更改很有用。

when(callback, errback){Promise}inherited

when() 可以在创建类的实例后利用。此方法采用两个输入参数:callback 函数和 errback 函数。在类的实例加载时执行 callback。如果类的实例无法加载,则执行 errback

参数:
callback Function
optional

解析 promise 时要调用的函数。

errback Function
optional

promise 失败时要执行的函数。

返回:
类型 说明
Promise 返回回调结果的新 promise,callback 结果可用于链接其他函数。
示例:
// Although this example uses the BasemapGallery widget, any class instance that is a promise may use when() in the same way
let bmGallery = new BasemapGallery();
bmGallery.when(function(){
  // This function will execute once the promise is resolved
}, function(error){
  // This function will execute if the promise is rejected due to an error
});

类型定义

VisibleElements Object

显示在微件中的可见元素。这提供了在微件中切换单个元素可见性的能力。

属性:
header Boolean
optional

指示是否显示标题。默认为 true

enabledToggle Boolean
optional

指示是否显示 enabledToggle(启用捕捉)。默认为 true。这将切换 SnappingOptions.enabled 属性。

如果 enabledToggle 设置为 false,建议设置 SnappingControls.snappingOptions.enabled = true。这是因为 selfEnabledTogglefeatureEnabledToggle 需要启用全局捕捉才能实现交互。否则,这些切换将不会响应。

selfEnabledToggle Boolean
optional

指示是否显示 selfEnabledToggle(几何指南)。默认为 true。这将切换 SnappingOptions.selfEnabled 属性。

featureEnabledToggle Boolean
optional

指示是否显示 featureEnabledToggle(要素到要素)默认为 true。这将切换 SnappingOptions.featureEnabled 属性。

layerList Boolean
optional

指示是否显示 FeatureSnappingLayerSource layerList。默认为 true。Layerlist 提供支持捕捉的可用图层源。

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