| 屬性 | 作用對象 | 核心值 | 典型場景 |
|---|---|---|---|
white-space | 空白字符處理 | normal、nowrap、pre、pre-wrap、pre-line | 代碼塊、單行截斷、保留格式 |
word-break | 單詞內斷行規則 | normal、break-all、keep-all | 中英文混排、長英文/URL 強制換行 |
overflow-wrap (word-wrap) | 長詞溢出換行 | normal、break-word、anywhere | 防止容器被撐大、自適應佈局 |
text-overflow | 溢出省略號 | clip、ellipsis、<string> | 單行/多行文本截斷提示 |
overflow | 容器溢出處理 | visible、hidden、scroll、auto | 滾動容器、截斷配合 |
white-space:空白字符的「總開關」.nowrap { white-space: nowrap; } /* 強制單行,配合 text-overflow 做截斷 */
.pre-wrap { white-space: pre-wrap; } /* 保留換行+空格,自動換行(類似 但自適應) */
.pre-line { white-space: pre-line; } /* 合併空格,保留換行,自動換行 */
.normal { white-space: normal; } /* 默認:合併空格、自動換行 */
關鍵點:nowrap 是單行截斷的前置條件(配合 overflow: hidden + text-overflow: ellipsis)。
word-break vs overflow-wrap:誰管「字內斷行」?.break-all { word-break: break-all; } /* 任意字符斷行,中文友好,英文單詞會被拆碎 */
.keep-all { word-break: keep-all; } /* 中日韓不斷行,英文按單詞斷行 */
.break-word { overflow-wrap: break-word; } /* 僅在「無法放下」時才斷詞,優雅降級 */
.anywhere { overflow-wrap: anywhere; } /* 計算 min-content 時也假設會斷詞,佈局更穩 */
決策樹:
word-break: break-all(或 break-word)overflow-wrap: break-wordwhite-space: pre-wrap + overflow-wrap: normal白不換 + 溢出隱 + 省略號.ellipsis-1line {
white-space: nowrap; /* 1. 不換行 */
overflow: hidden; /* 2. 溢出隱藏 */
text-overflow: ellipsis; /* 3. 顯示 … */
/* 必須有寬度約束(width/max-width/flex/grid 佈局) */
}
-webkit-line-clamp(標準化進行中).ellipsis-3line {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 3; /* 顯示 3 行 */
overflow: hidden;
/* 注意:需配合 line-height 計算高度,避免行高異常導致截斷位置偏移 */
line-height: 1.5;
max-height: 4.5em; /* 3 * 1.5 = 4.5em 兜底 */
}
標準化替代方案(草案):text-overflow: ellipsis 3、block-ellipsis,尚未廣泛支持。
overflow 兜底:當換行控制失效時overflow: hidden:直接切掉,配合 text-overflow 顯示省略號overflow: auto:內容超出才出現滾動條,適合代碼塊、日誌面板overflow: scroll:永遠顯示滾動條(含空白軌道),適合類桌面應用.card-title {
font-size: 1.125rem;
font-weight: 600;
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
max-width: 100%; /* flex/grid 子項自動約束 */
}
.excerpt {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 3;
overflow: hidden;
line-height: 1.6;
max-height: 4.8em;
/* 兜底:不支持 line-clamp 時至少不會無限撐高 */
}
.code-block {
white-space: pre-wrap; /* 保留換行縮進,超寬自動換行 */
overflow-wrap: normal; /* 不強制斷詞,保持 token 完整 */
overflow-x: auto; /* 橫向滾動 */
font-family: monospace;
font-size: 0.875rem;
padding: 12px;
background: #1e1e1e;
color: #d4d4d4;
border-radius: 6px;
}
.table td {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
max-width: 200px; /* 或由 table-layout: fixed + 列寬決定 */
transition: max-width 0.2s;
}
.table tr:hover td {
max-width: none; /* Hover 時展開 */
white-space: normal; /* 允許換行 */
overflow: visible;
text-overflow: clip;
z-index: 1; /* 覆蓋相鄰儲存格 */
background: #fff;
box-shadow: 0 2px 8px rgba(0,0,0,.1);
}
text-overflow: ellipsis 用在 inline 元素上(需 display: block/inline-block)word-break: keep-all 導致長句不換行撐破容器line-height + max-height 兜底,舊瀏覽器崩壞overflow-wrap: anywhere 計算 min-content 寬度更準確(Grid/Flex 佈局)「換行控制的本質是『在約束中尋找平衡』:既要保證內容可讀、不撐破佈局,又要尊重語言習慣與用戶預期。」