デザイン契約の更新
Qokit が公開するデザイン Token、コンポーネント API、および統合契約の変更履歴。
デザイン契約の更新
2026-10-21 · スクロールメニューの固定操作
ActionItem.pinned は start または end を受け取り、操作と ActionMenu.dropdownHeader をスクロール一覧の外に固定します。キーボード移動と選択は全領域に対応します。ポータルのホストは、トリガーの展開方向で測定した --qk-menu-available-height で高さを制限できます。pinned を省略すると既存のメニュー構造を維持します。
2026-10-17 · ウィジェットのカスタマイズエントリー
ページウィジェットの customization は、プロジェクト、コンテンツ、ダッシュボード間で共有されるヘッダーエントリーを使用します。CustomizableWidgetLayoutControls はオプションの customizeButtonRef と disabledCustomize を追加し、折りたたみコントロールはオプションです。CustomizableWidgetLibrary はホスト間でモバイルジオメトリ、初期フォーカス、Escape キーおよびフォーカス復帰を共有します。ウィジェットの永続化とコマンドは引き続きホストが所有します。ウィジェットカスタマイズ統合をご覧ください。
2026-10-17 · マネージドワークベンチパネルコントロール
WorkspaceHeaderPortal はオプションの startControl と endControl を受け取り、一致するオプションのホストターゲットを持ちます。マネージドファイルビューは、単一アセットの編集とプレビューと同じヘッダーパネルスロットとワークエリアジオメトリを使用します。既存のホストは引き続きタイトル、ステータス、アクションのみを提供し続けることができます。EditorHeader 統合をご覧ください。
2026-10-17 · 測定済みエディタのデフォルト値
useWorkspaceResponsiveProfile は、利用可能なワークエリアの寸法のためにオプションの onWidthChange(width) を追加します。useEditorLayout は構成された共有幅制限をホストストレージにも適用し、readEditorLayout は第4引数としてオプションの制限を受け入れます。既存の呼び出し元はデフォルト値を維持します。Component Integrationをご覧ください。
2026-09-26 · Creator · スタイル設定集
詳細な間隔 · v3: site.theme.spacingOverrides 按 desktop/tablet/mobile → sectionPadding (0–240px), pageGutter, cardGap (0–96px). --qk-site-custom-{sectionPadding|pageGutter|cardGap}-{desktop|tablet|mobile}. 980px / 720px.
ボタンとリンク: primaryButtonStyle, secondaryButtonStyle (solid/outline), buttonFontSize (12–24px), linkUnderline (always/hover/none), linkHoverStyle (none/tint). --qk-site-{primary|secondary}-button-{background|color|border|shadow}, --qk-site-button-font-size, --qk-site-button-size-{sm|md|lg}, --qk-site-link-decoration, --qk-site-link-hover-decoration, --qk-site-link-hover-background. initial → 自動.
詳細な色: mutedColor, borderColor, buttonTextColor, cardSurfaceColor 与对应 dark* 字段 (--qk-site-color-card-rgb).
2026-09-09 · グローバルナビゲーションのショートカット
SidebarNavigation / WorkspaceNavigationMenu: グローバルナビゲーションは Mac の Command+\、Windows/Linux の Control+\ を使用し、Creator 内でも独立して操作できます。T と Shift+T は引き続き編集レイアウトを操作します。編集可能な入力先、文字の組み立て中、繰り返し、処理済みのイベントは無視します。
2026-09-08 · EmptyState
プロジェクトおよび CMS 記事・商品の作成案内は、中央配置、透明な背景、簡潔な文字階層、折り返し可能な操作を備えた EmptyState を共有します。icon、layout、style、description は任意です。タイトルは h2 になりました。独自の strong セレクターは title skin スロットへ移行してください。複数操作は共通コンテナーを使用し、権限と作成処理はホストが管理します。
2026-09-08 · SidebarNavigation
SidebarNavigation はマウスの 180 ミリ秒の滞留またはキーボードフォーカスで同一オリジンのルートを先読みします。固定・ポップアップナビゲーション全体で 30 秒あたり最大 8 件です。オフライン、非表示タブ、Save-Data、2G では停止し、ダウンロード、無効なリンク、新規ウィンドウ、同一ページのアンカーは対象外です。遷移と未保存変更の保護は維持します。
2026-09-08 - Primary button foreground
ピル形の主ボタンは Logo の青 #4695D8 を維持し、明暗両テーマで文字、アイコン、読み込み表示を白にします。ホバー時の軽い明るさ調整は維持します。補助ボタンと危険操作の色は各意味に従います。
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 は既存の色から派生します。
ピル形の主ボタンは --accent-action を通じて Logo の青 #4695D8 を直接使用し、暗いグラデーションを廃止します。ホバー時のみ白を8%混ぜて明るくします。文字はブランドの墨色に黒を10%混ぜ、読みやすさを保ちます。ナビゲーションの強調は同じブランド青の淡い背景とテーマに応じた文字色を維持します。
ドロップダウンとワークスペース切り替えは --menu-option-font-size(14px)と --menu-option-font-weight(500)、行高 1.45 を共有します。選択項目の太さは 600、補助情報は 12px/400 です。WorkspaceNavigationDock はマウスホバーやキーボードフォーカス時に同一オリジンの遷移先を先読みし、重複記録数を制限します。既存の離脱保護とホストのルートを維持します。
2026-09-07 - ColumnLayout
ColumnLayout は固定ナビゲーション、独立したスクロール領域、追従するページツールバーでデスクトップ管理画面全体を使用します。WorkspacePage は平坦な区切りと共通の角丸 Token を使用します。860px 以下ではナビゲーションはドロワーとなり、閉じている間は操作できません。プロパティと業務動作は変わりません。重複する外側の余白を除き、読みやすい幅の制限はフォーム内に適用してください。
2026-09-05 · WorkspaceNavigationMenu / WorkspacePageHeader
ログイン後のワークスペースは PlatformHeader.workspaceActions で各画面幅のアカウントとナビゲーション領域を共有します。WorkspacePageHeader は見出しと操作を統一します。WorkspaceNavigationMenu は権限とコンテキストを保って現在のサイドバーを表示し、EditorNavigationMenu は互換エイリアスとして残ります。Studio は専用ツールバーを維持します。公開ページのヘッダー表示は変わりません。
WorkspaceNavigationGuard は dirty、busy、error と任意の onSave でグローバルナビゲーションを保護します。保存成功を確認して true を返した場合のみ移動し、失敗時は下書きを保持します。Language.onBeforeChange(apply) で言語変更にも同じ保護を適用できます。保存中はフォーム項目を無効にします。
2026-09-05 · EditorNavigationMenu
EditorNavigationMenu はホストの完全な SidebarNavigation を重ねて表示し、権限とプロジェクト情報を保ちながらキャンバスを動かしません。言語とテーマは下部に置き、サブメニューが先に Escape を処理します。1120px 以下ではヘッダーを2行にし、メニューに現在の表示モードを示します。集中モードとブラウザーの全画面は独立しています。移動は保存処理の完了を待ち、下書きを保護します。
2026-09-05 · EditorHeader
EditorHeader は現在のエディター内にホストのロゴ、アカウント、グローバルメニューを維持します。startControl と endControl は両側のパネル、center は表示切替、actions は保存操作を配置します。PlatformHeader.editorActions はレスポンシブナビゲーション、言語、テーマの操作を再利用します。onNavigate は未保存の変更を処理してからコールバックを実行します。狭い画面ではヘッダーは2行になり、サブメニューが先に Escape を処理します。
2026-09-05 · SidebarToggleSlot
SidebarToggleSlot は既存のサイドバー切替ボタンをワークスペースのヘッダーに配置します。左サイドバーにつきスロットを1つ使用します。状態、ショートカット、モバイルドロワーは引き続き SidebarNavigation が管理し、スロットがなければ従来の位置を使います。モバイルドロワーもヘッダーのボタンで閉じ、閉じた後は同じボタンにフォーカスが戻ります。
2026-09-05 · EditorWorkspace / Dialog / Segmented
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 は共通ビュー操作を受け取ります。保存、公開、権限は引き続きホストが管理します。
2026-09 · EditorWorkspace
EditorWorkspace は全画面ダイアログ、フォーカス管理、レスポンシブなパネルを提供します。dirty で変更の破棄を確認し、busy で保存中の終了を防ぎ、onSave で Ctrl/Cmd+S を処理します。権限、データ、保存、公開は利用側のアプリが管理します。
2026-08 · コンパクトな指標密度
- 高密度の運用ワークスペース向けに、
MetricCardに対して任意のdensity="compact"API を追加しました。 - 既存のデフォルト密度および DOM セマンティクスは変更していません。
- コンパクトなパディング、数値スケール、最小高さを共有コンポーネントスタイルに統一し、ルート側での視覚的なオーバーライドを不要にしました。
2026-07 · フォームコントロールの統一
@qokit/components/uiにFormField、Input、Textarea、Checkbox、RadioGroup、Switchを追加しました。- 共有の
FormFieldスケルトンにより、ラベル、説明、エラー、必須ステータス、ARIA 参照を関連付けます。 Input、Textarea、Select、SearchFieldを 40px、44px、48px のサイズおよび共有インタラクション Token に統一しました。- 新しいフォームベースコンポーネント用に、プラットフォーム、Admin、生成サイト Skin のレシピを追加しました。
- 既存の
.qk-fieldスタイルは、後方互換性のある移行パスとして維持されます。
2026-07 · ボタンのサイズとタイポグラフィ
--button-font-size-sm、--button-font-size-md、--button-font-size-lgの3つのセマンティック Token を追加しました。Buttonのsm、md、lgはそれぞれ固定で 14px、15px、16px のフォントサイズを使用し、Header、Dialog、またはページコンテナのフォントサイズを継承しなくなりました。- サイトの Skin でボタンのタイポグラフィを調整する場合は、対応するセマンティック Token を上書きしてください。ルートの class を介して
font-sizeを再定義しないでください。
2026-07 · プラットフォーム共通ナビゲーションのスケルトン
- ログイン依存のない
PlatformHeaderを追加し、プラットフォームとドキュメントサイトで同じセマンティックスケルトンを共有します。 PublicPlatformHeaderとbuildPublicHeaderNavItemsを追加し、プラットフォームの匿名状態とドキュメントサイトで共通の Header コンポーネントおよびナビゲーション設定を再利用します。HeaderNavItemにmenuタイプを追加しました。デスクトップ版 Header では閉じ可能なドロップダウンメニューを使用し、モバイル版 Header では自動的にリンクグループに展開されます。SiteFooterにオプションのbrandHrefとcontrolsを追加し、公開ドキュメントなどの異なる統合シナリオに対応します。PublicPlatformFooterを追加し、プラットフォームとドキュメントサイトで共通の Footer Shell を共有し、クロスドメインでのプラットフォームリンク解決を許可します。- これらはすべて後方互換性のあるオプション API であり、既存のプラットフォーム Header の状態ロジックと Footer のデフォルトコントロールは変更されません。
2026-07 · 公開デザインガイドライン
- 公開デザイン契約と内部 AI 実装仕様を分離しました。
- 公開されたビジュアル Token、コンポーネントのインポート、Skeleton/Skin の境界、Button、Card、およびアクセシビリティ要件を明確化しました。
- 破壊的なコンポーネント変更には必ずマイグレーション手順を提供することを明記しました。
- 公開検索、Sitemap、および LLM の出力では、外部依存として安全な内容のみを含めることを規定しました。
互換性に関する説明
-
新規追加のオプション属性、オプションの Skin スロット、およびセマンティック Token は通常、後方互換性を維持します。
-
属性の削除やリネーム、デフォルトの DOM/セマンティクス/キーボード動作の変更は破壊的変更となります。
-
破壊的変更については、本ページで影響範囲、代替 API、およびマイグレーション手順を説明します。
-
2026-09-06: デスクトップのナビゲーションは展開とアイコン表示を維持し、自動非表示を追加します。 SidebarNavigation / WorkspaceNavigationMenu / Dialog
-
2026-09-06: EditorViewControls は編集/集中モードと画面全体の全画面表示を分けて制御します。 EditorViewControls
-
2026-09-06:
LanguageとAppearance variant="menu"は、ラベル・現在値・矢印を表示するlayout="row"に対応します。既定のコンパクト表示と言語切り替えの保護は維持されます。SiteHeaderCopy.helpResourcesとcontactSupportでワークスペースのヘルプリンク名を任意に指定できます。 Language / Appearance -
2026-09-06: サイドバーのあるページでは重複するヘッダーメニューボタンを削除し、既存の切り替えボタンとナビゲーション API を維持します。 WorkspaceNavigation
-
2026-09-06: グローバルナビゲーションにはメニューアイコン、編集ツールには左右のパネルアイコンを使います。 WorkspacePanelReveal / EditorViewControls
-
2026-09-06: 表示モード ·
E/T/V/F·Segment.shortcut. EditorViewControls -
2026-09-06:
PlatformHeader.workspaceNavigationはグローバルナビゲーションをロゴの前に配置します PlatformHeader.workspaceNavigation
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-06 - EditorViewControls
編集と集中を1つのボタンで切り替えます。編集中は「集中」、集中時は「編集」を表示します。クリックまたは T で切り替え、E で編集に直接戻れます。狭いヘッダーでも切り替えボタンを表示し、プレビュー、全画面、追加操作はその他メニューにまとめます。 EditorViewControls
2026-09 · 管理ワークスペース
幅の狭い WorkspaceDataTable と AdminDataTable はラベル付きレコードを標準表示し、選択、カスタム見出し、操作を維持します。比較表には mobileLayout="scroll" を指定します。WorkspaceFilterToolbar は検索とフィルターの後に並べ替えと表示切替を配置します。サイドバーは h2、ページは h1 を使用します。
2026-09-08 · Task focus
useSidebarTaskFocus(active) は集中作業中にナビゲーションを一時的に非表示にします。終了時は元の表示に戻りますが、ユーザーが明示的に変更した場合はその選択を優先します。自動非表示は保存済み設定を変更しません。
追加 API リファレンス(英語・翻訳準備中)
Optional FloatingToolPanel.viewKey animates tool changes without remounting the body. Shared opening, closing, unfolding and pin feedback respect reduced motion; pointer geometry updates run at most once per animation frame. Closed Dialog keepMounted surfaces become inert and hidden from assistive technology immediately, including during an exit transition. Existing props and document state ownership are unchanged.
The opt-in useWorkspacePanelEdgeDrag hook connects existing workspace borders to expanded, icon and hidden states in one mouse or touch gesture, with keyboard resizing, RTL and cancellation. ResizablePanels now marks its separators with data-workspace-panel-edge; existing hosts retain their behavior until they enable the hook. Hosts own widths, state, focus and visual skins. See the integration contract.
追加 API リファレンス(英語・翻訳準備中) · 2026-10
2026-10-08 · Workspace title navigation
WorkspaceLayout and WorkspacePageHeader accept optional backControl before the title. Use WorkspaceBackButton with a localized label and the existing href or onClick; it supplies an icon, accessible name, Tooltip and RTL mirroring. Hosts retain return destinations, list state and navigation guards. Existing headers without this slot keep their layout.