當文字內容超出容器寬度/高度時,優雅地截斷並顯示「…」省略號,而非粗暴 `overflow: hidden` 直接切斷,是提升用戶體驗的關鍵細節。本文系統講解單行、多行、響應式、配合 Tooltip 完整顯示等場景的最佳實踐方案。
.ellipsis-1line {
overflow: hidden; /* 1. 隱藏溢出 */
white-space: nowrap; /* 2. 強制不換行 */
text-overflow: ellipsis; /* 3. 顯示省略號 */
width: 300px; /* 必須有寬度約束 */
}
必要條件: 塊級容器 + 確定寬度 + 無換行 + 溢出隱藏 + `text-overflow: ellipsis`。
.ellipsis-3line {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 3; /* 關鍵:限制行數 */
overflow: hidden;
/* 不需要 white-space: nowrap */
}
支援: Chrome、Firefox、Safari、Edge (Chromium)、移動端 WebView。
不支援: IE、舊版 Edge (EdgeHTML)。
.ellipsis-multiline {
position: relative;
line-height: 1.5;
max-height: 4.5em; /* line-height × 行數 */
overflow: hidden;
}
.ellipsis-multiline::after {
content: '…';
position: absolute;
right: 0;
bottom: 0;
padding-left: 1em;
background: linear-gradient(to left, transparent 50%, white 100%);
/* 漸變遮罩讓省略號前文字自然淡出 */
}
原理:`max-height` 截斷 + 偽元素絕對定位模擬省略號 + 漸變遮罩融合。純 CSS、全瀏覽器兼容、無 JS 依賴。
.responsive-ellipsis {
max-width: 100%; /* 響應式寬度 */
/* 單行 */
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
}
/* 多行響應式:需配合容器查詢或 JS 計算行數 */
@container (min-width: 300px) {
.responsive-ellipsis {
-webkit-line-clamp: 2;
}
}
@container (min-width: 600px) {
.responsive-ellipsis {
-webkit-line-clamp: 3;
}
}
現代方案:CSS Container Queries 根據容器寬度動態調整行數,實現真正響應式截斷。
<div class="ellipsis-1line" title="這是一段很長很長的完整文字內容,因為容器寬度不足而被截斷">
這是一段很長很長的完整文字內容,因為容器寬度不足而被截斷
</div>
原生 `title` 屬性懸停顯示完整內容,零成本。進階可用自定義 Tooltip 組件(支援 HTML、定位智能、動畫)。
function isEllipsized(el) {
return el.scrollWidth > el.clientWidth; // 單行
// 多行需比較 scrollHeight > clientHeight
}
僅在發生截斷時顯示「展開」按鈕或 Tooltip,避免不必要的交互干擾。
| 坑點 | 原因 | 解決 |
|---|---|---|
| 省略號不顯示 | 容器無寬度 / 未設 overflow:hidden / 有換行 | 檢查三部曲:寬度、nowrap、hidden、ellipsis |
| Flex/Grid 子元素省略失效 | Flex 子項默認 min-width:auto 導致不收縮 | 子項加 `min-width: 0` 或 `overflow: hidden` |
| 多行省略號在 Firefox 早期版本不生效 | 需 Firefox 68+ 支援 -webkit-line-clamp | 漸進增強方案兜底 |
| 省略號位置錯位 (RTL/混排) | direction/書寫模式影響 | 測試 RTL 環境,必要時用邏輯屬性 |
文字截斷看似微小,實則關係到信息密度、視覺整潔度與交互友好度的平衡。掌握這套組合拳,讓你的介面在內容不可控的現實中,依然保持優雅與克制。