bitrix-ui

Bitrix UI

基线：main 23.0+ · 已验证：ui 26.687.0、main 26.800.0

任务	阅读
main.popup、Menu、侧边面板（滑块）页面	rules/popups-sidepanel.md
模态对话框、确认框、系统菜单、弹出层	rules/dialogs-menus.md
JS 和 PHP 中的按钮、按钮菜单	rules/buttons.md
页面标题栏：标题、按钮、筛选器	rules/toolbar.md
列表页面：网格、筛选器、分组操作	rules/grid-filter.md
选择用户/实体、提供程序、目录选择器	rules/selectors.md
表单标记、输入框、选择框、颜色选择器	rules/forms-inputs.md
警报、提示通知、提示、用户工具提示、骨架屏	rules/feedback.md
计数器、状态标签、徽章	rules/counters-labels.md
阶段栏、历史动态、BBCode 文本	rules/stageflow-timeline.md
文件上传字段	rules/uploader.md
在查看器中打开文件	rules/viewer.md
图标、排版、Lottie、焦点/无障碍	rules/icons-typography-a11y.md

不变原则

• 按扩展 ID 加载：在 PHP 中使用 Extension::load('ui.x')，在 bundle 中使用 import { X } from 'ui.x'。切勿通过文件路径引入内核 JS/CSS：文件会在不同版本间变动。
• 新设计：ui.system.*（自 ui 26.200* 起）。旧版内核：main.popup、ui.alerts、ui.dialogs.messagebox。Since 图例：bitrix-framework。
• 字符串选项 content、text、html、description 以及 PHP HTML 插槽通常是原始 HTML：传入 DOM 节点或进行转义（Text.encode()、htmlspecialcharsbx()）。
• 小组件仅渲染和存储 UI 状态。数据、权限和 CSRF 保留在服务器端（bitrix-controllers）。
• 仅使用公共 API：不要使用 _private 字段，也不要覆盖内部方法。
• Vue：不要将小组件实例放入响应式状态（markRaw()），参见 bitrix-vue。