抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 基础
  • 渲染
  • 媒体
  • 数据缓存
  • TTML
  • tt.createSelectorQuery
  • tt.createIntersectionObserver
  • NodesRef.boundingClientRect
  • NodesRef.scrollOffset
  • NodesRef.fields
  • NodesRef.node
  • 数据分析
  • 页面导航
  • 设备
  • 画布
  • 界面
  • 直播开放能力
  • NodesRef.fields
    收藏
    我的收藏

    基础库 3.41.0 开始支持本方法,这是一个同步方法。
    添加节点的相关信息的查询,在 fields 中指定需要获取的字段。
    如果提供了 callback 回调函数,在执行 SelectQuery.exec 方法后,节点信息会在 callback 中返回。

    语法

    nodesRef.fields(fields, callback)

    参数说明

    fields

    类型
    默认值
    必填
    说明
    最低支持版本
    Fields
    指定查询的节点信息内容
    3.41.0

    Fields 类型说明

    object 类型,属性如下:
    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    id
    boolean
    false
    是否返回节点的 ID
    3.41.0
    dataset
    boolean
    false
    是否返回节点的 dataset
    3.41.0
    rect
    boolean
    false
    是否返回节点布局位置(left、right、top、bottom)
    3.41.0
    size
    boolean
    false
    是否返回节点尺寸(width、height)
    3.41.0
    scrollOffset
    boolean
    false
    是否返回节点的滚动位置信息(scrollLeft、scrollTop),节点必须是 scroll-view 或者 viewport
    3.41.0
    node
    boolean
    false
    是否返回节点对应的 Node 实例,当前仅支持新方案 canvas 实例的获取
    3.41.0
    computedStyle
    string[]
    []
    指定样式名列表,返回节点对应样式名的当前值
    3.41.0
    注:新方案 canvas 是指定了合法的 type 属性的 canvas 组件,详细见 canvas 组件 文档。

    callback

    类型
    默认值
    必填
    说明
    最低支持版本
    function
    回调函数
    3.41.0

    回调函数参数说明

    object 类型,代表查询结果,属性如下:
    参数
    参数类型
    说明
    最低支持版本
    id
    string
    节点的 ID
    3.41.0
    dataset
    object
    节点的 dataset
    3.41.0
    left
    number
    节点的左边界坐标
    3.41.0
    right
    number
    节点的右边界坐标
    3.41.0
    top
    number
    节点的上边界坐标
    3.41.0
    bottom
    number
    节点的下边界坐标
    3.41.0
    width
    number
    节点的宽度
    3.41.0
    height
    number
    节点的高度
    3.41.0
    scrollLeft
    number
    节点的水平滚动位置
    3.41.0
    scrollTop
    number
    节点的竖直滚动位置
    3.41.0

    返回值

    扫码体验

    代码示例

    Bug & Tip