element.mount()

使用此方法将 Element 实例挂载到指定的 DOM 容器中。调用 element.mount() 后,SDK 会在容器内创建 iframe 并加载对应的 WebApp 页面。

方法签名

调用此方法时,请使用以下标准方法签名格式:

copy
element.mount(container)

参数

参数名称

类型

是否必需

描述

container

HTMLElement

DOM 容器节点(如 document.getElementById('container'))。

返回值

此方法返回一个 Promise,可通过 element.mount().catch() 捕获挂载过程中的异常。

错误码

调用 element.on() 方法监听 element.mount() 方法相关的错误码,具体错误码列表请参见错误码

最佳实践

    • 确保容器元素在调用 element.mount() 时已存在于 DOM 中。
    • 建议容器宽度不小于 375px,高度不限制以便 Element 自动撑开。
  • 重复挂载: 同一个 Element 实例只能挂载一次,重复调用 element.mount() 会导致异常。
  • 卸载: 如需移除 Element,请调用 element.unmount() 方法。