コンポーネントの統合
Qokit の共有コンポーネント、パターン、Skin、およびスタイル Token の公開統合契約。
コンポーネントの統合
Qokit は「共有スケルトン + Skin レシピ」モデルを採用しています。外部統合側はコンポーネントのセマンティクスとインタラクション契約に依存し、Skin と Token を通じてビジュアル適応を行います。
2026-10-20 · ビジュアル選択カードの独立した操作
EditorVisualChoiceGroup の選択肢は、独立したカードメニューや名前編集用の省略可能な accessory を受け取ります。共通の RadioGroup がネイティブラベルの隣に配置するため、カードの管理操作でラジオ選択は変わりません。afterOptions はカード作成などの独立したカタログ操作を選択肢の後に配置します。永続化、権限、検証、置換・削除後のフォーカスはホストが管理します。付属操作のない選択肢は従来の構造と動作を維持します。
2026-10-17 · 共有ワークベンチパネルのモーション
EditorWorkbenchChrome は、Creator およびコンテンツ編集で使用される同じパネルスケルトンである BuilderWorkbenchFrame を介して注入された開始/終了レーンをレンダリングします。ホストはコンテンツ、表示状態、幅の優先度を提供します。デスクトップではトラックとパネルの不透明度/変位が --qk-sidebar-motion-duration と --qk-sidebar-motion-easing を共有し、ドラッグ中はトランジションが無効になり、モーション軽減モードに切り替えると即座に反映されます。
折りたたまれたパネルはドラフトを保持するためにマウントされたままになります。共有フレームは直ちに inert と aria-hidden を適用し、プラットフォームスキンが非表示にする前に退出処理を完了します。コンパクトなパネルは退出中もオーバーレイジオメトリを維持し、ホストはパネルシェルに hidden や display: none を追加してはいけません。明示的なピークパネルは既存のインタラクティブな表示動作を維持します。ヘッダーの選択は開閉の状態を問わず利用可能であり、電話先でメニューを共有する場合は EditorPanelChoiceShortcuts.mobileMenu を使用してください。
2026-10-17 · 測定済みエディタのデフォルト値
useWorkspaceResponsiveProfile はオプションの onWidthChange(width) を受け取り、インラインパディングを差し引いた後にレスポンシブプロファイルに使用されるのと同じ利用可能なワークエリア幅を報告します。別のオプザーバーを追加せずに比例したデフォルト値を導出するために、安定したコールバックを使用してください。useEditorLayout は共有幅ストレージだけでなくホストの優先度にも sharedWidths.limits を適用し、readEditorLayout は同じ制限をオプションの第4引数として受け入れます。既存の呼び出し元はデフォルトの境界と動作を維持します。
2026-09-30 · SelectionToolbar のアクセシビリティ
SelectionToolbar.ariaLabel はツールバーを領域として任意に命名します。件数は引き続きライブステータスメッセージです。ホストはローカライズしたラベルを提供し、actionContent で共有の EditorToolGroup と ActionMenu を組み合わせられます。権限確認と操作処理はホストが担当します。
2026-09-10 · ワークスペース識別バッジ
ProjectSwitcherProject.badge は、任意の非インタラクティブな React コンテンツを受け取ります。各項目名、一覧にない現在のコンテキスト行、テキストトリガーの現在名の横に表示されます。アイコンのみのトリガーはコンパクトなままで、プラットフォームのテキストトリガーは電話幅でバッジを隠し、ワークスペース名の領域を確保します。開いたメニューでは引き続きバッジを表示します。ホストは正しいスコープのデータ、ローカライズ済みラベル、表示スタイルを提供します。このフィールドを省略すると従来の外観が維持されます。
2026-09-08 · EmptyState
EmptyState は任意の装飾用 icon、title、任意の description と action を透明な面に中央配置します。layout="section" はコンパクトな既定値で、layout="workspace" は空の業務領域に広い空間を確保します。操作は action に直接配置し、複数ボタンには fragment を使います。共通コンテナーが間隔と長いラベルを処理します。タイトルは h2 です。strong の代わりに title skin スロットを対象にしてください。既存のルートクラスを維持し、skin.vars と style に対応します。翻訳文、権限、ナビゲーション、作成処理はホストが管理し、検索結果とエラーは固有のメッセージと操作を維持します。
2026-09-08 · SidebarNavigation
SidebarNavigation はマウスの 180 ミリ秒の滞留またはキーボードフォーカスで同一オリジンのルートを先読みします。固定・ポップアップナビゲーション全体で 30 秒あたり最大 8 件です。オフライン、非表示タブ、Save-Data、2G では停止し、ダウンロード、無効なリンク、新規ウィンドウ、同一ページのアンカーは対象外です。遷移と未保存変更の保護は維持します。
2026-09-07 - AccountDropdown / SidebarProfile
AccountDropdown に任意の compact と preferences を追加しました。コンパクト表示では識別子と制作履歴を隠し、既定では従来の内容を維持します。アカウントメニュー内の Appearance と Language は triggerRole="menuitem" を指定できます。キーボード操作後にフォーカスを戻し、入れ子の言語ダイアログは Esc を個別に処理します。SidebarNavigation.searchEnabled の既定値は true です。少数の固定項目には false を指定できます。メニューなしで href を持つ SidebarProfile は、展開表示とアイコン表示で同じ移動先を開きます。
2026-09-07 - FormField / AdminEntityDialog / EditorWorkspace
フォームの文字サイズを統一し、長い文言を折り返します。ピル形状とブランド色は維持します。FormField はグループ名を提供し、controlId と内側の入力の id でラベルを関連付けます。SearchField はクリア後にフォーカスを戻します。Segmented と ControlMenu は無効な選択肢に対応し、無効な ActionMenu 項目はリンクを持ちません。処理中のボタンはサイズと表示インジケーターを維持します。AdminEntityDialog は必須項目、メール、JSONを検証し、エラーにフォーカスし、重複保存を防ぎ、失敗時に入力を保持します。EditorWorkspace の ref.focusControl(element) は非表示パネルを表示してからフォーカスします。動きを減らす設定ではコントロールの遷移を無効化します。 WorkspaceDialog は長い内容だけをスクロールし、見出しと操作を表示したままにします。モバイルの短いダイアログは内容に合わせた高さになります。
2026-09-07 · WorkspaceLocationSync / ProjectSwitcher
ルートの切り替えが完了すると、WorkspaceLocationSync は一時的なスペース選択パネルを閉じ、移動先のツールを表示します。検索とセクションの設定は保持されます。サイドバーの範囲名とコンテキストは別々の行に表示し、ヘッダーの長い名前はボタン内で省略します。
2026-09-07 · 統一ナビゲーションと Qokit の丸みのある外観
WorkspaceNavigationDock は items、fallback、className、onClickCapture を通じてホストのナビゲーションと権限を再利用し、別のセッションを読み込みません。展開・アイコン・非表示の既存設定を共有し、860px 以下はドロワーを使用します。PlatformHeader.leadingContext は EditorHeader にも表示されます。カプセル型ボタンと丸い面を維持し、重複した枠線を除去します。
デスクトップではメニューボタンをクリックするとサイドバーを完全に隠し、再クリックすると直前の表示モードに戻ります。メニューまたはサイドバーの端をドラッグすると、非表示・アイコンのみ・展開の各状態に切り替わります。左右の矢印キーは文字の方向に従います。ドラッグをキャンセルしても保存済みの設定は変わらず、モバイルではナビゲーションドロワーを使用します。
Next のレイアウトで WorkspaceLocationSync を Suspense 内に一度配置します。useWorkspaceQueryState(key, defaultValue, validate) は [value, setValue, ready] を返し、useWorkspaceQueryRecord(key, defaults, validators) は宣言済みの平坦なフィルターだけを復元します。認証情報や下書きを URL に保存しないでください。WorkspacePage は容量制限付きのセッション内スクロール位置を復元し、内側の領域には data-workspace-scroll-region と WorkspaceScrollRestoration を使用します。キャンセル可能なブラウザーの戻る・進む操作は履歴を増やさず離脱保護を利用します。AdminEntityDialog は保存失敗や親の再描画でも入力を保持し、バージョンと保存結果はホストが管理します。
管理画面の文字は、ページ見出し 20px/650、セクション見出し 16px/600、本文・ナビゲーション 14px、ラベル 13px、補足 12px に統一します。--qk-workspace-body-ink と --qk-workspace-active-ink は既存の色から派生します。
ピル形の主ボタンは Logo の青 #4695D8 を維持し、明暗両テーマで文字、アイコン、読み込み表示を白にします。ホバー時の軽い明るさ調整は維持します。補助ボタンと危険操作の色は各意味に従います。
ドロップダウンとワークスペース切り替えは --menu-option-font-size(14px)と --menu-option-font-weight(500)、行高 1.45 を共有します。選択項目の太さは 600、補助情報は 12px/400 です。WorkspaceNavigationDock はマウスホバーやキーボードフォーカス時に同一オリジンの遷移先を先読みし、重複記録数を制限します。既存の離脱保護とホストのルートを維持します。
2026-09-07 - ColumnLayout
ColumnLayout は固定ナビゲーション、独立したスクロール領域、追従するページツールバーでデスクトップ管理画面全体を使用します。WorkspacePage は平坦な区切りと共通の角丸 Token を使用します。860px 以下ではナビゲーションはドロワーとなり、閉じている間は操作できません。プロパティと業務動作は変わりません。重複する外側の余白を除き、読みやすい幅の制限はフォーム内に適用してください。
インポートエントリ
import { Button, Card, Dialog, IconButton } from '@qokit/components/ui';
import { PlatformHeader, SiteFooter } from '@qokit/components/patterns';
import { platformButtonSkin } from '@qokit/components/skins/platform';
import { siteCardSkin } from '@qokit/components/skins/site';| エントリ | 用途 |
|---|---|
@qokit/components/ui | Button、Card、Dialog、Menu、Pill などの基本コンポーネント |
@qokit/components/patterns | Header、Footer、ワークスペース、テーブル、リソース、AI アシスタントなどのコンポジション |
@qokit/components/skins/platform | プラットフォームおよびワークスペースのビジュアルレシピ |
@qokit/components/skins/admin | Admin ビジュアルレシピ |
@qokit/components/skins/site | 生成サイト用ビジュアルレシピ |
共通責任の境界
PromptPanel は、オプションの referenceReader とローカライズされた referenceCopy 属性を受け取ります。リーダーは非同期の file(File, AbortSignal) と website(url, AbortSignal) を通じて抽出された contentExcerpt と truncated タグを返し、認証および API アクセスはホスト側が責任を持ちます。コンポーネントは読み取り、プレビュー、再試行、削除を管理します。有効な URL にプロンプトテキストがない場合、referenceCopy.websitePrompt がリクエストを補完し、フォーマットエラーの場合は referenceCopy.errors.url を使用して読み取りをブロックします。URL がまだ読み取られていないか読み取り中の場合、送信は最新の内容を待機し一度のみ送信されます。入力の変更や読み取り失敗は保留中の送信操作をキャンセルし、再試行では以前の送信は復元されません。ファイルは準備完了後に送信できます。完全な URL は貼り付け、フォーカスアウト、または Enter キー押下時に自動で読み取られ、初期 URL も読み取られ、進行中または完了済みの結果を再利用します。失敗した場合は明確な再試行を提供します。URL の編集または削除は以前の読み取りをキャンセルし結果をクリアします。リーダーが提供されていない場合、ネイティブ送信を継続し、非同期参照処理は行いません。
参照インジェストは 2026 年 9 月にオプションかつ後方互換性のあるコンポーネント機能として追加されました。
スケルトンコンポーネントは以下の保証を行います:
- DOM とセマンティックタグ;
- ARIA、キーボード、フォーカス、および disabled 状態の動作;
- 状態管理と基本インタラクション;
- 安定したデフォルト class;
- 名前付き Skin スロット。
Skin は以下の操作が可能です:
root、header、body、item、actionなどのスロットに class を追加する;varsを介して CSS 変数を渡す;- コンポーネントが既に公開している tone、layer、またはビジュアル適応スイッチを使用する。
Skin はデータの要求、DOM の変更、ビジネスルールの保持、またはアクセシビリティ動作の回避を行ってはなりません。
生成要素コンテンツ
生成されたカスタムブロックは、Schema v2 で登録済みの html-* 要素を引き続き使用し、実行可能な HTML や新しいブロックタイプは使用しません。2026 年 9 月以降、@qokit/site-schema は言語コンテンツバインディング用に bindSiteModuleContent、updateSiteModuleBoundContent、forkSiteModuleContentBindings を提供します。コンテンツパスはモジュールに保存され、訪問者向けコピーは言語コンテンツマップに保存されます。更新は取り消しと保存トランザクションを継承します。要素のコピーやブロック間の移動時にはバインディングを派生させ、ソースの変更を避ける必要があります。
オプションの extensionRequirements は未解決のランタイム要件を記録しますが、インストールマニフェストや権限付与ではありません。createSiteExtensionHandoff は実行不可能な v1 開発リクエストをエクスポートします。実行可能なサイトを公開する前に、これらの要件を解決するか、審査を経て明確に除外する必要があります。
フォームコントロール
共有フォームは FormField を使用してラベル、説明、必須メタデータ、エラー、コントロール ID を関連付けます。テキストコントロールには Input、複数行コンテンツには Textarea、選択コントロールには Checkbox、RadioGroup、Switch を使用します。既存の Select と SearchField は同じサイズと状態契約を使用します。
import { FormField, Input } from '@qokit/components/ui';
<FormField label="Site name" description="Up to 60 characters" error={errors.name} required>
<Input name="name" value={name} onChange={handleChange} />
</FormField>;FormField は id、aria-describedby、aria-invalid、required を通じてラベル、説明、エラーを一意の子コントロールに関連付けます。追加の <label> で共有コントロールをラップしないでください。
Input、Textarea、Select、SearchField は sm、md、lg の 3 種類のサイズをサポートし、それぞれ 40px、44px、48px に対応します。単行コントロールはデフォルトで pill 形状を使用します。Textarea は常に共有の複数行角丸を使用します。各インタラクティブおよびエラー状態は共有トークンから取得されます。
移行期間中は旧 .qk-field 契約の使用が引き続き可能です。新しい統合では共有コンポーネントと名前付きスキンスロットを使用してください。
リスト選択
2026 年 9 月以降、リストは useWorkspaceSelectionMode({ enabled, resetKey, onClear }) と WorkspaceFilterToolbar.selection を併用できます。この Hook は初期状態で非アクティブであり、スコープや権限が変更された際にリセットされます。選択 ID のクリアとバッチモードの終了を区別します。スコープキーにはコレクション、言語、ページング、フィルタを含める必要があります。
WorkspaceDataTable.selection はバッチモードがアクティブな場合のみ渡します。グリッドとモバイルのチェックボックスコントロールは同じモードを使用します。ツールバーは汎用選択操作を処理し、利用側がローカライズされたコピー、オプションの ID、権限チェック済みのドメイン操作を提供します。オプションの actionContent は追加の ARIA セマンティクスを保持できますが、汎用コントロールや確認ダイアログの代わりにはなりません。読み取り専用リストではバッチモードを表示しません。ファイルピッカーと提案審査はそれぞれのセマンティクスを保持します。
これらの追加機能はオプションかつ後方互換性があります。テーブル選択は引き続き利用側が明示的に制御します。
指標カード
追加 API リファレンス(英語・翻訳準備中) · 2026-10
DataCard provides a title and optional headerAction, body content with an optional emphasized value, and optional footerText and footerAction. Pass other body content as children. density="default" has a 144px minimum height and 20px padding; density="compact" has a 112px minimum height and 16px padding. Cards grow when content needs more room. variant selects the shared Card surface: surface, muted, or state. Choose these shared sizes instead of overriding height, padding, or value typography in route CSS.
Use shared UI controls in action slots. Keep the card root non-interactive when it has actions; a whole-card action cannot contain nested buttons or links. MetricCard composes the same skeleton and retains label, detail, semantic tone, and optional visuals.
import { DataCard, MetricCard } from '@qokit/components/patterns';
import { Button } from '@qokit/components/ui';
<DataCard
title="Published"
value={24}
headerAction={<Button size="sm" variant="ghost">View</Button>}
footerText="Up 3 from last week"
footerAction={<Button size="sm" variant="secondary">Details</Button>}
density="compact"
/>;
<MetricCard density="compact" label="Published" value={24} tone="success" />;プラットフォーム Header と Footer
Logo は標準で静止画像を表示します。motion="breathe" は非表示中も寸法を確保し、ページの読み込みが完了して半分以上が見えると、4.8 秒の呼吸アニメーションで一度だけ表示します。ヘッダーとフッターに追加の待機時間はありません。motionVisibilityDelayMs で連続表示の待機時間を追加でき、既定値はゼロです。motionOnceKey は同一ドキュメント内の再マウントで再生記録を共有し、ヘッダーとフッターには別のキーを使います。ページ内の遷移、テーマ変更、スクロールで戻っても再生せず、ページ全体の再読み込みでリセットします。動きの軽減、JavaScript 無効、可視性監視が利用できない場合は静止画像を表示します。motion="reveal" は別名として維持します。
PlatformHeader.autoHideOnScroll の既定値は false で、PublicPlatformHeader が有効にします。下へスクロールすると隠れ、上へスクロールするかページ上部に近づくと戻ります。ヘッダーメニューが開いているか内部にフォーカスがある間は表示を維持します。ワークスペースとエディターのヘッダーは固定です。
PlatformHeader はビジネスステートを持たない Header スケルトンです。PublicPlatformHeader はこれにブランドエントリ、共通ナビゲーション、言語、テーマ、ログイン、「今すぐ体験」、モバイルメニューを組み合わせたもので、プラットフォームの匿名状態とドキュメントサイトはこのコンポジションを直接再利用します。
共通ナビゲーションは buildPublicHeaderNavItems(copy, links) によって「リソース / 価格 / ニュース」が一括生成されます。統合側は現在適用されているサイトの内部 URL、ドキュメントサイト URL、およびプラットフォーム URL のみを解析し、メニュー順序やコピーを重複して定義しないでください。ログイン後のプラットフォーム Header も同じ生成関数を使用します。
<PublicPlatformHeader
copy={headerCopy}
links={{
brandHref: '/',
resourceCenterHref: '/resources',
userManualHref: 'https://docs.qokit.com/manual',
developerDocsHref: 'https://docs.qokit.com/developers',
changelogHref: 'https://docs.qokit.com/changelog',
pricingHref: '/pricing',
newsHref: '/news',
loginHref: '/login',
studioHref: '/studio'
}}
/>基盤となる navItems は引き続き link、scroll、menu をサポートします。menu はデスクトップでクリック、キーボード、Escape キー、および外部クリックによる閉じをサポートし、モバイルでは MobileHeaderMenu によってリンクグループに展開されます。
SiteFooter は Footer スケルトンです。プラットフォームとドキュメントサイトは PublicPlatformFooter を使用して、外側の Shell、ブランドエントリ、リンク、テーマ、および言語コントロールを一括で組み合わせます。クロスドメイン統合では、resolveCompanyHref によって相対パスのプラットフォームリンクを絶対アドレスに変換します。
<PublicPlatformFooter
brandHref="https://qokit.com"
copy={footerCopy}
resolveCompanyHref={(href) => `https://qokit.com${href}`}
/>ビジネスアプリケーションは Header、Footer の DOM、または共通ナビゲーション配列を複製しないでください。異なるビジュアル表現が必要な場合は、PlatformHeaderSkin、SiteFooterSkin、または対応するプラットフォーム Skin を使用してください。
互換性戦略
- 新規追加のオプション属性および Skin スロットは後方互換性のある変更です。
- 属性の削除、デフォルトセマンティクスの修正、または DOM/キーボード動作の変更は破壊的変更です。
- 破壊的変更は必ず Changelog に記載し、マイグレーション例を提供する必要があります。
- 非公開の内部 class、ディレクトリ構造、またはルート構造に依存しないでください。
- 2つ以上の統合ポイントで同じ上書きが必要な場合は、公開 Skin または Token として昇格させてください。
全画面編集
EditorWorkspace は全画面ダイアログ、フォーカス管理、レスポンシブなパネルを提供します。dirty で変更の破棄を確認し、busy で保存中の終了を防ぎ、onSave で Ctrl/Cmd+S を処理します。権限、データ、保存、公開は利用側のアプリが管理します。
view / onViewChange は本文エディターを置き換えずに edit、focus、preview を切り替えます。preview はプレビューを提供し、previewPanel は既存パネルを再利用します。layout は writing、structure、canvas に対応します。storageKey が記憶するのはパネル幅と折りたたみ設定だけで、本文は保存しません。
onSaveAndClose は保存成功の確認後に true、失敗時に false、ホストが移動済みなら handled、業務検証で判断を待つ場合は pending を返します。失敗時はエディターを開いたままにします。closeBehavior="collapse" はホストが下書きを保持する場合のみ使います。EditorSaveStatus は確認済みの状態を表示します。EditorViewControls、EditorLeaveDialog、useEditorLayout も既存画面で組み合わせられます。
キーボード移行:Segmented の Tab 停止位置は一つで、矢印 / Home / End で選択します。Dialog は子オーバーレイによる Escape の処理を尊重します。その後、編集画面は集中・プレビューを解除してから閉じます。LivePreviewToolbar.exitControl は共通ビュー操作を受け取ります。保存、公開、権限は引き続きホストが管理します。
import { EditorWorkspace } from '@qokit/components/patterns';
<EditorWorkspace
open={open}
title={title}
dirty={dirty}
busy={saving}
onClose={closeEditor}
onSave={saveDraft}
onSaveAndClose={saveDraft}
saveState={saveState}
layout="writing"
storageKey="article"
preview={preview}
navigation={structure}
inspector={properties}
actions={saveActions}
>
{editor}
</EditorWorkspace>SidebarToggleSlot
SidebarToggleSlot は既存のサイドバー切替ボタンをワークスペースのヘッダーに配置します。左サイドバーにつきスロットを1つ使用します。状態、ショートカット、モバイルドロワーは引き続き SidebarNavigation が管理し、スロットがなければ従来の位置を使います。モバイルドロワーもヘッダーのボタンで閉じ、閉じた後は同じボタンにフォーカスが戻ります。
EditorHeader
EditorHeader は現在のエディター内にホストのロゴ、アカウント、グローバルメニューを維持します。startControl と endControl は両側のパネル、center は表示切替、actions は保存操作を配置します。PlatformHeader.editorActions はレスポンシブナビゲーション、言語、テーマの操作を再利用します。onNavigate は未保存の変更を処理してからコールバックを実行します。狭い画面ではヘッダーは2行になり、サブメニューが先に Escape を処理します。
WorkspaceHeaderPortal.startControl と endControl は、ホストの対応するスロットに管理対象ページのパンルトグルを配置します。ホストはタイトル、ステータス、アクションに加えてオプションの startTarget と endTarget を公開します。ファイルライブラリと単一アセットワークスペースは workAreaControls を使用し、アセットプレビューは完全なヘッダーを維持するため、アイデンティティ、戻るアクション、およびパネルの宛先が利用可能です。ProjectWorkspace はコンテンツとファイルの共有左側ナビゲーション/会話の選択肢を所有します。ファイルは useProjectResourcePanel を通じて記憶されたリソースパネルの寸法を登録し、ProjectContentTools を通じてナビゲーションをポータル化し、ProjectToolbar.endControl を通じて右側のインスペクターコントロールのみを提供します。会話はプロジェクト領域全体で同じ左側レーンと埋め込みコンポーザーを使用し、コンパクトなリソース、会話、インスペクターのタスクは相互に排他的です。
EditorNavigationMenu
EditorNavigationMenu はホストの完全な SidebarNavigation を重ねて表示し、権限とプロジェクト情報を保ちながらキャンバスを動かしません。言語とテーマは下部に置き、サブメニューが先に Escape を処理します。集中モードとブラウザーの全画面は独立しています。移動は保存処理の完了を待ち、下書きを保護します。
WorkspaceNavigationMenu / WorkspacePageHeader
グローバルナビゲーションは Mac の Command+\、Windows/Linux の Control+\ を使用し、Creator 内でも独立して操作できます。T と Shift+T は引き続き編集レイアウトを操作します。編集可能な入力先、文字の組み立て中、繰り返し、処理済みのイベントは無視します。 ボタンのヒントと aria-keyshortcuts に組み合わせを表示し、グローバルナビゲーションは単独の T を使用しません。
ログイン後のワークスペースは PlatformHeader.workspaceActions で各画面幅のアカウントとナビゲーション領域を共有します。WorkspacePageHeader は見出しと操作を統一します。WorkspaceNavigationMenu は権限とコンテキストを保って現在のサイドバーを表示し、EditorNavigationMenu は互換エイリアスとして残ります。Studio は専用ツールバーを維持します。公開ページのヘッダー表示は変わりません。
WorkspaceNavigationGuard は dirty、busy、error と任意の onSave でグローバルナビゲーションを保護します。保存成功を確認して true を返した場合のみ移動し、失敗時は下書きを保持します。Language.onBeforeChange(apply) で言語変更にも同じ保護を適用できます。保存中はフォーム項目を無効にします。
デスクトップのナビゲーションは展開とアイコン表示を維持し、自動非表示を追加します。サイドバーとドロワーは検索とグループの状態を共有します。精密ポインターが端に 300ms 留まると一時表示され、離れて 320ms 後に閉じます。クリックすると開いたままになります。タッチとキーボードの操作ボタンも維持します。Dialog の既定値は modal={true} と autoFocus={true} です。一時表示では両方を false にして入力フォーカスとスクロールを維持します。
EditorViewControls
編集と集中を1つのボタンで切り替えます。編集中は「集中」、集中時は「編集」を表示します。クリックまたは T で切り替え、E で編集に直接戻れます。狭いヘッダーでも切り替えボタンを表示し、プレビュー、全画面、追加操作はその他メニューにまとめます。
EditorViewControls は編集/集中モードと画面全体の全画面表示を分けて制御します。プレビューは独立した切り替えで、終了時に以前の編集モードへ戻ります。独自の終了操作では useEditorWorkMode でモードを保持します。edit/focus/preview の値は引き続き有効です。プレビューはモードグループ内の radio から aria-pressed を持つ button に変わります。全画面表示はクリックで開始し、アプリのルートにナビゲーションとダイアログを含めます。非対応の場合は入口を表示しません。
Language / Appearance
Language と Appearance variant="menu" は、ラベル・現在値・矢印を表示する layout="row" に対応します。既定のコンパクト表示と言語切り替えの保護は維持されます。SiteHeaderCopy.helpResources と contactSupport でワークスペースのヘルプリンク名を任意に指定できます。
requestWorkspaceNavigation
サイドバーの切り替えボタンがあるページでは、折りたたみ時やモバイル表示でもヘッダーの重複メニューボタンを表示しません。エディターとサイドバーのないページには残します。@qokit/components/patterns/WorkspaceNavigation から requestWorkspaceNavigation(returnFocusTarget?) と useWorkspaceNavigationState() をインポートします。リクエストは登録済みドロワーを切り替え、利用できない場合は false を返します。任意の要素は閉じた後のフォーカス復帰先です。別の入口を表示する前に .available を確認してください。削除されたボタンの DOM 位置に依存せず、既存ボタンかこの API を使ってください。
WorkspacePanelReveal
グローバルナビゲーションにはメニューアイコン、編集ツールには左右のパネルアイコンを使います。useWorkspacePanelReveal({ temporary: true }) は集中モードでクリックやキーボードによる一時表示を提供します。toggle(trigger?) と close(true) はレイアウトと作業モードを保ち、閉じた後にフォーカスを戻します。画面端は全体ナビゲーション、ツールのホバー表示は各ボタン付近に限定します。プレビューではパネル切り替えを隠し、「編集に戻る」で直前の編集モードを復元します。
EditorViewControls / 表示モード
EDITOR_VIEW_SHORTCUTS → Tooltip + aria-keyshortcuts
EditorHeader は EDITOR_TOOLBAR_SHORTCUTS も管理します。Command/Control+S は表示中の EditorSaveButton を実行し、Shift+P は EditorStatusAction shortcut="publish"、Shift+M は編集ツールメニューを開きます。クリックと同じ有効なコントロールを使い、公開はパネル内で明示的に実行します。アクティブで表示中のヘッダーだけが応答します。子メニュー、ダイアログ、IME変換、キーリピート中は無効で、入力欄では保存のみ使えます。ヒントと aria-keyshortcuts は同じ定義を使います。独自の toolsControl はトリガーに aria-keyshortcuts={EDITOR_TOOLBAR_SHORTCUTS.tools.aria} を指定します。ActionMenu.triggerKeyShortcuts は属性とヒントのみを追加し、グローバルコマンドは登録しません。
パネル操作は Shift+A(追加)、Shift+L(ページ/レイヤー)、Shift+K(会話)、Shift+C(コンテンツ)、Shift+D(デザイン)、Shift+G(全体スタイル)です。CMS は利用可能な場合に Shift+S(設定)、Shift+E(SEO)、Shift+H(履歴)を提供します。EditorChoiceControl、EditorViewTabs、ActionMenu に shortcut メタデータを渡すとヒントを共有できます。EditorPanelChoiceShortcuts と携帯用の EditorViewControls.compactActions はメニューに折りたたんでも元の操作を維持します。EditorPanelShortcuts.commands はコントロールを複製せず既存操作を登録します。非表示、inert、無効、プレビュー、オーバーレイの制約は維持されます。同じワークスペースの非モーダルな携帯サイドバーではパネルを切り替えられますが、メニューとモーダルダイアログはショートカットを遮断します。修飾キーなしの既存操作は変わりません。
| 表示モード | |
|---|---|
E | 編集 |
T | 編集 ↔ 集中 |
V | プレビュー / 編集に戻る |
F | 全画面表示 / 全画面表示を終了 |
アクティブなエディターのみが応答します。文字入力中、IME変換中、キーの長押し中、子ダイアログやメニューが開いている間はモードを切り替えません。
PlatformHeader.workspaceNavigation
PlatformHeader.workspaceNavigation はグローバルナビゲーションをロゴの前に配置し、workspaceActions と editorActions はアカウント操作を保持します。ワークスペースは既存のサイドバー切り替えを再利用し、エディターの右パネル切り替えはアバターの前に配置します。狭い画面ではナビゲーション、ブランド、タイトル、アバターを上段、編集ツールと保存を下段に配置します。DOM の順序も配置に合わせ、枠線のないすりガラス表現を維持します。
2026-09-06 - EditorHeader.preview / EditorViewControls.returnView
EditorHeader.preview は center のみを枠線のないコンパクトなプレビュー操作部として表示し、ロゴ、アカウント、保存、パネル操作はマウントを維持して非表示にします。独立した LivePreviewToolbar を使う場合は編集ヘッダーを非表示にし、EditorViewControls.returnView(edit または focus)で元のモードを指定します。戻る操作と独立した全画面操作を残し、サイト自体のヘッダーは表示します。
2026-09-06 · Builder / CMS
Builder と CMS は、パネル、挿入図示、表示設定に BuilderWorkspace、EditorCatalog、EditorComponentSettings を共用します。プリセットは関連設定をまとめて適用し、既存の内容を保持します。保存と取り消しは各ホストが管理します。操作部はプラットフォームのテーマ、本文はサイトのテーマに従います。
サーバーでレンダリングするフッター · 2026-09-07
SiteFooterLayout には明示的な locale と単一言語の copy を渡します。Server Component が共通のフッター構造を描画し、テーマと言語の操作部および QR ダイアログは Client Component として動作します。既存の SiteFooter と PublicPlatformFooter のインターフェースも引き続き利用できます。
import { SiteFooterLayout } from '@qokit/components/patterns/SiteFooter';
<div className="qk-platform-footer-shell">
<SiteFooterLayout locale={locale} copy={footerCopy} />
</div>ドメインをまたぐリンクはサーバー側で copy.companyLinks に設定します。操作部のスロットは controls でカスタマイズできます。
EditorHeader.titleControl / FloatingAssistant.presentation
EditorHeader.titleControl と EditorWorkspace.titleControl は、通常のタイトルを共通のプロジェクトメニューに置き換えられます。内容が分かる title と、移動時の未保存変更の保護を維持します。FloatingAssistant.presentation="embedded" は、フローティングボタンや背景オーバーレイなしで、ホストパネル内に名前付き領域を表示します。既定値は floating です。配置と表示はホストが、会話状態と権限はアシスタントが管理します。
2026-09-07 · WorkspaceAssembly
WorkspaceAssembly はレイアウト用の要素を追加せず、移動元のカードと移動先の領域をマークします。直接の子要素を前提とする場合は、既存の DOM に workspaceAssemblyAttributes(part, index, phase) を付けます。EditorHeader.assemble と BuilderWorkspacePanels.assemble はエディター用のマークを提供します。
作成成功後にのみ await startWorkspaceAssembly(navigate, destinationPathname) を呼び出します。表示中の領域を撮影し、一度だけ移動して、移動先または対応する読み込み骨格を最大 720 ミリ秒で組み立てます。移動先には入場用の canvas マークが必要です。useWorkspaceAssemblyPending() で撮影領域の配置が完了するまで読み込み画面を保持し、データとコードを先読みします。動きを減らす設定や非対応ブラウザーでは直接移動します。遅延や中断時は撮影領域を解放して移動を続行します。マークだけでは編集、再読み込み、履歴移動をアニメーション化しません。一時スタイルの後処理は共通パターンが、作成エラー、冪等性、読み込み状態はホストが担当します。
2026-09 · 管理ワークスペース
WorkspacePage と WorkspaceLayout の variant は overview、list、detail、settings、editor です。WorkspaceFormFooter はホストが渡す actions、message、tone、busy を配置します。データ保存はホストの責務です。
幅の狭い WorkspaceDataTable と AdminDataTable はラベル付きレコードを標準表示し、選択、カスタム見出し、操作を維持します。比較表には mobileLayout="scroll" を指定します。WorkspaceFilterToolbar は検索とフィルターの後に並べ替えと表示切替を配置します。サイドバーは h2、ページは h1 を使用します。
2026-09-08 · Task focus
useSidebarTaskFocus(active) は集中作業中にナビゲーションを一時的に非表示にします。終了時は元の表示に戻りますが、ユーザーが明示的に変更した場合はその選択を優先します。自動非表示は保存済み設定を変更しません。
追加 API リファレンス(英語・翻訳準備中)
EditorHeader.contextMode="title" displays the editor's own titleControl instead of the host workspace picker. The default "host" behavior is unchanged; navigation, brand, account controls and leave guards retain their existing ownership. Hosts supply responsive placement for their title control.
EditorViewControls.focusInMenu shows a labelled preview action and moves focus mode into the shared menu. Its default remains false; view shortcuts and returning from preview keep the existing behavior.
EditorViewControls.toolsControl replaces the fallback menu with a host-owned tools control. Hosts retain its accessible trigger, menu state and actions; view buttons and keyboard shortcuts keep their existing behavior. Creator uses this slot for its complete editor tools menu beside Add, Layers and Preview.
EditorViewControls.responsiveLabels displays text beside focus and preview icons above 720px, reserving space for both focus labels. At phone widths the labels are hidden while accessible names and tooltips remain. EditorSaveButton.showStatusLabel displays saved/saving status or a retry action when state is provided; it reserves label space across states. Both options default to false.
ResizablePanels.middlePanelProps forwards section attributes such as inert to the middle panel, matching the existing side-panel attribute slots. An editor can keep its canvas mounted while preventing keyboard and pointer interaction when a compact conversation view covers it. Hosts still control panel visibility and restore focus when switching views; the prop does not unmount content.
ProjectSwitcher.currentWorkspaceId optionally marks the parent workspace independently of currentProjectId; only the current location receives the selected surface. IDs must match the supplied projects items. onActionSelect(action, event) lets the host guard shortcut navigation after the menu closes; omitted callbacks retain normal link behavior. Creation shortcuts use ordinary menu surfaces. Optional SiteHeaderCopy.projectSwitcherCreate and projectSwitcherWebsites label creation and the current workspace's website group without renaming the Creator product.
AccountDropdown.usageSummary is an optional slot below the account identity for host-supplied credit balances, plan usage and links to details. It also accepts ({ environmentInfo }) => ReactNode to place the shared ID disclosure and copy controls in the summary without duplicating them below. Links use role="menuitem" and retain menu keyboard behavior and navigation guards. The platform header shows credits and plan usage in two columns, with ID details expanding below; the sidebar account retains appearance and language. Failed reads never appear as zero, and reopening the menu refreshes the data.
PublicPlatformHeader.workspaceAction optionally supplies { href, label } for an authenticated visitor's return link. It replaces the desktop login icon and stays visible beside the mobile menu; the mobile menu then omits anonymous account actions. Session detection belongs to the host. The platform home uses a lightweight local session check, updates after focus/storage changes, and keeps ?view=public on its brand link so explicit website visits survive refresh.
contextAfter places editor-specific scope controls after the host project picker, preserving their DOM and keyboard order. The host retains project navigation and leave guards; the editor owns page and content-language selection. Hosts may adapt the responsive layout to put this context on its own row.
WorkspaceNavigationMenu.footerLinks supplies direct icon links alongside the sidebar display control. footerMenus accepts ordered WorkspaceNavigationFooterMenu entries, each with a label, icon and link items (with optional separatorBefore). The platform uses one menu for Website Home, Pricing, Templates and News, and a book-icon Help & Support menu for the user manual and contact support. The single footerMenu prop remains supported when footerMenus is omitted. Desktop menus open upward with ActionMenu placement="top" portal; mobile uses bottom sheets. The controls form one row when expanded and a column in icon mode; on mobile the sidebar control closes the navigation drawer. Each icon retains an accessible name and tooltip. profile adds the user name, plan and account menu without duplicating an existing sidebar account. Omitting footer links and menus retains the existing preferences and fullscreen actions.
Set a footer menu item's newTab to open a reference destination with target="_blank" and rel="noopener noreferrer". The skeleton adds a trailing arrow and localized screen-reader notice; other items keep current-page navigation. Website Home, Pricing, Templates, News, the manual and contact support use new tabs so the workspace stays open. An explicit public-home visit preserves ?view=public to bypass the signed-in landing redirect, including after refresh.
Editor tool palettes can use Dialog with keepMounted to preserve search and form state while closed. Closed dialogs immediately become inert, hidden from assistive technology, and leave the focus stack, including during a visual exit transition; the default still unmounts their content. Pair nonmodal palettes with DialogPanel to reuse the global overlay surface. Toolbar accepts a DOM ref for bounded positioning while retaining its shared arrow-key navigation.
useFloatingSurface from @qokit/components/patterns/FloatingTools supports defaultHeight: 'auto' for content-sized palettes. Keep the host body shrinkable with internal scrolling; the hook caps the surface to its workspace bounds and observes size changes. Moving an automatic palette stores its position without freezing the measured height. Resizing explicitly stores a fixed height, including across reloads; reset() or Home on a movement/resize handle restores automatic sizing. Numeric defaultHeight retains the existing fixed-height behavior.
FloatingToolPanel composes the shared DialogPanel, TreeToggle, pin button, tooltip and close button. Place it inside a nonmodal Dialog; the host controls pinned, collapsed, their callbacks and document operations. Pinning keeps the palette open after an operation; it does not lock its position. The title and header whitespace accept useFloatingSurface().dragHandle, while buttons, menus and inputs never initiate dragging or folding. Double-click the title or whitespace to fold; the explicit fold button supports keyboard and touch. Folding hides the body without unmounting it, preserving searches and tree state. Pass the same collapsed value to useFloatingSurface to retain the expanded height while moving the folded header. Optional actions and skin slots reuse the same structure; styles stay in the shared stylesheet.
Optional FloatingToolPanel.viewKey adds a short opacity transition when the active tool changes, without replacing its body instance. Ordinary parameter updates do not animate. Opening, closing, unfolding and pin feedback share the existing motion Tokens and respect reduced motion. Dragging stays direct; useFloatingSurface coalesces pointer movement to one geometry update per animation frame and saves the final position on release. Browsers without discrete display transitions close immediately.
Unified editors pass focus={false} to omit the separate Focus control. primaryActions accepts shared tool buttons before Preview; onTogglePanels handles T, and onToggleAllPanels handles Shift+T. Creator uses T to cycle from visible panels to floating launchers to fully hidden and back to the last visible layout; ordinary launcher clicks still open their panel. Shift+T directly hides everything and restores the exact preceding state. Both sidebar shortcuts are inactive in Preview and respect editable targets and active overlays. Existing hosts keep Edit/Focus behavior by default.
useWorkspacePanelVisibility().togglePanels hides the visible editor panels or restores their preceding layout. Desktop and compact layouts are remembered independently, and forceCollapsed (for example during Preview) does not overwrite that memory. The host owns global navigation visibility and any edge launchers.
For floating editor panels, pass skin: platformWorkspacePanelRevealSkin from @qokit/components/skins/platform and spread the returned panelProps onto the existing panel. The skin applies only while revealed; the docked panel and its mounted content remain intact. ResizablePanels merges startPanelProps, middlePanelProps, and endPanelProps class names with its own skin slots. Pair focus controls with Toolbar and platformFloatingToolbarSkin for shared keyboard navigation and compact spacing. Both skins share the global DialogPanel surface (background, shadow and blur); panel corners use the card radius and toolbar corners use the control radius. Hosts own positioning and available space, not a separate overlay palette.
useWorkspacePanelEdgeDrag is an opt-in hook for an existing workspace root ref. Mark its focusable borders with data-workspace-panel-edge="start" or "end"; ResizablePanels supplies these attributes on its own separators. The host provides each side's mode (expanded, icons, hidden), saved width and bounds through getState, applies onChange, and returns a rollback callback from onBegin. onResizing should suspend layout transitions; onFinish restores focus to the resulting control, and onReset restores the host's default width. One captured mouse or touch gesture crosses all three states, with RTL direction handling and cancellation on Escape, pointer cancellation or window changes. Arrow keys resize or step states, Shift increases the step, Home/double-click resets, and End expands to the allowed maximum. This hook adds no visual controls or stored content. Hosts can pair hidden borders with useWorkspacePanelReveal for temporary shortcut access while retaining their normal click actions; hosts without the hook keep existing resizer behavior.
FloatingAssistant.headerActionsTarget optionally accepts an HTMLElement in the host heading. The assistant portals its existing conversation history and new-conversation controls into that element and omits its internal header. Without a target, the original header remains. The host owns the heading and placement; the assistant retains action handlers, accessibility labels and conversation state. The Web adapter forwards this slot.
FeatureHint is exported from @qokit/components/patterns/FeatureHint. Use it for contextual first-use guidance attached to a real control. Provide a versioned id, a stable user scopeKey, an anchor: HTMLElement, an active eligibility signal, localized title, description, dismissLabel, and action: { label, onClick }. Set completed when the user discovers the capability independently. A null scope or unavailable anchor suppresses the hint.
The shared component allows one hint at a time, waits briefly for a visible target, follows scrolling and resizing, supports RTL, and keeps content inside the viewport. It does not add a backdrop, steal focus, or perform the action automatically. Escape, the close button, or clicking elsewhere dismisses it; Tab from the target reaches the action. The target receives a temporary highlight and accessible description. Seen hints are remembered in the current browser per scope and version, with an in-memory fallback if storage is unavailable; this is not cross-device progress. Hosts own permissions, review-state suppression and the actual action. skin, className and style adapt presentation.
AssistantContextCard is exported from @qokit/components/patterns/FloatingAssistant. Place it in composerContext to summarize the current editing target. Its typed contract includes title, description, scope, preview, parameters: { id, label, value }[], optional controls, status and notice, plus actions, onLocate and clearAction. Pass localized labels and formatted values, including units, from the host.
The card renders a read-only definition list, an optional controls slot for a few common adjustments, and a live status region. Reuse the host’s existing editing controls and commands in this slot; keep complete settings behind an explicit action that opens the existing inspector. Hosts retain ownership of selection, permissions, save, undo and AI requests. Conversation, canvas editing and inspector editing can operate together, with independent panel visibility. Selecting an object updates the card and an already open inspector without opening a closed panel or moving focus. Removing a conversation reference preserves canvas selection and direct editing; keep the conversation entry independent of this card and of floating-tool visibility. Changing the target or a parameter updates this live card without appending chat messages. Both draft and project conversations can use the same component. className, style and AssistantContextCardSkin support visual adaptation; styles are loaded with the component.
FloatingAssistantPanel.composerContext 接收输入框上方的实时上下文区域。提供此插槽时,顶部旧的 activeContext 摘要隐藏,activeContext.promptPlaceholder 仍供输入框使用。实时参数属于当前编辑状态,不应追加到历史消息列表;Web 适配器透传此插槽。
Hosts can set hoverReveal={false} to disable navigation previews from the trigger and window edge while retaining explicit controls and drag resizing; the default remains true.
WorkspaceNavigationDock prefetches same-origin destinations on mouse hover or keyboard focus, with bounded deduplication.
Web アダプターは FloatingAssistantPanel.composerAttachments も渡します。このスロットはメッセージフォーム内のテキスト入力欄の前に、ホストが管理する添付を表示します。配置と送信状態はホストが管理し、ドロップでは送信待ちに追加するだけです。成功時は送信した添付のみ解除し、失敗時は再試行のため保持します。
共通会話コンポーネント(英語リファレンス・翻訳待ち)
@qokit/components/patterns/Conversation exports ConversationPanel, ConversationMessages, ConversationMessage, ConversationSuggestions and ConversationComposer. Creator generation, draft refinement and the embedded project assistant use these structures and the same token-based stylesheet. Hosts own requests, history, permissions, selected objects and review/apply actions.
ConversationFeedback は InlineNotice を組み合わせ、会話内でタスクの状態、失敗、フォールバック、保存完了をコンパクトに表示します。ローカライズした title と、必要に応じて description、tone、action を渡します。両行はキャプションの文字サイズ、狭い間隔、透明な背景を使用し、色調で状態を強調しながら補足文は控えめに表示します。既定の role="status" と aria-atomic="true" は更新全体をまとめて読み上げます。対処が必要な失敗には role="alert" を使用します。アシスタントが作成した本文は引き続き ConversationText に配置します。
Place the scrollable ConversationMessages and the fixed ConversationComposer directly inside the panel. Supply a localized label for the messages region and inputProps for the controlled textarea. The composer accepts attachments, notice and actions slots, plus formProps and formRef; it creates the form, so do not nest it in another form. Enter inserts a newline; Cmd/Ctrl+Enter requests submission with composition and disabled/busy guards. Preserve user input while a request is running when the host supports it.
PromptPanel.presentation="conversation" reuses the composer while retaining reference reading, upload/menu controls and serialized form fields. The default "prompt" preserves the landing-page prompt behavior. FloatingAssistant.presentation="embedded" uses the shared panel, messages, suggestions and composer; floating assistants retain their compact presentation.
追加 API リファレンス(英語・翻訳準備中) · 2026-10
2026-10-10 · Pagination dot display
Pagination from @qokit/components/ui accepts pageDisplay="dots" for compact visual choosers. Combine it with layout="centered" for centered arrows and 6px indicators with 32px-wide click targets. Dot colors, hover and keyboard focus use shared theme Tokens; PaginationSkin.dot adapts the indicator slot. Hosts supply currentPage, totalPages, onPageChange and localized navigation labels. pageLabel names each dot; its fallback combines ariaLabel with the page and total. Browsing pages only invokes the host callback. The default "numbers" display retains numeric pagination and formatPageNumber.
2026-10-10 · ActionMenu search header
ActionMenu.dropdownHeader accepts host-owned content before the actions in both dropdown and mobile sheet presentations. onOpenChange reports opening and dismissal so hosts can reset transient search state. Search hosts supply localized copy, filtering and initial input focus; ArrowDown from the input should focus the first enabled result, then the shared menu handles result navigation, selection and Escape.
2026-10-09 · Inline ColorPicker
ColorPicker from @qokit/components/ui/ColorPicker accepts presentation="inline" to expand its editor beneath the field trigger. It renders a named group in the document flow, keeps the surrounding workspace available, and retains palette, HEX, opacity, gradient and reset capabilities. Hosts should reserve a full row for the field. Changes to the controlled value, including undo and reset, update the open inline editor; leaving the field finishes the current edit. The default "popover" presentation retains its portal, outside-click dismissal and Escape behavior.
2026-10-07 · WorkspacePanelGrid
WorkspacePanelGrid from @qokit/components/patterns/WorkspaceLayout places independent detail panels below the shortest available column. It responds to content and container size changes without moving or remounting child nodes; DOM and keyboard order remain unchanged. Narrow containers use one column. Keep continuous panels in one grid rather than separate rows. Metrics, tables, paired fields and ordered workflows retain their own layouts.
Each direct child is a panel. Use data-workspace-panel-span="full" or a numeric column span on that child's root for wider panels. The optional skin has a root slot and variables; --qk-workspace-panel-grid-gap controls shared spacing, and --qk-workspace-panel-grid-max-columns defaults to 2. Without JavaScript or ResizeObserver, panels retain the responsive ordinary grid.
2026-10-08 · Shared list toolbar groups
WorkspaceFilterToolbar now has one container-responsive contract across Projects, CMS and Admin:
query:search、状態のfilters、sort、業務用のcontrols、advancedオプション、条件付きのreset、リソースのresult、補助的なsummary。presentation:view、表示されるcontrolsおよびoptions(例えば、表示されている列とページサイズなど)を確認します。ページウィジェットの customization はページヘッダーアクションに属します。actions: persistent operations, followed by the optionalselectioncontrol at the logical end. UseToolbarButtonswithiconand localizedcompactLabelfor refresh and other familiar actions.
The shared component measures its own available width. Controls show icons with labels above 960px and accessible icon buttons at or below 960px. At or below 640px, search occupies the first row and tool groups wrap in query → presentation → actions order. Routes must not override group widths or hide individual labels. ControlMenu and ViewMenu inherit this presentation without a route-specific responsive flag.
リソース名と結果件数には query.result={{ label, count, total?, locale? }} を使います。共通の WorkspaceResultSummary は「名前 · 件数」を表示し、信頼できる未絞り込みの総数が異なる場合のみ「/ 総数」を追加します。数値は UI 言語で整形し、双方向テキスト内で分離します。件数が不明な間は result を省略します。ゼロは有効です。同じ一覧の上に名前と件数の行を重複させないでください。AdminFilterBar.result も同じオブジェクトを受け取ります。ページ見出し、意味のある節見出し、ページ送り、選択件数はそれぞれの役割を保ち、別単位、検索条件、更新情報には query.summary を使います。
Give overflow a localized label to move advanced and display options into More when compact. query.compactItems and presentation.compactItems supply complete menu choices replacing their corresponding controls; controlled values and callbacks remain in the host. Permanent menu actions use overflow.items. Selection and refresh stay outside More. Select and Done share the end slot, hit target and reserved idle toolbar height, including wrapped mobile rows.
This replaces the old flat toolbar API: migrate search, filters, sort, reset and secondaryControls into query; migrate view and display controls into presentation; move persistent endActions to actions. The former adaptive / inline-wrap CSS modes and WorkspaceFilterControlGroup capsule are removed; use these three semantic groups rather than compatibility aliases.
2026-10-10 · EditorItemDisclosure
EditorItemDisclosure from @qokit/components/patterns/EditorItemCollection accepts title, summary, open, onOpenChange, leading, actions and children for editing within a list. Sibling items remain visible. Escape collapses the item and restores trigger focus; opening does not scroll or autofocus. useEditorItemDisclosure scopes single-item expansion with scopeKey and restores adjacent focus after deletion. EditorItemCollection uses the same interaction; hosts still own content, ordering, persistence and undo. The existing EditorFocusedItem export remains available for flows that require a separate detail view.
API補足リファレンス(英語・翻訳待ち) · 2026-10
2026-10-15 · Shared inspector choices
EditorStyleChoice uses the shared EditorChoiceControl for finite settings. In auto mode, two or three illustrated options use a segmented group; larger illustrated sets use a portalled ControlMenu showing the current icon and name. Text-only choices retain a native Select. Existing custom values remain selectable.
選択肢とメニュー項目では annotation によりテーマ色の点を付け、その意味をローカライズしてアクセシブル名に含められます。ControlMenu のトリガーにも現在の項目の点が表示され、triggerAnnotation: null を指定するとメニュー内だけに表示されます。有効な選択済み項目を再選択すると onReselect が呼ばれます。ネイティブの選択肢ではラベルの横に説明を表示し、hidden はプレースホルダーを候補一覧から除外します。印を付ける値と選択時の動作はホストが決め、共有コントロールは継承を推測せず、データを書き込みません。
Use presentation="visual" for labeled diagram choices and presentation="toolbar" for familiar tools such as four-way text alignment. The toolbar has separate targets without a shared capsule. Native radios, shared menu keyboard handling, visible focus, disabled states and theme Tokens are retained. Hosts own labels, allowed values, persistence and undo. id identifies the control; ControlMenu also accepts triggerId and disabled.
Inspector menus, inputs, collapsed summaries and reset actions share a 32px mouse field height, restored to 40px on narrow screens and coarse pointers. Field icons use 16px and diagram choices keep an 8px gap. EditorComponentSettings reuses these choices for columns, density, image fit and aspect ratio, while composition layouts retain detailed previews. If saving briefly disables native radios, the shared skeleton restores focus to the selected option for continuous arrow-key editing.
Inspector labels and diagram captions use the 12px caption scale; values, actions and section titles use the 13px field scale. Visual choices have no decorative outer border: a soft selected surface and centered caption identify the current option, while keyboard focus retains its ring. Font specimens in the inspector use a compact, bounded scale.
2026-10-15 · Responsive workspace tables
WorkspaceDataTable reflows mobileLayout="records" into two columns of labeled facts, with the primary identity and sticky end actions spanning the record. Names and identifiers can use two lines. Column labels and selection remain accessible. Comparison tables using mobileLayout="scroll" retain their columns.
When a host toolbar already provides sorting or other header actions, set mobileHeader="labels" to remove duplicate header controls from the mobile layout and tab order. Column names remain available to assistive technology; desktop headers are unchanged. The default "controls" preserves custom header controls on mobile.
2026-10-14 · Independent editor panels
resolveWorkspaceResponsiveProfile and useWorkspaceResponsiveProfile from WorkspacePanels, and EditorWorkbenchChrome, accept the optional panelPolicy="independent". With BuilderWorkbenchFrame and the platform editor skin, both panels remain docked above the mobile threshold. Shared styles temporarily compress displayed widths while retaining remembered sizes, and the canvas fits the remaining space. Effective work areas at or below 720px retain mobile task switching.
Hosts own panel visibility. When supplying a measured profile, use the same policy for the measurement hook and Chrome. Omitting panelPolicy retains the default "adaptive" policy with its existing desktop, two-column and overlay layouts.
Editor workspace integration
workspaceNavigation connects the host's shared business navigation through EditorWorkbenchChrome: desktop navigation reserves space beside the content, while mobile uses the shared drawer. It is separate from the document structure panel navigation and retains the host's permissions and unsaved-change protection.
EditorSaveButton.showIcon keeps the save glyph beside its label. iconOnly reduces the control to an icon while retaining an accessible action and status name and tooltip. Editor hosts can use useCompactWorkspaceHeader() to show icons and labels in roomy layouts and icons alone in compact layouts. EditorStatusAction.iconOnly follows the same rule while retaining its issue count.
2026-10-15 · EditorControlGroup title actions
The headerActions slot on EditorControlGroup remains visible in both expanded and collapsed groups, for actions such as content visibility beside a group title. Pointer and keyboard interactions with these actions do not toggle the group. summaryActions still appears only when collapsed. Hosts own action names, state and persistence; icon actions must use the shared IconButton with a localized accessible name.
2026-10-14 · Management groups and summaries
WorkspaceSectionGroup, WorkspaceSection, WorkspaceFieldGrid and WorkspaceFacts are exported from @qokit/components/patterns/WorkspaceLayout. Headings and descriptions sit above their content panels on both desktop and mobile, sharing the starting edge. Use the default stacked layout; legacy layout="split" callers also render stacked. Apply qk-workspace-section-group__form to forms within a group to share spacing and save-area alignment. WorkspaceSection accepts optional icon, actions and description slots, keeping headings outside the content panel.
WorkspaceFieldGrid arranges independent short fields in at most two columns according to available width. WorkspaceFacts renders a semantic definition list with stable id, label, value, and optional unit, description, emphasis and tone. columns supports 2, 3 or 4 columns and adapts to narrow containers. Set mobileColumns={2} for short numeric summaries that should retain two columns on phones; the default is one. It is unboxed so summaries can share an existing content panel. Each component supports its named Skin, className and style. Hosts retain form state, permissions, submission, conflicts and recovery; these components do not make requests.
2026-10-14 · Management content panels and disclosures
WorkspaceContentPanel and WorkspaceSection.kind support summary, form, records, and actions. Section toolbar stays outside the content surface; supporting and footer provide compact metadata and end operations. titleId preserves existing heading anchors. The default panel container does not override a host's named container.
Use WorkspacePanelBlock, WorkspacePanelMeta, and WorkspaceRecordRow for subordinate groups, metadata, and repeated records. A record accepts title, description, meta, status, actions, and full-width detail children. Facts always align at the top. Hosts retain business fields, permissions, table columns, and submission boundaries.
WorkspaceActionRow accepts an optional action label or quiet empty/loading status, alongside description and actions. Action identity uses 14px semibold text, status uses 14px regular text, and descriptions use 12px. Copy and controls share a center line on desktop and stack at narrow widths. Card surfaces do not override descendant strong typography or spacing.
WorkspaceDisclosure accepts title, optional status, and children; WorkspaceDisclosureGroup accepts Accordion items and controlled expansion props. They start closed unless the host specifies an initial item, and open at most one sibling. Enter/Space toggles; Escape closes and returns focus to its trigger, handling inner disclosures before their parent. Hidden panels retain their DOM and input state. Optional headingLevel supplies section heading semantics; Skin and class slots only adapt appearance. Import these components from @qokit/components/patterns/WorkspaceLayout.
CustomizableWidgetLayoutControls / CustomizableWidgetLibrary
CustomizableWidgetLayoutControls を、モバイルを含む、コンテキストヘルプの後および主要アクションの前にページヘッダーアクションに配置します。アクションを明示的に命名するためにローカライズされた copy.customize を使用してください(例:「ウィジェットをカスタマイズ」)。アイコンのみのエントリーは aria-pressed と aria-expanded を公開し、編集中は copy.done になります。customizeButtonRef はホストのフォーカス復帰用のトリガーをオプションで公開し、disabledCustomize はジオメトリを変更せずにエントリーを無効にします。ウィジェットの折りたたみをサポートするホストに対してのみ onCollapseToggle と areWidgetsCollapsed を供給してください。これらを省略すると、カスタマイズエントリーのみがレンダリングされます。
CustomizableWidgetLibrary は共通のライブラリ見出し、リセット/閉じるアクション、レスポンシブスクロールレイアウト、初期の閉じるボタンフォーカス、および Escape 処理を所有します。閉じると、フォーカスがまだライブラリ内にある場合、呼び出し元のコントロールにフォーカスが戻ります。外部クリックはその宛先フォーカスを維持します。ホストはウィジェット定義、追加/削除/順序付け/リサイズコマンド、永続化、およびリセットセマンティクスを維持します。CMS および Admin クラスのスロットはドメインフックのために利用可能ですが、個別のライブラリサーフェスやモバイルレイアウトを定義してはいけません。
2026-10-17 · Rich ActionMenu triggers
ActionMenu.renderTrigger は SelectableTile のようなリッチなコントロールをトリガーとして再利用できます。これは aria-expanded、aria-haspopup、disabled、および onClick を受け取り、実際のトリガーに展開します。ホスト側はコントロールの選択セマンティクスと外観を保持します。ポータル位置決め、メニューのキーボードナビゲーション、閉じる動作、フォーカスの戻し、およびオプションのモバイルシートは引き続き ActionMenu が管理します。デフォルトのボタンおよびアイコンのトリガーに変更はありません。
角丸と範囲コントロール
@qokit/components/ui/RangeNumber の RangeNumber は、ネイティブの範囲スライダーと正確な数値を入力する Input を組み合わせます。label、value、min、max、任意の step と unit、onChange を渡します。未定義の値は混在を示すダッシュになり、どちらかを変更すると範囲内の単一値が設定されます。onCommit により連続変更をホストの既存の取り消し履歴にまとめられます。disabled、キーボード操作、コンパクトな密度、RTL、フォーカス表示は共通で、永続化はホストが担当します。RangeNumberSkin はルート、スライダー、入力、単位のスロットを提供します。
@qokit/components/patterns/EditorRadiusControl の EditorRadiusControl は、形状のライブプレビュー、物理的な四隅の入力、RangeNumber、任意の形状プリセットを組み合わせます。value と onChange は CSS border-radius の一括指定を使用し、cornerLabels とプリセット名はホストが翻訳します。RTL でも左上、右上、右下、左下の順です。max を指定すると編集は制限付きピクセル値になり、省略すると CSS 単位と楕円の角丸構文を維持します。混在する角丸は四隅を一括設定するまで単一の数値を表示しません。任意の EditorRadiusControlSkin は状態や永続化を変えずにルート、図、プレビュー、プリセットのスロットを調整します。
2026-10-22 · 狭い画面でのアクティブなナビゲーションタブ
PillTabs は任意の scrollActiveTabIntoView を受け取り、既定値は false です。水平タブでは選択時やサイズ変更時に、直接の子であるアクティブな PillTabLink または PillTabButton を表示範囲へ移動します。スクロールするのはタブ列だけで、ページ位置やキーボードフォーカスは変わりません。LTR と RTL に対応し、動きを減らす設定でも即座に補正します。垂直タブとこのオプションを省略した呼び出しの動作は変わりません。