SuperAPI AI 工具集

b24jssdk-frame-ui

通用与其它

查看项目

更新于 10-15 20:06

技能介绍

b24jssdk 的 frame UI 管理器只存在于 B24Frame,不对 B24Hook 或 B24OAuth 生效,必须在 Bitrix24 放置 iframe 内通过 initializeB24Frame 初始化,组件卸载时调用 $b24.destroy()。

用途与能力:slider 打开门户路径或自身应用页;dialog 选择用户、CRM 实体(selectCRM)与权限目标(selectAccess);parent 控制 iframe 布局,如 fitWindow、resizeWindow、resizeWindowAuto、setTitle、scrollParentWindow、reloadWindow、closeApplication 及 IM 相关方法;placement 提供 title、options、isSliderMode,并支持 getInterface、bindEvent、call、callCustomBind、setValue;options 提供应用级与用户级设置读写;auth 提供 getAuthData、refreshAuth、getLang、getAppSid,并可在初始化时开启 keepAuthFresh。

必要用法:import { initializeB24Frame } from '@bitrix24/b24jssdk';const $b24 = await initializeB24Frame()。openPath 打开门户路径,返回时机为滑块关闭(移动端弹窗关闭),需检查 isOpenAtNewWindow。openSliderAppPage 传入的参数会作为 PLACEMENT_OPTIONS 转发,settles 于关闭而非打开。路由跳转属于应用自身职责,Nuxt 中需用 onNuxtReady 配合 router.replace。

限制与注意:安装模式必须调用 $b24.installFinish(),且应作为流程最后一步;纯 API 应用不应调用。parent.im* 为即发即忘,promise 仅表示命令已发送,不可当作成功信号。setValue 必须传 JSON 序列化字符串,否则抛 TypeError,优先用 placement.setValue。不要在 options.appSet 存密钥;closeApplication 需加 .catch 且不要 await。未提供安装命令、收费与具体版本要求等信息。