デザインシステムが提供するものの概要。テーマ: signal。言語: 日本語。
コンポーネントにはなれない形。中身は呼び出す側しか知らないからです。セクションのカード、データのグリッド、開閉メニュー、そしてシェル自身の枠組み。tokens.css がクラスを配り、マークアップはアプリが書きます。以下はすべて ui.Styleguide が返すサンプルそのもので、ui のテストが tokens.css と突き合わせているのも同じものです。
リンクは動きません。サンプルのソースは別に用意しています。
余白のあるセクションカードと、その外側に置く見出しです。
rst-list と rst-card に余白がないのは意図です。これらは行の連なりを収めるもので、余白は各行が自分で持ちます。フォームや段落、リンクの帯など、行でないものを直に入れると枠線にぴったり付いて描かれます。文字が縁に触れているのがその印です。任意の内容を入れる余白付きのカードは rst-box で、その見出しは直前に置く兄弟の rst-box-head です。
<div rst-box-head><h2>Payout</h2><a rst-btn href="/payout/edit">Edit</a></div>
<section rst-box><p>Everything on a screen sits inside boxes.</p><div rst-box-foot>Last updated 2 hours ago</div></section>ヘッダーのはみ出しメニューや一覧バーの絞り込みの正体である details/summary のメニューと、適用中の絞り込みを表す取り外せるチップです。
<details rst-dropdown name="rst-menus">
<summary>Filter<span rst-caret aria-hidden="true"><svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span><span class="rst-sr-only">Filter orders: Paid</span></summary>
<div rst-dropdown-menu>
<a aria-current="true" href="/orders?status=paid">Paid</a>
<details rst-menu-group name="rst-menus-price" open><summary>Price</summary><div><a href="/orders?price=free">Free</a></div></details>
</div>
</details>
<span rst-ftok><span rst-ftok-k>Paid</span><a href="/orders" aria-label="Remove filter Paid">✕</a></span>フォームにリズムと保存バーを与える属性です。これらを出力する部品はありません。呼び出し側が組み立てたフィールドの連なりを包むものです。
<form rst-form-flow method="post" action="/settings">
<div rst-field>
<label rst-field-label for="name">Name</label>
<input rst-input type="text" id="name" name="name">
</div>
<div rst-field>
<label rst-field-label for="email">Email</label>
<input rst-input type="email" id="email" name="email">
</div>
<div rst-field-row>
<div class="rst-grow" rst-field>
<label rst-field-label for="city">City</label>
<input rst-input type="text" id="city" name="city">
</div>
<div rst-field>
<label rst-field-label for="zip">ZIP</label>
<input rst-input="short" type="text" id="zip" name="zip">
</div>
</div>
<div rst-form-bar>
<span rst-form-bar-note>Changes save immediately.</span>
<div rst-form-actions>
<a rst-btn href="/settings">Cancel</a>
<button rst-btn="primary" type="submit">Save</button>
</div>
</div>
</form>ヘルプ記事にリンクする、枠付きの疑問符です。CSS のツールチップは飾りで、リンク自身が文としてのラベルを持っています。
<a rst-help rst-tip href="/help/orders" target="_blank" rel="noopener" aria-label="Help: orders" data-tip="About orders"><svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="10"/><path d="M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3"/><path d="M12 17h.01"/></svg></a>データテーブルの本当の語彙です。列を決めるのはカードで一度きり、行はセルを選ぶだけです。
画面は1本の列です。page-header、次に section-header とカード、その次の section-header とカード、と読む順に並びます。横並びは、それを備えた書き方だけのものです。rst-box-head、rst-field-row、rst-lbar、rst-lrow のセル、rst-seg-tabs。
<div rst-card style="--rst-cols: 2fr 110px 32px">
<div rst-lrow="head"><span>Order</span><span class="rst-m-hide">Status</span><span></span></div>
<div rst-lrow>
<a class="rst-nm" href="/orders/AB3PX"><bdi>Grace Hopper</bdi><small>AB3PX · <bdi>grace@example.com</bdi></small></a>
<span class="rst-m-hide rst-cell-mut">Paid</span>
<details rst-row-menu name="rst-menus"><summary aria-label="Actions for order AB3PX"><svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><circle cx="12" cy="12" r="1"/><circle cx="12" cy="5" r="1"/><circle cx="12" cy="19" r="1"/></svg></summary>
<div rst-row-menu-panel><a href="/orders/AB3PX">View</a><hr><button type="submit" class="rst-danger">Refund order…</button></div>
</details>
</div>
<p rst-no-match>No orders match. <a href="/orders">Clear filters</a></p>
</div>
<p rst-count-line>Displaying <strong>1–20</strong> of <strong>412</strong></p>モーダルはクライアント側の状態ではなく、それ自体がひとつの URL です。下の画面を inert にし、その上にパネルを置き、閉じるのはただのリンクです。
<div rst-backdrop inert>
<div rst-page><h1>Settings</h1></div>
</div>
<div rst-modal-overlay>
<dialog rst-modal-panel open aria-labelledby="modal-title">
<nav>
<a href="/settings/profile" aria-current="page">Profile</a>
<a href="/settings/billing">Billing</a>
<a href="/settings/notifications">Notifications</a>
</nav>
<section>
<a rst-modal-close href="/settings" aria-label="Close settings">✕</a>
<h2 id="modal-title">Profile</h2>
<p>Update the name and photo shown across the account.</p>
</section>
</dialog>
</div>本来あるべき URL で、動いているところを見る (新しいタブで開きます).
選択モードで一覧の行が身につけるチェックボックスです。そのラベルは、その行が何であるかを言い直します。
<label rst-selbox><input type="checkbox" aria-label="Select order AB3PX"></label>sidebar シェル自身の枠で、800px を下回ると details の開閉に畳まれます。
<div rst-shell-sidebar>
<a rst-skip href="#main">Skip to content</a>
<details rst-shell-chrome><summary><svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 12h16"/><path d="M4 6h16"/><path d="M4 18h16"/></svg>Menu</summary></details>
<aside rst-shell-rail><a rst-shell-brand href="/">Notes</a>
<nav rst-shell-nav><span rst-shell-group>Work</span><a href="/" aria-current="page">Dashboard</a><a href="/reports">Reports</a></nav>
</aside>
<main rst-shell-main id="main"><div rst-page>Content.</div></main>
</div>サイドバーのシェルのデモを開きます。単独のプレビューです。 (新しいタブで開きます).
トップバーのシェル自身の枠組みを、マークアップとして示したもの。Layout はこれをひとつのテンプレートとして提供します。
<div rst-shell-topbar>
<a rst-skip href="#main">Skip to content</a>
<header rst-shell-bar><a rst-shell-brand href="/">Notes</a>
<details rst-shell-menu name="rst-shell-menu"><summary><svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M4 12h16"/><path d="M4 6h16"/><path d="M4 18h16"/></svg>Menu</summary></details>
<div rst-shell-tail>
<nav rst-shell-nav><a href="/" aria-current="page">Home</a><a href="/archive">Archive</a></nav>
<details rst-dropdown rst-shell-account name="rst-menus"><summary>Account<span rst-caret aria-hidden="true"><svg class="icon" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="m6 9 6 6 6-6"/></svg></span></summary>
<div rst-dropdown-menu><a href="/settings">Settings</a></div></details>
</div>
</header>
<main rst-page id="main">Content.</main>
<footer rst-shell-foot>Made with rastrillo</footer>
</div>トップバーのシェルのデモを開きます。専用のプレビューです。 (新しいタブで開きます).
ダッシュボードの上部に並ぶ数値の行です。
<div rst-stats>
<div rst-stat="lead"><span rst-stat-label>Revenue this month</span><span rst-stat-num>€48,210</span><span rst-stat-delta rst-tone="positive">+12%</span><span rst-stat-note>vs. last month</span></div>
<div rst-stat><span rst-stat-label>Orders today</span><span rst-stat-num>318</span></div>
<div rst-stat><span rst-stat-label>Average basket</span><span rst-stat-num>€41.20</span><span rst-stat-delta rst-tone="negative">−3%</span></div>
<div rst-stat><span rst-stat-label>Refunds</span><span rst-stat-num>7</span></div>
</div>枠付きのカードで、中身はスイッチが入っている間だけ :has() で表示されます。本当の状態はスイッチであり、表示は見せ方の都合にすぎません。
<div rst-tblock>
<label rst-tblock-head><input type="checkbox" name="notify" checked>
<span rst-switch-track aria-hidden="true"></span>
<span><span rst-tblock-title>Email notifications</span><span rst-tblock-desc>Sent for every reply to a thread you're in.</span></span>
</label>
<div rst-tblock-body>
<div rst-field>
<label rst-field-label for="notify-freq">Frequency</label>
<input rst-input type="text" id="notify-freq" name="notify_freq" value="Daily digest">
</div>
</div>
</div>