Skip to content

CSS: rating

.instui-rating — 一個具有填滿與空心字形的星級評分,並可選帶有數字標籤。

在星形字元之間設定其自己的 gap;串接 -gap-* 間距工具類修飾符會覆寫該內建值。

Source: rating.css

無障礙

由於星號為圖示字元,請為其設定 role="img" 並提供說明評分的 aria-label。

使用方法

css
@import "@pantoken/components/components.css";
@import "@pantoken/components/rating.css";

範例

html
<span class="instui-rating -size-sm" role="img" aria-label="2 out of 3 stars">
  <span class="instui-icon -icon-star-solid"></span> <span class="instui-icon -icon-star-solid"></span> <span class="instui-icon -icon-star"></span>
  <span class="label">2/3</span>
</span>

結構

text
.instui-rating
  [class*="-icon-"]
  .label
flowchart TD n0[".instui-rating"]:::cssdoc-root n1("[class*=&quot;-icon-&quot;]"):::cssdoc-part n2(".label"):::cssdoc-part n0 --> n1 n0 --> n2 classDef cssdoc-root stroke-width:1px; classDef cssdoc-part stroke-width:1px; classDef cssdoc-slot stroke-width:1px; classDef cssdoc-component stroke-width:1px;

修飾器

修飾器說明
.-icon-*使用圖示類別來呈現星形字元(例如,-icon-star-solid)。
.-size-large大型。-size-lg 的長形式別名。
.-size-lg大。
.-size-sm小。
.-size-small小。-size-sm 的長形式別名。

部件

部件說明
.label數字標籤,例如 "3/5".

已使用的代幣

Token型別
--instui-color-text-base<color>LightDarklight-dark(#273540, #F2F4F5)
--instui-component-rating-icon-icon-empty-color<color>LightDarklight-dark(#1D354F, #EEF4FD)
--instui-component-rating-icon-icon-filled-color<color>LightDarklight-dark(#1D354F, #EEF4FD)
--instui-component-rating-icon-icon-margin<length>0.125rem
--instui-component-rating-icon-large-icon-font-size<length>2.375rem
--instui-component-rating-icon-medium-icon-font-size<length>1.375rem
--instui-component-rating-icon-small-icon-font-size<length>1rem
--instui-font-family-base[ <font-family-name> | <generic-font-family> ]#Atkinson Hyperlegible Next, "Helvetica Neue", Helvetica, Arial, sans-serif
--instui-font-size-text-base<length>1rem