bitrix-ui について
Bitrix UI は、Bitrix UI コンポーネントで画面を構築する開発者向けのリファレンススキルです。ウィジェット、フォーム、ナビゲーション、フィードバック、アクセシビリティの指針を、バージョン対応とセキュリティの規則とともに整理しています。
主な機能
- 01UI コンポーネントとパターンのガイド
- 02拡張機能 ID によるリソース読み込み
- 03バージョンに応じたデザイン指針
- 04HTML コンテンツの安全な処理
- 05ウィジェットとサーバーの役割規則
活用シーン
- 01ダイアログ、メニュー、ポップアップの構築
- 02グリッドとページツールバーの作成
- 03フォームとセレクターの実装
- 04アクセシブルな通知とステータス UI の追加
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bxmaximum/ bitrix-framework-skills --skill bitrix-uiインストール後、Claude Code で/bitrix-uiを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
rules/buttons.mdcounters-labels.mddialogs-menus.mdfeedback.mdforms-inputs.mdgrid-filter.mdicons-typography-a11y.mdpopups-sidepanel.mdselectors.mdstageflow-timeline.mdtoolbar.mduploader.mdviewer.md詳細
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')、バンドルでは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を参照してください。
コメント
Markdown 対応