# NodesRef

> 相关文档: [获取界面上的节点信息](/miniprogram/dev/framework/view/selector.md)

用于获取 WXML 节点信息的对象

## 方法

### [SelectorQuery NodesRef.fields(Object fields, NodesRef.FieldsCallback callback)](/miniprogram/dev/api/wxml/NodesRef.fields)

获取节点的相关信息。需要获取的字段在fields中指定。返回值是 `nodesRef` 对应的 `selectorQuery`

### [SelectorQuery NodesRef.boundingClientRect(NodesRef.boundingClientRectCallback callback)](/miniprogram/dev/api/wxml/NodesRef.boundingClientRect)

添加节点的布局位置的查询请求。相对于显示区域，以像素为单位。其功能类似于 DOM 的 `getBoundingClientRect`。返回 `NodesRef` 对应的 `SelectorQuery`。

### [SelectorQuery NodesRef.scrollOffset(NodesRef.scrollOffsetCallback callback)](/miniprogram/dev/api/wxml/NodesRef.scrollOffset)

添加节点的滚动位置查询请求。以像素为单位。节点必须是 `scroll-view` 或者 `viewport`，返回 `NodesRef` 对应的 `SelectorQuery`。

### [SelectorQuery NodesRef.context(NodesRef.contextCallback callback)](/miniprogram/dev/api/wxml/NodesRef.context)

添加节点的 Context 对象查询请求。目前支持 [VideoContext](/miniprogram/dev/api/media/video/VideoContext)、[CanvasContext](/miniprogram/dev/api/canvas/CanvasContext)、[LivePlayerContext](/miniprogram/dev/api/media/live/LivePlayerContext)、[EditorContext](/miniprogram/dev/api/media/editor/EditorContext)、[SelectionContext](/miniprogram/dev/api/wxml/SelectionContext) 和 [MapContext](/miniprogram/dev/api/media/map/MapContext) 的获取。

### [SelectorQuery NodesRef.node(NodesRef.nodeCallback callback)](/miniprogram/dev/api/wxml/NodesRef.node)

获取 Node 节点实例。目前支持 [Canvas](/miniprogram/dev/api/canvas/Canvas) 和 [ScrollViewContext](/miniprogram/dev/api/ui/scroll/ScrollViewContext) 的获取。

### [SelectorQuery NodesRef.ref(NodesRef.refCallback callback)](/miniprogram/dev/api/wxml/NodesRef.ref)

获取 `Node` 节点的 Ref 对象，可用于 `worklet` 函数内操作节点。仅 `Skyline` 下支持，`Node` 必须是非 `virtual` 类型。