メインコンテンツへスキップ
menu palettetanreidark_modetranslate

カラーモード

コントラスト

デザインシステム

ギャラリーのシステムは、Tanrei でどこまで表現できるかを示すために、ほかのデザインシステムを模して作ったものです。サポート対象のデザインではなく、あくまで例です。

リンクをコピーテーマを編集
palettetanrei

カラーモード

コントラスト

デザインシステム

ギャラリーのシステムは、Tanrei でどこまで表現できるかを示すために、ほかのデザインシステムを模して作ったものです。サポート対象のデザインではなく、あくまで例です。

リンクをコピーテーマを編集
はじめにWebReactSwiftUIJetpack ComposeFlutterReact Nativeプリセット自分のデザインシステムを作るAI エージェントと Tanrei を使うブランドデザイントークンデザインシステムとカスタマイズTheme Studioカラータイポグラフィアイコン形状エレベーションモーションインタラクション状態振る舞いレイアウトサイズと密度アクセシビリティ言葉カラートークンタイプスケールトークン形状トークンエレベーショントークンモーショントークン状態トークンスペースと寸法のトークンコンポーネントボタンメインアクションボタンセグメントボタンcupertino, m3-like にありボタングループメニュー付きボタンツールバーコピーボタンチェックボックスラジオボタンスイッチチップメニュースライダースライダーフィールドカレンダーDateTimePickerフィールドグループラジオグループチェックボックスグループセレクトセレクトフィールドメニューバーファイルアップロードファイルピッカー 上級者向けドロップゾーンレーティングテキスト入力欄 上級者向けテキストフィールドチップフィールドフィールドコンボボックス 上級者向けコンボボックスフィールド数値入力欄 上級者向け数値フィールドカラー入力欄 上級者向けカラーフィールドワンタイムコード入力欄 上級者向けワンタイムコードフィールド埋め込みテキスト入力欄 上級者向けチャットコンポーザーカード区切り線モーダルレイヤー 上級者向けダイアログリストリスト行ボトムシートサイドシートカルーセルコードブロックテーブルポップオーバーステップアコーディオン説明リスト図アプリシェルページヘッダーツリービュータイムライン画像プレビューハンドルサイズ変更できる枠分割ビュースクロールエリアサイズトランジションバッジプログレスインジケーターメーターナンバーティッカーローディングインジケータースナックバーツールチップキーボードショートカットタグインラインコードコールアウトアバター空の状態タググループスケルトンファイル項目色見本マーキーテキストタブタブビューアプリバーナビゲーションバーナビゲーションドロワー検索リンクページネーション前後のリンクステッパーパンくずリスト目次リンクカードFAB メニューm3-like にありステータスTanrei の作り方コントリビューションライセンスと帰属
ホームコンポーネント分割ビュー

分割ビュー

横に並んだ、または上下に積んだ 2 つのペインと、その間の線の上にあるハンドルです。人はハンドルをドラッグし、キーボードで動かし、または押して、片方のペインに広さを与えます。許可すれば、片方のペインを畳んで戻すこともできます。

content_copyMarkdown で表示
カテゴリ
コンテインメント
トークン
comp.split-view
レベル
合成
構成要素
Handle

概要

Web
tanrei-split-view
clock_loader_40
SwiftUI
TanreiSplitView
radio_button_unchecked
Jetpack Compose
TanreiSplitView
radio_button_unchecked
Flutter
TanreiSplitView
radio_button_unchecked
React Native
SplitView
radio_button_unchecked

生成元 docs/status/status.json, specs/split-view.spec.json

メッセージの一覧と、開いたメッセージ。一覧は Enter かハンドルの押下で畳めます

受信トレイ — 24 件
ペインの間の線をドラッグするか、Tab で線に移動して矢印キーを使ってください。

分割ビューは、1 つの領域に 2 つのものを置き、その間の広さを人が配り直せるようにします。メッセージの一覧と開いたメッセージ、クエリとその結果、キャンバスとその設定などです。ペインの間の区切り線にはハンドルがあります。ドラッグすると線が動き、キーボードで動かすと 1 刻みずつ動きます。ドラッグせずに押すと、主のペイン(primary)を畳んで戻します。畳めないペインでは、指定した割合へ線を動かし、もう一度押すと元に戻します。

