• JS API 列表
  • 基础
  • TTML
  • tt.createSelectorQuery
  • tt.createIntersectionObserver
  • SelectorQuery
  • NodesRef
  • NodesRef
  • NodesRef.boundingClientRect
  • NodesRef.scrollOffset
  • NodesRef.fields
  • NodesRef.node
  • IntersectionObserver
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • NodesRef.fields
    收藏
    我的收藏

    基础库 1.7.0 开始支持本方法,这是一个同步方法。

    添加节点的相关信息的查询,在 fields 中指定需要获取的字段。

    如果提供了 callback 回调函数,在执行 SelectQuery.exec 方法后,节点信息会在 callback 中返回。

    语法

    nodesRef.fields(fields, callback)

    参数说明

    fields

    类型

    默认值

    必填

    说明

    最低支持版本

    Fields


    指定查询的节点信息内容

    1.7.0

    Fields 类型说明

    object 类型,属性如下:

    属性名

    类型

    默认值

    必填

    说明

    最低支持版本

    id

    boolean

    false

    是否返回节点的 ID

    1.7.0

    dataset

    boolean

    false

    是否返回节点的 dataset

    1.7.0

    rect

    boolean

    false

    是否返回节点布局位置(left、right、top、bottom)

    1.7.0

    size

    boolean

    false

    是否返回节点尺寸(width、height)

    1.7.0

    scrollOffset

    boolean

    false

    是否返回节点的滚动位置信息(scrollLeft、scrollTop),节点必须是 scroll-view 或者 viewport

    1.7.0

    node

    boolean

    false

    是否返回节点对应的 Node 实例,当前仅支持新方案 canvas 实例的获取

    1.78.0

    computedStyle

    string[]

    []

    指定样式名列表,返回节点对应样式名的当前值

    2.13.0

    注:新方案 canvas 是指定了合法的 type 属性的 canvas 组件,详细见 canvas 组件 文档。

    callback

    类型

    默认值

    必填

    说明

    最低支持版本

    function


    回调函数

    1.7.0

    回调函数参数说明

    object 类型,代表查询结果,属性如下:

    参数

    参数类型

    说明

    最低支持版本

    id

    string

    节点的 ID

    1.7.0

    dataset

    object

    节点的 dataset

    1.7.0

    left

    number

    节点的左边界坐标

    1.7.0

    right

    number

    节点的右边界坐标

    1.7.0

    top

    number

    节点的上边界坐标

    1.7.0

    bottom

    number

    节点的下边界坐标

    1.7.0

    width

    number

    节点的宽度

    1.7.0

    height

    number

    节点的高度

    1.7.0

    scrollLeft

    number

    节点的水平滚动位置

    1.7.0

    scrollTop

    number

    节点的竖直滚动位置

    1.7.0

    返回值

    SelectorQuery

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    开发者工具中预览

    Bug & Tip

    该文档是否有帮助?