萬盛學電腦網

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

CSS 列表項文字溢出自動隱藏:單行/多行截斷、Flex 容器陷阱與無障礙處理

CSS 列表項文字溢出自動隱藏:單行/多行截斷、Flex 容器陷阱與無障礙處理

列表項(<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;
}

Flex 容器列表(關鍵:min-width: 0)

<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;
}

多行截斷:-webkit-line-clamp

.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;
}

進階:動態展開/收合(純 CSS Checkbox Hack)

<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 容器同樣需要 min-width: 0

.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;
}

表格儲存格截斷:table-layout: fixed

.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。

copyright © 萬盛學電腦網 all rights reserved