分割ビューは主のペインが領域に占める割合を value(パーセント)として保ち、人が割合を変えたことを知らせ、支援技術が読めるように、その割合をハンドルの値として渡します。

Web では <tanrei-split-view> です。ほかのプラットフォームはまだ実装していません。

使い方

<!-- 一覧と詳細。一覧は 240 ピクセルより狭くならず、畳むこともできます。 -->
<tanrei-split-view id="mail" collapsible min-size="240" label="メッセージ一覧の大きさを変更" style="block-size: 100dvh">
  <nav slot="start" aria-label="メッセージ">…</nav>
  <main slot="end">…</main>
</tanrei-split-view>

<!-- クエリとその下の結果。 -->
<tanrei-split-view axis="vertical" value="40" label="エディターの大きさを変更" style="block-size: 600px">
  <div slot="start">…</div>
  <div slot="end">…</div>
</tanrei-split-view>

<script type="module">
  import '@tanrei/web/components/split-view';
  const mail = document.querySelector('#mail');
  // 次に訪れたときも、その人の割合を保ちます。
  mail.value = Number(localStorage.getItem('mail-list')) || 30;
  mail.addEventListener('change', (e) => localStorage.setItem('mail-list', String(e.detail.value)));
</script>
import { SplitView } from '@tanrei/react';

<SplitView
  collapsible
  value={share}
  collapsed={collapsed}
  minSize={240}
  label="メッセージ一覧の大きさを変更"
  onChange={(e) => setShare(e.detail.value)}
  onToggle={(e) => setCollapsed(e.detail.collapsed)}
>
  <nav slot="start" aria-label="メッセージ">…</nav>
  <main slot="end">…</main>
</SplitView>

仕様

構成要素

構成要素

Web パッケージが描くフィクスチャ horizontal の上に描いています。
パーツ 説明
1 start-pane The pane at the start: the inline-start side while the panes stand side by side, the top while one stands above the other. It takes its size from the split and holds the product's content, clipped to it.
2 end-pane The pane at the end, which takes the room the start pane and the divider leave, or the other way round when it is the primary pane.
3 divider The hairline between the two panes, across the whole region.
4 handle The Handle, centred on the divider: medium, with the axis of the split, its value the primary pane's share. Its target reaches over both panes; its drawing, states, cursor and keys are the Handle's own.

プロパティ

プロパティ 型 既定値 説明
axis horizontal | vertical "horizontal" Which size the split divides, as the Handle names it. horizontal: the width — the panes stand side by side and the divider is upright. vertical: the height — one pane stands above the other and the divider lies across.
primary start | end "start" Which pane the value measures and which one folds away: the start pane (a list beside its detail, a navigation beside a page) or the end pane (an inspector after a canvas). The other pane takes the rest.
value number 50 The primary pane's share of the region's size along the axis, less the divider, in percent. It is drawn held between the least and the greatest share (SPV-16) and kept as given while the region's size changes. While the pane is folded away it is the share the pane comes back at. The split view writes it as the person moves the divider; the product may set it.
min number 10 The least share of the primary pane, in percent, while it is not folded away. minSize may hold it larger (SPV-16).
max number 90 The greatest share of the primary pane, in percent: 100 less the least share the other pane keeps. maxSize may hold it smaller (SPV-16).
minSize number null The least size of the primary pane in pixels along the axis, while it is not folded away, on top of min ("the list is never narrower than 240"). Null sets none. Where the region is too small for both minSize and maxSize, minSize wins (SPV-16).
maxSize number null The greatest size of the primary pane in pixels along the axis, on top of max. Null sets none (SPV-16).
step number 5 How far one arrow key moves the divider, in percent of the region.
largeStep number 20 How far Shift with an arrow key, Page Up or Page Down moves the divider, in percent of the region.
resetValue number 50 The share a press on the Handle without a drag, Enter or Space moves the primary pane to while it cannot be folded away; the next press moves it back to where it was (SPV-7).
collapsible boolean false Lets the primary pane be folded away: by Enter or a press on the Handle, and by a drag past half its least share. Its content is then not drawn, not reachable and not read, and the divider stands at the region's edge to bring it back.
collapsed boolean false Whether the primary pane is folded away. The split view writes it as the person folds and restores the pane; the product may set it. Ignored while collapsible is false.
label string "" The Handle's accessible name, saying what the divider resizes in the product's words ("Resize the message list"); the primary pane's own heading, where it has one, is a good name. Never drawn. Required: a split view without one still works, and its Handle reports the missing name in debug builds (HDL-8).
valueText string "" Read in place of the percentage where another reading is natural ("List 320 pixels wide"), as the Handle's value text; the split view does not write it. Empty reads the percentage.
disabled boolean false Keeps both panes at their sizes: the Handle is drawn as unavailable and cannot be moved, folded or reached by Tab (HDL-15). The panes' content stays as operable as it is.

