element.mount()
使用此方法将 Element 实例挂载到指定的 DOM 容器中。调用 element.mount() 后,SDK 会在容器内创建 iframe 并加载对应的 WebApp 页面。
方法签名
调用此方法时,请使用以下标准方法签名格式:
JavaScript
TypeScript
copy
element.mount(container)参数
参数名称 | 类型 | 是否必需 | 描述 |
container | HTMLElement | 是 | DOM 容器节点(如 |
返回值
此方法返回一个 Promise,可通过 element.mount().catch() 捕获挂载过程中的异常。
错误码
调用 element.on() 方法监听 element.mount() 方法相关的错误码,具体错误码列表请参见错误码。
最佳实践
- 挂载时机: 必须在调用
antom.confirmCardSetup()/antom.confirmPayment()之前完成挂载。 - 容器要求:
- 确保容器元素在调用
element.mount()时已存在于 DOM 中。 - 建议容器宽度不小于 375px,高度不限制以便 Element 自动撑开。
- 重复挂载: 同一个 Element 实例只能挂载一次,重复调用
element.mount()会导致异常。 - 卸载: 如需移除 Element,请调用
element.unmount()方法。