fallback

Baseline 2023
新推出

自 2023 年 9 月起,此功能可在最新的裝置和瀏覽器版本上使用。此功能可能無法在較舊的裝置或瀏覽器上使用。

@counter-style at-rule 的 fallback 描述符可用於指定一個備用計數器樣式,當正在定義的計數器樣式無法為特定計數器值建立標記表示時,將回退到該備用樣式。

語法

css
/* Keyword values */
fallback: lower-alpha;
fallback: custom-gangnam-style;

該描述符接受單個 <counter-style-name> 作為其值。

<counter-style-name>

提供用作備用計數器樣式的名稱,該名稱可以是自定義 CSS 計數器樣式的區分大小寫的 <custom-ident>(不帶引號),也可以是不區分大小寫的 list-style-type 屬性值,例如 decimaldisc 等。

如果省略,計數器備用預設為 decimal

描述

當為計數器樣式指定了 range 描述符時,將使用作為 fallback 描述符的值提供的計數器樣式;fallback 樣式用於表示超出範圍的所有值。當使用 fixed system 且沒有足夠的符號來覆蓋所有列表項時,也會使用 fallback 樣式;fallback 樣式用於表示超出固定系統範圍的所有值。在所有這些情況下,以及定義計數器無法建立特定計數器值的任何其他時間,都將使用 fallback 樣式。

如果指定的備用樣式也無法構建表示,則使用該備用計數器的 fallback 值。如果該備用樣式的備用也無法構建表示,則使用該備用的備用。這種回退會一直持續,直到找到一個可以構建計數器表示的備用。如果沒有備用 fallback 值能夠構建表示——如果備用樣式沒有設定 fallback 值,或者 fallback 值未指定或無效——則 fallback 預設為 decimal

正式定義

相關的 at-rule@counter-style
初始值decimal
計算值同指定值

正式語法

fallback = 
<counter-style-name>

示例

指定備用計數器樣式

HTML

html
<ul class="list">
  <li>One</li>
  <li>Two</li>
  <li>Three</li>
  <li>Four</li>
  <li>Five</li>
</ul>

CSS

css
@counter-style fallback-example {
  system: fixed;
  symbols: "\24B6" "\24B7" "\24B8";
  fallback: upper-alpha;
}

.list {
  list-style: fallback-example;
}

結果

規範

規範
CSS Counter Styles Level 3
# counter-style-fallback

瀏覽器相容性

另見

  • 其他 @counter-style 描述符:systemsymbolsadditive-symbolsnegativeprefixsuffixrangepadspeak-as
  • list-stylelist-style-imagelist-style-position
  • symbols():用於建立匿名計數器樣式的功能表示法