スロット

スロット 説明
start The content of the start pane.
end The content of the end pane.

イベント

イベント 説明
resize The divider moved during a drag: emitted in every frame it moves, with the primary pane's share in percent and whether the pane is folded away.
change The person changed the primary pane's share: once when a drag ends, and once for each key or press that moved it. Carries the new value. Not emitted when the product sets value.
toggle The person folded the primary pane away or brought it back: by Enter, a press on the Handle or a drag. Carries the new collapsed value. Not emitted when the product sets collapsed.

状態

振る舞い

EARS 記法による要件です。各プラットフォームの実装は、この ID に対応するテストで検証されます。要件の原文は仕様ファイルのものをそのまま掲載しています。

ID 要件
SPV-1 THE split view SHALL lay out its two panes along its axis — side by side WHILE axis is horizontal, the start pane at the inline-start; one above the other WHILE axis is vertical, the start pane on top — with a divider comp.split-view.divider.width thick in comp.split-view.divider.color between them across the whole region, the primary pane its share (value, held as SPV-16 says) of the region's size along the axis less the divider and the other pane the rest; each pane SHALL clip its content to its own box and SHALL draw nothing else of its own. THE split view SHALL take the size the layout gives it; WHILE axis is vertical it divides the height the layout gives it.
SPV-2 THE split view SHALL place one Handle centred on its divider, at size medium and with the axis of the split, its value the primary pane's share as drawn in whole percent, its min 0 WHILE collapsible is true and the least share (SPV-16) otherwise, and its max the greatest share, as the Handle draws and exposes them (HDL-1, HDL-5, HDL-8); its target SHALL reach over both panes without moving their content, and it SHALL be in the focus order after the start pane's content and before the end pane's. THE split view SHALL relate the Handle to the primary pane as the element it controls (the window splitter pattern's controls relation), where the platform has that relation, by the means the Handle gives whoever places it to relate it to another element (HDL-26 on the web).
SPV-3 WHILE a drag holds the Handle (HDL-6) THE split view SHALL move the divider with the press, at every frame and without a motion of its own: the primary pane's share SHALL be the share it had when the drag began (0 WHILE it was folded away) plus the distance the Handle reports along the axis, as a share of the region less the divider, signed so that the divider moves the way the press moves, held between the least and the greatest share (SPV-16); THE split view SHALL emit resize at every frame the share drawn changes and, WHEN the drag ends and the share differs from the one the drag began with, change once with the new value. WHILE a drag lasts every embedded document in either pane SHALL take no pointer, so that the drag is not lost over it (HDL-6).
SPV-4 WHILE collapsible is true and a drag holds the Handle THE split view SHALL fold the primary pane away WHEN the press moves the divider past half of the least share toward the pane, and bring it back at the least share WHEN the press moves it back past that point, at every frame and without a motion of its own; a pane a drag folds away SHALL keep the share it had when the drag began as its value, to come back at; WHEN the drag ends with the pane folded away or brought back THE split view SHALL emit toggle once with the new collapsed value.
SPV-5 WHEN the Handle emits step (HDL-9, HDL-10) THE split view SHALL move the divider at once, without a motion: the way the key points by step percent of the region for amount one and by largeStep for amount large, held between the least and the greatest share (SPV-16); to the least share for amount limit with direction −1 (Home) and to the greatest for amount limit with direction 1 (End) whichever pane is primary, as the window splitter pattern gives Home the primary pane's smallest size and End its largest; and SHALL emit change once WHEN the share changed. A step SHALL NOT fold the pane away. WHILE the pane is folded away, a step that would give it room and Home SHALL bring it back at the least share, and End at the greatest, emitting toggle and change; a step that would take room from it SHALL change nothing.
SPV-6 WHILE collapsible is true, WHEN the Handle emits activate (HDL-7: a press without a drag, Enter or Space) THE split view SHALL fold the primary pane away WHILE it is shown and bring it back at the share it had before WHILE it is folded away, over comp.split-view.motion.collapse-duration with comp.split-view.motion.collapse-easing, and emit toggle once with the new collapsed value; focus SHALL stay on the Handle.
SPV-7 WHILE collapsible is false, WHEN the Handle emits activate THE split view SHALL move the divider to the share resetValue gives the primary pane, held between the least and the greatest share, over comp.split-view.motion.collapse-duration with comp.split-view.motion.collapse-easing, and WHEN it emits activate again before the share was changed in another way SHALL move it back to the share it had before, emitting change once each time, so that two sizes are reached without a drag (WCAG 2.5.7); WHILE the share is resetValue already and there is no share before to go back to, activate SHALL change nothing.
SPV-8 WHILE the primary pane is folded away THE split view SHALL give it no size and draw nothing of it, SHALL make its content unreachable by focus and hidden from assistive technology, SHALL give the other pane the whole region less the divider, and SHALL keep the divider and the Handle at the region's edge on the folded pane's side, with the Handle's value 0, so that the pane can be brought back by every input that folded it.
SPV-9 WHEN the product sets value or collapsed after the first frame THE split view SHALL move the divider to the new place over comp.split-view.motion.resize-duration — over comp.split-view.motion.collapse-duration WHEN collapsed changes — with comp.split-view.motion.collapse-easing, going on from the place then shown WHEN it changes again during the motion (MOT-2), and SHALL emit neither change nor toggle; THE split view SHALL draw its first frame at its value without a motion (MOT-3), and WHERE motion is reduced SHALL move the divider at once (MOT-6).
SPV-10 WHILE the divider moves by a motion (SPV-6, SPV-7, SPV-9) THE split view SHALL change the panes' sizes in the layout at every frame, their content laid out to the size then shown and fixed to each pane's start edge, and SHALL scroll nothing to bring a part of either into view (MOT-5).
SPV-11 WHEN the region's own size changes — the window or an enclosing pane is resized or turned — THE split view SHALL keep the primary pane's share and lay both panes out again at once, without a motion, and emit nothing.
SPV-12 WHERE the layout direction is right-to-left and axis is horizontal THE split view SHALL place the start pane at the right and the end pane at the left, and the divider SHALL still move the way a press or an arrow key points (HDL-17), so that the Right Arrow moves it to the right whichever pane is primary; it SHALL take its layout direction from where it is used, SHALL have no direction setting of its own, and SHALL NOT mirror its panes' content.
SPV-13 WHILE disabled is true THE split view SHALL keep both panes at their sizes and the primary pane folded or shown as it is, and its Handle SHALL take no input and no focus (HDL-15); the panes' content SHALL stay as operable as it is.
SPV-14 WHERE the platform draws with a person's own forced colors THE split view SHALL draw its divider in the platform's text color; the Handle draws itself as HDL-16 says.
SPV-15 IF min is below 0, max above 100, min above max, or value, resetValue, step or largeStep is not a finite number, or step or largeStep is not above 0, THE split view SHALL use the default of each value it cannot use, hold value between the least and the greatest share, and in debug builds report the values; IF minSize or maxSize is neither null nor a finite number of 0 or more THE split view SHALL ignore it and in debug builds report it; WHEN axis or primary names a value the split view does not define it SHALL use the default and in debug builds report it; WHILE label is empty the Handle reports its missing name (HDL-8).
SPV-16 THE split view SHALL hold the primary pane, while it is shown, between a least and a greatest share: the least the greater of min and minSize pixels as a share of the region's size along the axis less the divider, the greatest the lesser of max and maxSize pixels as such a share, each within 0 and 100; WHERE the region is too small for the least to stay at or below the greatest, the least SHALL win, as a least size wins over a greatest one in CSS. WHEN the region's size changes THE split view SHALL count both again and draw value held between them, keeping value as it was given (SPV-11).

