清單:規格
清單是文字與圖片的連續垂直索引。
變體
Expressive 清單
使用 Expressive 清單變體,可獲得更靈活的樣式、更醒目的選取狀態與可自訂的插槽。

基準清單
基準清單仍可使用,但不具備最新的視覺樣式、選取處理方式與插槽功能。
在 Web 上,Expressive 清單以基準清單為基礎建構。

| 變體 | M3 | M3 Expressive |
|---|---|---|
| 清單(Expressive) | -- | 提供 |
| 清單(基準) | 提供 | 不建議使用。 請改用 Expressive 清單。 |
配置
樣式
標準與分段樣式僅影響外觀,不會影響清單行為。

- 標準
- 分段
清單選取
每個清單一次只能有一種選取模式。例如,單一操作清單可改為多選清單,但不能同時具備兩種模式。




清單互動
清單支援下列互動:

| 類別 | 配置 | M3 | M3 Expressive |
|---|---|---|---|
| 樣式 | 標準 | 提供 | 提供 |
| 分段 | -- | 提供 | |
| 選取模式 | 單一操作、多重操作、單選、多選 | 提供 | 提供 |
| 互動 | 展開、滑動\* | 提供 | 提供 |
* 滑動顯示操作僅適用於 Android Views
token 與規格
使用表格選單選取 token 集。common 集結合基準 token 與新的 Expressive 形狀和尺寸;expand 集包含展開互動所用的 token。進一步了解設計 token
清單 - Common
清單 - Expand
結構

容器與標籤文字為必要元素,其餘元素均為選用:
- 容器
- 頂線文字
- 標籤文字
- 後置文字
- 輔助文字
- 後置圖示
- 分隔線
- 前置頭像
- 前置圖示
- 前置媒體(圖片或影片)
彈性與插槽
M3 設計套件包含具有自訂插槽的清單,可用於設計彈性的項目版面配置。可將自訂清單視為具備三個插槽的容器:前置、內容與後置;每個插槽可容納不同元素。
插槽無障礙設計
插槽預設不具無障礙性,請考量下列事項:
- 元素必須符合清單的規則、結構與互動模式
- 使用標準清單項目內距
- 觸控目標尺寸不得小於 48×48dp
- 請勿新增會讓清單項目難以導覽的互動元素,尤其是對使用螢幕閱讀器的使用者

- 前置插槽
- 內容插槽
- 後置插槽
WARNING
插槽需以自訂程式碼實作,且必須由你建立與維護
前置與後置插槽的寬度必須小於內容插槽。
1. 前置插槽可包含:
- 視覺元素:頭像、圖示、圖片或影片縮圖
- 選取控制項:核取方塊、選項按鈕或開關
- 自訂元素:徽章或較大的圖片
2. 內容插槽必須是寬度最大的插槽,可包含:
- 預設內容:標籤文字、輔助文字
- 選用附加元素:徽章、圖示、行內標籤或其他文字元素
- 避免文字行過長,以維持可讀性
3. 後置插槽可包含:
- 操作元素或文字:圖示、圖示按鈕或後置文字
- 選取控制項:核取方塊、選項按鈕或開關

選取清單
在選取清單中,每個清單項目僅使用一種選取互動。


色彩
色彩值透過設計 token 實作。對設計師而言,這表示使用對應 token 的色彩值;在實作中,色彩值則是參照特定值的 token。進一步了解設計 token

用於淺色與深色主題的清單色彩角色:
- 表面色
- 表面變體上的內容
- 表面上的內容
- 表面變體上的內容
- 表面變體上的內容
- 表面變體上的內容
- 外框色變體
- 主要容器色
- 主要容器上的內容
- 表面變體上的內容
狀態
狀態用視覺方式呈現元件或互動元素目前的狀況。進一步了解互動狀態
預設清單項目

- 已啟用
- 已停用
- 懸停
- 已聚焦
- 已按下
- 拖曳中
已選取清單項目

- 已啟用
- 已停用
- 懸停
- 已聚焦
- 已按下
- 拖曳中
尺寸

形狀轉換
清單項目被選取時,邊角形狀會改變,以突顯目前使用中的項目:
- 未選取圓角半徑:內側 4dp、外側 16dp
- 已選取圓角半徑:16dp


清單(基準)
基準清單變體仍可使用,並可繼續在現有產品中運作;不過,新設計建議採用Expressive 清單變體。token 與規格
基準清單的token位於 common token 集。
TIP
此 token 集也包含多個 Expressive token。
色彩
色彩值透過設計 token 實作。對設計師而言,這表示使用對應 token 的色彩值;在實作中,色彩值則是參照特定值的 token。進一步了解設計 token

用於淺色與深色主題的清單色彩角色:
- 表面色
- 表面上的內容
- 表面變體上的內容
- 表面變體上的內容
- 表面變體上的內容
- 外框色變體
- 主要容器色
- 主要容器上的內容
- 表面變體上的內容
狀態
狀態用視覺方式呈現元件或互動元素目前的狀況。

- 已啟用
- 已停用
- 懸停
- 已聚焦
- 已按下
- 拖曳中
版面配置
單行清單


兩行清單


三行清單


| 屬性 | 值 |
|---|---|
| 標籤對齊方式 | 置中 |
| 高度為 88dp 或以上時的標籤對齊方式 | 置頂 |
| 標籤左側內距 | 16dp |
| 前置元素對齊方式(垂直) | 置中 |
| 高度為 88dp 或以上時的前置元素對齊方式(垂直) | 置頂 |
| 前置元素左側內距 | 16dp |
| 前置圖示對齊方式(垂直) | 置頂 |
| 前置圖示上方內距 | 8dp |
| 高度為 88dp 或以上時的前置圖示上方內距 | 12dp |
| 後置元素對齊方式(垂直) | 置中 |
| 高度為 88dp 或以上時的後置元素對齊方式(垂直) | 置頂 |
| 後置元素左側內距 | 16dp |
| 後置元素右側內距 | 24dp |
| 分隔線上方/下方內距 | 0dp |
| 觸控目標尺寸 | 48dp |
| 分隔線全寬 | 100% |
| 分隔線內縮左側內距 | 16dp |
| 分隔線內縮右側內距 | 24dp |
配置
前置頭像

- 含前置頭像
- 含前置頭像與後置核取方塊
前置圖片或縮圖

- 含前置圖片
- 含前置圖片與後置核取方塊
前置影片

- 含前置影片
- 含前置影片與後置核取方塊
前置圖示

- 含前置圖示
- 含前置圖示與後置核取方塊
純文字

- 僅含文字
- 含文字與後置核取方塊
前置核取方塊

- 含前置核取方塊
- 含前置核取方塊與後置文字
前置選項按鈕

- 含前置選項按鈕
- 含前置選項按鈕與後置文字
後置開關

- 含後置開關
- 含前置圖示與後置開關