跳到內容
選單
語言,而家係廣東話
EnglishGaeilge简体中文Españolहिन्दीPortuguêsবাংলাРусский日本語廣東話Tiếng Việtالعربية

rastrillo 設計系統

設計系統提供嘅嘢嘅概覽。主題:plain。語言:廣東話

日期、數字同名

點樣顯示日期、數字、金額、名同地址,同埋邊啲會俾人搞亂。

日期同時間

將日期放入 <time> 標籤,並附上一個電腦讀得到嘅寫法。顯示嘅日期就照你讀者習慣嘅樣去寫。rastrillo 唔會幫你格式化。

預覽
<section rst-box>
  <dl rst-detail>
    <dt>Published</dt>
    <dd><time datetime="2026-08-02">2 August 2026</time></dd>
  </dl>
</section>

件事用咗幾耐

時間長度都係用 <time>。機器讀嘅寫法睇落有啲怪:PT2H30M 即係 2 個鐘 30 分鐘。

預覽
<section rst-box>
  <dl rst-detail>
    <dt>Build time</dt>
    <dd><time datetime="PT2H30M">2h 30m</time></dd>
  </dl>
</section>

數字

長數字要分開,等人一眼睇得出:英文寫 54,173,德文寫 54.173,阿拉伯文寫 ٥٤٬١٧٣。唔好將長數字就咁一串咁顯示。喺表格入面用等寬嘅數字,咁啲欄先會對得齊。

預覽
<div rst-stats>
  <div rst-stat><span rst-stat-label>Members</span><span rst-stat-num>54,173</span></div>
  <div rst-stat><span rst-stat-label>Messages</span><span rst-stat-num>1,284,902</span></div>
</div>

金額

rastrillo 淨係識寫美元。其他嘅就要你自己格式化。無論點,金額都要存做整數嘅仙,唔好用小數。

預覽
<section rst-box>
  <dl rst-detail>
    <dt>Payout</dt>
    <dd>$1,284.50</dd>
  </dl>
</section>

百分比同進度條

想顯示樣嘢有幾滿就用 <meter>,想顯示件工作做到邊就用 <progress>。個數字一定要寫喺條 bar 旁邊。淨係一條 bar,對睇唔到嘅讀者嚟講咩都冇講到。

預覽
<div rst-box-head><h2>Photo storage</h2></div>
<section rst-box>
  <span rst-meter><meter rst-meter-bar value="82" min="0" max="100" aria-hidden="true"></meter><span rst-meter-num>412 / 500</span></span>
</section>
<div rst-box-head><h2>Import</h2></div>
<section rst-box>
  <div rst-job><span rst-spin aria-hidden="true"></span> <strong>Import</strong> is running — 128 of 400…<progress rst-job-bar value="32" min="0" max="100" aria-hidden="true"></progress></div>
</section>

檔案大細

顯示個約數,例如 4 MB,再將準確嘅位元組數放入 <data> 標籤。螢幕閱讀器讀嘅係螢幕上嘅嘢,會略過個標籤,所以個約數本身就要夠用。

預覽
<section rst-box>
  <dl rst-detail>
    <dt>Export</dt>
    <dd><data value="4194304">4 MB</data></dd>
  </dl>
</section>

參考編號同代碼

呢啲唔好分開。係訂單 4471,唔係訂單 4,471。年份、版本號同埠號都一樣。用 rst-mono 令佢哋睇落似代碼,而且永遠唔好放入 <time> 標籤,就算佢似日期都唔好。

預覽
<section rst-box>
  <dl rst-detail>
    <dt>Reference</dt>
    <dd class="rst-mono">post_01H9ZQ</dd>
    <dt>Order</dt>
    <dd class="rst-mono">4471</dd>
  </dl>
</section>

人名

個名可以係任何語言,包括由右至左讀嗰啲。當個名喺一行嘅中間,就用 <bdi> 包住佢,唔係佢會搞亂周圍嘅字。想喺名旁邊放張相就用 person。

預覽
<div rst-card style="--rst-cols: minmax(0, 1fr) 120px">
  <div rst-lrow>
    <a class="rst-nm" href="/people/1"><bdi>Grace Hopper</bdi><small><bdi>grace@example.com</bdi> · 09:12</small></a>
    <span class="rst-cell-mut rst-m-hide">Admin</span>
  </div>
</div>

地址

<address> 標籤唔係用嚟寫郵寄地址。佢係用嚟講呢版係邊個寫。送貨地址就係普通文字。員工名單就係一個列表。

預覽
<section rst-box>
  <address>Written by <bdi>Grace Hopper</bdi> · <a href="mailto:grace@example.com">grace@example.com</a></address>
</section>
<section rst-box>
  <dl rst-detail>
    <dt>Deliver to</dt>
    <dd>42 Wharf Road, Dublin 2</dd>
  </dl>
</section>

好似 WCAG 咁嘅縮寫

<abbr> 標籤喺你把滑鼠移上去嗰陣會顯示完整寫法。喺手機度冇用,螢幕閱讀器亦成日會略過。第一次出現嗰陣,都要將啲字完整咁寫出嚟。

預覽
<section rst-box>
  <p>Every page here meets the Web Content Accessibility Guidelines
  (<abbr title="Web Content Accessibility Guidelines">WCAG</abbr>) 2.2 at level AA.</p>
</section>

你個版計出嚟嘅數字

當你個版加埋一啲嘢,就將個答案放入 <output> 標籤。例如累計總數、換算完嘅價錢、倒數。

預覽
<section rst-box>
  <form rst-form>
    <div rst-field>
      <label rst-field-label for="seats">Seats</label>
      <input rst-input="short" id="seats" name="seats" type="number" value="12">
    </div>
    <p>Total <output for="seats" name="total">$144.00</output></p>
  </form>
</section>