プラットフォーム別の名前対応

パリティは API が同一であることを意味しません。同じ契約を、各プラットフォームの流儀で表現します。

仕様 Web SwiftUI Jetpack Compose Flutter React Native
コンポーネント tanrei-split-view TanreiSplitView TanreiSplitView TanreiSplitView SplitView
axis · プロパティ axis axis axis axis axis
primary · プロパティ primary primary primary primary primary
value · プロパティ value value value value value
min · プロパティ min range.lowerBound valueRange.start min min
max · プロパティ max range.upperBound valueRange.endInclusive max max
minSize · プロパティ minSize minSize minSize minSize minSize
maxSize · プロパティ maxSize maxSize maxSize maxSize maxSize
step · プロパティ step step step step step
largeStep · プロパティ largeStep largeStep largeStep largeStep largeStep
resetValue · プロパティ resetValue resetValue resetValue resetValue resetValue
collapsible · プロパティ collapsible isCollapsible collapsible collapsible collapsible
collapsed · プロパティ collapsed isCollapsed collapsed collapsed collapsed
label · プロパティ label label label label label
valueText · プロパティ valueText valueText valueText valueText valueText
disabled · プロパティ disabled .disabled(_:) enabled enabled disabled
resize · イベント resize onResize onResize onResize onResize
change · イベント change value (Binding) onValueChange onChanged onValueChange
toggle · イベント toggle isCollapsed (Binding) onCollapsedChange onCollapsedChanged onCollapsedChange
備考 <tanrei-split-view label="Resize the message list"><div slot="start">…</div><div slot="end">…</div></tanrei-split-view>. A flex row (a column while axis is vertical) in the shadow root: the start pane, the divider with the <tanrei-handle> centred on it, and the end pane; the primary pane's box is its share of the region less the divider, and the other takes the rest. The split view sets aria-controls on its Handle to the id of the primary pane's box, which the Handle moves to its separator (HDL-26). A folded pane's box is inert, and its content visibility: hidden once the fold's motion has ended. A motion is AnimatedSize on the primary pane's box. Attributes are kebab-case (min-size, max-size, large-step, reset-value, value-text). resize, change and toggle are CustomEvents that bubble and are composed, whose detail carries value and collapsed. Drawn by Tanrei with a layout that splits a geometry reader's size, not HSplitView (macOS only, with its own divider) or NavigationSplitView (a navigation structure). A Layout that measures the region and places the two panes and the TanreiHandle; enabled is the inverse of disabled. A CustomMultiChildLayout of the two panes and the TanreiHandle; a folded pane is wrapped in Offstage and ExcludeSemantics. Two Views sized by flex basis from the measured region, and the Handle between them; a folded pane is display: 'none'.

