列表項(<li>)內文字超寬自動隱藏並顯示省略號,是導航選單、面包屑、標籤列表、資料表格等常見需求。本文系統整理單行/多行截斷技術、Flex/Grid 容器常見失效原因與解法、動態展開互動、無障礙最佳實踐。
.truncate-1line {
white-space: nowrap; /* 強制不換行 */
overflow: hidden; /* 隱藏溢出 */
text-overflow: ellipsis; /* 顯示省略號 (…) */
/* 必須有寬度限制:width、max-width、flex: 1 等 */
}
<ul class="nav-list">
<li><a href="#" class="nav-link">很長很長的導航選單項目名稱會被截斷</a></li>
<li><a href="#" class="nav-link">短標題</a></li>
</ul>
.nav-link {
display: block; /* 讓 a 標籤成為區塊容器承接截斷 */
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
padding: 0.5rem 1rem;
color: #333;
text-decoration: none;
}
<ul class="tag-list">
<li><span class="tag">非常非常長的標籤名稱會自動截斷</span></li>
<li><span class="tag">短標籤</span></li>
</ul>
.tag-list {
display: flex;
flex-wrap: wrap;
gap: 0.5rem;
}
.tag {
/* 關鍵:Flex 子項預設 min-width: auto,會撐開容器導致截斷失效 */
min-width: 0;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
padding: 0.25rem 0.75rem;
background: #e9ecef;
border-radius: 1rem;
font-size: 0.875rem;
}
.truncate-2lines {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 2;
overflow: hidden;
line-height: 1.5;
max-height: 3rem; /* 2 * 1.5rem,防止內容極少時高度異常 */
}
.truncate-3lines {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 3;
overflow: hidden;
line-height: 1.6;
max-height: 4.8rem;
}
/* 列表項應用 */
.article-list li {
padding: 1rem 0;
border-bottom: 1px solid #eee;
}
.article-list .title {
font-weight: 600;
margin-bottom: 0.5rem;
}
.article-list .excerpt {
color: #666;
font-size: 0.9375rem;
/* 套用多行截斷 */
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 2;
overflow: hidden;
line-height: 1.6;
max-height: 3.2rem;
}
<li class="expandable-item">
<input type="checkbox" id="expand-1" class="expand-toggle" hidden>
<p class="expandable-text">這是一段很長很長的文字內容,預設只顯示兩行,點擊展開可查看完整內容...</p>
<label for="expand-1" class="expand-trigger">展開全文</label>
</li>
.expandable-item { position: relative; }
.expandable-text {
--max-lines: 2;
--lh: 1.5;
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: var(--max-lines);
overflow: hidden;
line-height: var(--lh);
max-height: calc(var(--max-lines) * 1rem * var(--lh));
transition: max-height 0.3s ease;
}
.expand-toggle:checked ~ .expandable-text {
-webkit-line-clamp: unset;
max-height: none;
}
.expand-trigger {
display: inline-block;
margin-top: 0.5rem;
color: #0066cc;
cursor: pointer;
font-size: 0.875rem;
}
.expand-toggle:checked ~ .expand-trigger::before {
content: '收起 ';
}
.grid-list {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(200px, 1fr));
gap: 1rem;
}
.grid-item {
min-width: 0; /* Grid 子項同樣預設 min-width: auto */
overflow: hidden;
}
.grid-item .title {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
font-weight: 600;
}
.data-table {
table-layout: fixed; /* 關鍵:固定表格佈局,讓 td 寬度生效 */
width: 100%;
}
.data-table td {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
padding: 0.75rem;
border-bottom: 1px solid #eee;
}
/* 指定欄寬 */
.data-table .col-name { width: 30%; }
.data-table .col-desc { width: 50%; }
.data-table .col-action { width: 20%; }
| 問題 | 解決方案 |
|---|---|
| 螢幕閱讀器可能跳過截斷內容 | 重要資訊勿截斷;提供「展開」按鈕或連結至詳細頁 |
| 鍵盤使用者無法觸發 Tooltip 看完整內容 | 為截斷元素加 title 屬性或自訂 Tooltip(需鍵盤可觸發) |
| 高對比度模式下省略號可能不可見 | 確保省略號色彩對比度、或用文字「...」替代 |
| 縮放 200% 時截斷位置改變 | 使用 ch 單位設定寬度、rem 設定間距,相對單位隨縮放調整 |
/* 專案通用截斷工具類 */
.truncate {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.truncate-2 {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 2;
overflow: hidden;
}
.truncate-3 {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 3;
overflow: hidden;
}
/* 配合 Flex/Grid 使用時的輔助類 */
.min-w-0 { min-width: 0; }
.flex-1 { flex: 1 1 0%; }
列表項文字截斷核心:單行用三件套(nowrap + hidden + ellipsis),多行用 -webkit-line-clamp。Flex/Grid 子項必須加 min-width: 0 才能生效。表格需 table-layout: fixed。截斷是視覺妥協,重要資訊務必提供無障礙存取路徑(展開、連結、Tooltip)。建立專案級工具類別庫,統一截斷行為,減少重複代碼與 Bug。