CSS 文本換行控制大全:解決長單詞溢出、中英文混排、強制不換行等核心痛點
文本換行看似簡單,實則涉及 white-space、word-break、overflow-wrap (原 word-wrap)、text-wrap (CSS Text 4) 多屬性交互。本文系統梳理換行機制,提供場景化解決方案。
核心屬性對比表
| 屬性 | 控制對象 | 關鍵值 | 核心作用 | 繼承性 |
white-space | 空白符處理 & 換行行為 | normal, nowrap, pre, pre-wrap, pre-line, break-spaces | 是否合併空白、是否允許換行 | 是 |
word-break | 單詞內部斷行規則 | normal, break-all, keep-all, break-word (非標準) | CJK 文字是否斷行、英文單詞是否強制斷行 | 是 |
overflow-wrap (word-wrap) | 單詞超出容器時是否斷行 | normal, break-word, anywhere | **允許**在單詞內斷行防止溢出 (不改變斷行機會點) | 是 |
text-wrap (CSS Text 4) | 換行模式 | wrap, nowrap, balance, pretty | 新標準統一換行控制,balance 多行文本長度均衡 | 是 |
hyphens | 連字符斷行 | none, manual, auto | 根據語言規則自動插入連字符斷行 (需 lang 屬性) | 是 |
white-space 完整行為矩陣
| 值 | 合併空白 | 換行符換行 | 文本換行 | 適用場景 |
normal | ✅ | ❌ (視為空白) | ✅ | 普通段落 |
nowrap | ✅ | ❌ | ❌ | 單行截斷、導航項、按鈕文字 |
pre | ❌ | ✅ | ❌ | 代碼塊、詩歌、ASCII 藝術 |
pre-wrap | ❌ | ✅ | ✅ | 用戶輸入保留格式 (編輯器、評論) |
pre-line | ✅ | ✅ | ✅ | 保留換行但合併空格 |
break-spaces | ❌ (保留末尾空格) | ✅ | ✅ | 代碼編輯器、保留縮進 |
場景化解決方案
場景 1:長英文/URL/代碼強制換行防止撐破容器
.break-long-word {
/* 推薦:現代標準屬性 */
overflow-wrap: break-word; /* 原 word-wrap */
/* 兼容舊瀏覽器 */
word-wrap: break-word; /* 別名,保留兼容 */
/* 配合 word-break 更激進 */
word-break: break-word; /* 非標準但廣泛支持,等效 break-all + overflow-wrap */
}
/* 最強制:任意字符間斷行 (慎用,會破壞單詞完整性) */
.break-all { word-break: break-all; }
場景 2:中英文混排:中文換行、英文整詞保持
.mixed-text {
/* 關鍵:keep-all 防止中日韓文字任意斷行 (其實 normal 就行) */
word-break: normal; /* 默認:CJK 可斷行,英文整詞 */
overflow-wrap: break-word; /* 超長英文單詞允許斷行 */
/* 針對代碼/技術文檔:保留英文單詞完整性 */
word-break: keep-all; /* CJK 不斷行,英文整詞 */
overflow-wrap: anywhere; /* 只有極窄時才在單詞內斷行 */
}
場景 3:單行文字溢出省略號 (經典三件套)
.ellipsis-1line {
white-space: nowrap; /* 1. 強制不換行 */
overflow: hidden; /* 2. 隱藏溢出 */
text-overflow: ellipsis; /* 3. 顯示省略號 */
/* 必須有確定寬度或 max-width */
max-width: 200px;
}
場景 4:多行文字溢出省略號 (WebKit 私有,但已成事實標準)
.ellipsis-3line {
display: -webkit-box;
-webkit-box-orient: vertical;
-webkit-line-clamp: 3; /* 顯示行數 */
overflow: hidden;
/* 配合 line-height 計算高度 */
line-height: 1.5;
max-height: 4.5em; /* 3 * 1.5 = 4.5em 兜底 */
}
場景 5:保留用戶輸入格式 (評論、代碼、Markdown 渲染)
.user-content {
white-space: pre-wrap; /* 保留換行和空格,超寬自動換行 */
word-break: break-word; /* 防止長單詞撐破 */
font-family: monospace; /* 代碼場景 */
}
/* 純代碼塊 */
.code-block {
white-space: pre; /* 完全保留格式,不自動換行 */
overflow-x: auto; /* 橫向滾動 */
font-family: 'Fira Code', 'Consolas', monospace;
}
場景 6:導航/標籤/按鈕文字不換行
.nav-item, .btn, .tag {
white-space: nowrap;
/* 可選:溢出省略 */
overflow: hidden;
text-overflow: ellipsis;
max-width: 100%; /* Flex 子項需此項生效 */
}
場景 7:CSS Text 4 新特性:text-wrap: balance (標題多行均衡)
h1, h2, h3 {
text-wrap: balance; /* 瀏覽器嘗試讓每行長度盡量均勻 */
/* 支持:Chrome 114+, Edge 114+, Safari 17+, Firefox 117+ */
}
/* 避免標題最後一行只有 1-2 個字 */
h1 { text-wrap: pretty; } /* 優化最後一行最少單詞數 */
屬性交互優先級關係
/* 1. white-space 為總開關 */
white-space: nowrap; /* 直接禁用所有換行,其它屬性無效 */
/* 2. white-space: normal/pre-wrap/pre-line 允許換行時: */
/* word-break 決定「在哪裡可以斷行」 */
/* overflow-wrap 決定「超出容器時是否允許在單詞內斷行」 */
/* 典型衝突 */
.conflict {
word-break: keep-all; /* 中文不斷行,英文整詞 */
overflow-wrap: break-word; /* 但超長英文允許斷行 */
/* 結果:正常中英文混排,超長 URL/單詞會在邊界斷行 */
}
調試技巧:可視化換行機會點
/* 開發時臨時添加,查看瀏覽器計算的換行機會 */
.debug-wrap * {
background: linear-gradient(90deg, transparent 50%, rgba(255,0,0,0.1) 50%) !important;
background-size: 1ch 1em !important;
}