トークン

トークン 参照先 解決値(ライト)
--tanrei-comp-split-view-divider-color sys.color.outline-variant #000000 · 8%
--tanrei-comp-split-view-divider-width sys.border.hairline 1px
--tanrei-comp-split-view-motion-collapse-duration sys.motion.role.resize.large 400ms
--tanrei-comp-split-view-motion-collapse-easing sys.motion.easing.spatial cubic-bezier(0.2, 0, 0, 1)
--tanrei-comp-split-view-motion-resize-duration sys.motion.role.resize.default 300ms

フィクスチャ

基準となる描画パターンです。全プラットフォームが同じ ID でスナップショットを撮り、結果を比較できるようにしています。

生成元 specs/split-view.spec.json, tokens/comp/split-view.tokens.json, design/tokens/

ガイドライン

使う場面

2 つのものを一緒に使い、それぞれにどれだけ広さを与えるかを人が決めるべきところで使います。

必要なもの 使うもの
縁で大きさを変える箱が 1 つだけで、広さを譲る相手がない サイズ変更できる枠。
ページの横に出入りする補足の内容で、幅はそれ自身が持つ サイドシート。
ページの横のナビゲーションで、配置はページの骨組みが決める アプリシェルのナビゲーション領域。
3 つ以上のペイン 分割ビューのペインの中に、もう 1 つの分割ビューを入れます。それぞれの線が自分のハンドルを持ちます。

