• JS API 列表
  • 基础
  • tt.canIUse
  • tt.base64ToArrayBuffer
  • tt.arrayBufferToBase64
  • 生命周期
  • tt.canIPutStuffOverComponent
  • 版本更新
  • 定时器
  • 应用级事件
  • 环境变量
  • 性能
  • 线程
  • 窗口尺寸变化
  • tt.setPageInfo
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 行业开放
  • 第三方平台
  • 其它
  • tt.canIPutStuffOverComponent
    收藏
    我的收藏

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

    小程序中的一些组件是由客户端实现的,如 videoad 等。如果开发者希望通过 css 等途径往这些组件的上方放置一些其他组件,是需要小程序所在 App 具备一定能力才可以实现的。开发者可以使用本方法在小程序运行时判断某组件上方是否支持放置其他组件,并根据返回结果动态决定小程序页面的实现方式。

    前提条件
    业务背景
    使用限制
    注意事项
    基础库 1.87.0 开始支持对 native canvas 的判断。
    支持沙盒
    相关教程

    语法

    tt.canIPutStuffOverComponent(componentName)

    参数说明

    componentName

    类型默认值必填说明最低支持版本
    string

    小程序组件标签名称,如 "video"、"live-player"、"canvas" 等,更多组件可参考组件列表

    注:canvas 组件有新旧两种方案,传参有差异,详情请见 canvas 组件

    1.59.0

    返回值

    类型说明最低支持版本
    boolean
    返回值是一个布尔值,表示是否支持在该类型组件上放置其他组件。
    1.59.0

    错误码

    errorCodeerrMsgerrorType说明最低支持版本
    165299canIPutStuffOverComponent:fail inputs[0] should be string, but got xxxD
    入参格式不对

    检查入参

    1.59.0
    165299canIPutStuffOverComponent:fail invalid component name: xxxD
    无效的组件名称

    检查入参

    1.59.0

    扫码体验

    请使用字节宿主APP扫码

    代码示例

    canvas 组件​

    对于 canvas 组件,需以 css 选择器方式传参,可参考代码示例。​
      对于 web canvas(即旧方案,不指定 type 属性值),入参为:canvas;​
      对于 native canvas(即新方案「基础库 1.87.0 开始支持」,指定 type 为 2d 或 webgl),支持以下入参: canvas[type=2d] canvas[type='2d'] canvas[type="2d"] canvas[type=webgl] canvas[type='webgl'] canvas[type="webgl"]​