萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網頁製作 >> Div CSS 教學

CSS 換行控制完全指南:word-break、white-space、overflow-wrap 實戰詳解

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;
}
copyright © 萬盛學電腦網 all rights reserved