主のペイン

primary は、value が測り、畳まれるペインを指します。start(既定)は詳細の横の一覧やページの横のナビゲーション、end はキャンバスの後ろのインスペクターです。もう一方のペインは領域の残りを取ります。axis="horizontal"(既定)ではペインが横に並び、先頭のペインは行の先頭側にあります(右から左のレイアウトでは右)。axis="vertical" では先頭のペインが上になります。

分割ビューはレイアウトが与える大きさを取ります。縦の分割ビューには分ける高さが必要です。高さを与えるか、高さのある箱に入れてください。

割合とその限度

value は、主のペインが区切り線を除いた領域に占める割合で、単位はパーセントです。min と max(既定は 10 と 90)は、どちら向きにも行き過ぎないようにします。minSize と maxSize はピクセルでもペインを抑えます(「一覧は 240 ピクセルより狭くしない」)。広いウィンドウでも狭いウィンドウでもペインが読めるようにするためです。領域が狭くて両方を守れないときは、CSS で min-width が max-width に勝つのと同じく、minSize が勝ちます。領域の大きさが変わっても、設定した割合は保たれ、限度だけが数え直されます。イベントは発火しません。

矢印キーは線を領域の step パーセント(5)ずつ動かし、Shift と矢印キー、Page Up と Page Down は largeStep(20)ずつ動かします。ドラッグとキーにはすぐに追従します。畳む操作、線を動かす押下、利用者側が設定した割合や畳み状態は短いモーションで動き、視差効果を減らす設定ではすぐに動きます。

ペインを畳む

collapsible を付けると、Enter、Space、またはハンドルの押下で主のペインが畳まれ、同じ操作でもう一度、元の割合で戻ります。ペインの最小の割合の半分を越えるドラッグでも畳まれます。畳まれている間、中身は描かれず、届かず、線は領域の端に立ちます。畳んだどの操作でもペインを戻せるようにするためです。collapsed が畳み状態で、value はペインが戻るときの割合です。

collapsible がないとき、ハンドルを押すと線は resetValue(50)へ動き、もう一度押すと元の場所へ戻ります。ドラッグできない人も、1 回ずつの押下で 2 つの大きさに届きます。

知らせること

イベント いつ
resize ドラッグで線が動く描画のたびに。描かれている割合の value(畳まれている間は 0)と collapsed を運びます。
change 人が割合を変え終えたとき。ドラッグが終わった、キーで線を動かした、押して線を動かした、のいずれかです。その人の割合を保つなら、ここで保存します。
toggle 人がペインを畳んだとき、または戻したとき。

利用者側が設定した value や collapsed では、どれも発火しません。

推奨

  • ハンドルには、何の大きさを変えるかを言う名前を label で付けます(「メッセージ一覧の大きさを変更」)。主のペイン自身の見出しがよい名前になります。
  • ペインの中身がまだ使える最小の大きさを設定します。割合だけで足りないところでは minSize を使います。
  • その人の割合と畳み状態は、また戻ってくる場所に保ちます。change と toggle から保存します。

非推奨

  • 畳んだときに中身へ届くほかの手段がないペインを、畳めるようにしない。
  • 自前のハンドルや溝を描かない。分割ビューの区切り線とハンドルは、それぞれのトークンで見た目を変えます。
  • 2 つのペインには狭すぎるウィンドウで分割ビューを使わない。そこでは 1 つずつ見せます。それはページが決めることです。

アクセシビリティ

ロール
separator (the Handle: focusable, with a value) between two panes that have no role of their own
ラベル付け
The Handle is named by label and exposes the primary pane's share in whole percent as its value (0 while the pane is folded away), with min (0 while collapsible, the least share otherwise) and the greatest share as max, valueText where given, and the primary pane as the element it controls. The panes are not landmarks of their own: a product that needs them as regions names a landmark inside each.
最小ターゲット
見た目のサイズが小さくても、ヒット領域は最小ターゲットサイズを満たします。 minimum 36px · pointer 36px · spacing 8px · touch 36px

キーボード操作

キー 動作
Tab Reaches the Handle between the start pane's content and the end pane's.
矢印キー of the axis Move the divider by step percent the way the key points; with Shift by largeStep.
Page Up または Page Down Move the divider by largeStep.
Home または End Give the primary pane its least share (min, or minSize) or its greatest (max, or maxSize), whichever pane is primary.
Enter または Space While collapsible: fold the primary pane away, or bring it back where it was. Otherwise: move the divider to resetValue, and back.

備考

  • WAI-ARIA APG, Window Splitter: a focusable separator whose value is the primary pane's position, valuemin where the primary pane is smallest (typically 0), valuemax where it is largest, aria-controls naming the primary pane; arrow keys move it the way they point, Enter collapses and restores, Home gives the primary pane its smallest size and End its largest. Here Home and End stop at the least and the greatest share, and folding away is Enter's alone among the keys, so that a key held down never folds a pane by accident.
  • F6 to move between panes, which the pattern lists as optional, is not taken: web browsers give F6 to their own toolbar and address bar.
  • Dragging movements (WCAG 2.5.7): a press on the Handle without a drag folds and restores the pane, or moves the divider between resetValue and the share before (SPV-6, SPV-7), and the keys reach every share.
  • A drag over an embedded document keeps going (HDL-6): a pane that holds an iframe does not swallow the press.
  • The steps are percentages of the region, as react-resizable-panels counts them (5 for an arrow key); minSize and maxSize hold a pane to pixels on top of them, for a list that must stay readable in a wide window and a narrow one alike.

生成元 specs/split-view.spec.json, tokens/sys/measure.tokens.json

コンポーネントが担うこと

  • ハンドルはフォーカスできる区切り(ARIA Authoring Practices のウィンドウスプリッター)で、label で名前が付き、主のペインの割合を整数のパーセントで値として持ちます(ペインが畳まれている間は 0)。最小値は最小の割合(ペインを畳めるときは 0)、最大値は最大の割合で、主のペインを操作対象として指します。
  • フォーカス順では、先頭のペインの中身と末尾のペインの中身の間にあります。
  • ハンドルの軸の矢印キーは、右から左のレイアウトでも、キーの指す向きに線を動かします。Home は主のペインに最小の割合を、End は最大の割合を与えます。キーのうち畳むのは Enter だけなので、押し続けたキーでペインが不意に畳まれることはありません。パターンが任意とする F6 は、ブラウザーが自分のツールバーへの移動に使うため、ブラウザーに任せます。
  • Enter、Space、またはドラッグなしの押下でペインを畳んで戻すか、線を resetValue へ動かして戻すので、ドラッグせずに大きさに届きます。
  • ドラッグの間は、どちらのペインの埋め込み文書もポインターを受け取らないので、ポインターがその上を通ってもドラッグは途切れません。
  • 畳まれたペインは inert です。中の何もフォーカスを受け取らず、支援技術も読みません。
  • 強制カラーモードでは、区切り線はテキストの色になります。ハンドルはハンドル自身の規則で描かれます。

利用者側で行うこと

  • 分割ビューに label を付けます。ないときもハンドルは描かれて動きますが、デバッグビルドで報告されます。
  • ペインはそれ自体ではランドマークではありません。ペインがページの領域であるときは、ランドマークをその中に置きます(<nav aria-label="メッセージ">、<main>)。
  • 許可するすべての割合で、最小の大きさから上まで、各ペインの中身が使えることを確かめます。