在 JavaScript 中截斷字串,直接 substring(0, 15) 看似沒問題,但遇到中文就會出錯:中文字的字寬大約是英文的兩倍,所以「15 個字」在視覺寬度上遠超過「15 個英文字母」。列表排版因此被撐壞,後面接的省略號也常常落在奇怪的位置。
解法是用規則運算式把非 ASCII 字元替換成兩個佔位字元,再以「視覺寬度」為單位計算:
<script type="text/javascript">
var sub = function (str, n) {
var r = /[^\x00-\xff]/g; // 比對所有非 ASCII 字元
if (str.replace(r, "mm").length <= n) { return str; } // 本來就夠短,原字串傳回
var m = Math.floor(n / 2);
for (var i = m; i < str.length; i++) {
if (str.substr(0, i).replace(r, "mm").length >= n) {
return str.substr(0, i) + "...";
}
}
return str;
}
alert(sub('字符串截取Javascript處理總結(Js截取中文字符串總結)', 15))
</script>
/[^\x00-\xff]/g 的意義是「凡是超出單一字元組範圍的編碼」,在實務上就是用來抓中文字。把它換成 "mm" 之後字串長度就等於視覺寬度,再逐一累加比較即可。起始值取 n / 2 是一個小優化:因為中文佔兩位,符合條件的切點必定不會早於這個位置,可以少跑一半迴圈。
理解 substring 的規則很重要,它有几個容易誤解的地方:
var str = "0123456789"; str.substring(0) // "0123456789" 省略第二參數=取到結尾 str.substring(5) // "56789" str.substring(10) // "" 超出長度回傳空字串 str.substring(12) // "" str.substring(-5) // "0123456789" 負值一律視為 0 str.substring(-10) // "0123456789" str.substring(-12) // "0123456789" str.substring(0, 5) // "01234" str.substring(0, 10) // "0123456789" str.substring(0, 12) // "0123456789" 超出部分自動截到結尾 str.substring(2, 0) // "01" 兩參數順序顛倒會自動交換 str.substring(2, 2) // "" 起訖相同回傳空 str.substring(2, 5) // "234" str.substring(2, 12) // "23456789" str.substring(2, -2) // "01" -2 視為 0,交換後變成 (0,2) str.substring(-1, 5) // "01234" -1 視為 0 str.substring(-1, -5) // "" 兩者皆為 0
substr 的第二個參數是「要取幾個字元」,而不是結束位置,這是兩者最關鍵的差異:
var str = "0123456789"; str.substr(0) // "0123456789" str.substr(5) // "56789" str.substr(10) // "" str.substr(12) // "" str.substr(-5) // "0123456789" 負起點=從尾端往前算 str.substr(-10) // "0123456789" str.substr(-12) // "0123456789" 超過長度則視為 0 str.substr(0, 5) // "01234" 取 5 個字元 str.substr(0, 10) // "0123456789" str.substr(0, 12) // "0123456789" str.substr(2, 0) // "" 取 0 個字元 str.substr(2, 2) // "23" 從 2 取 2 個 str.substr(2, 5) // "23456" 從 2 取 5 個 str.substr(2, 12) // "23456789" 不足則取到結尾 str.substr(2, -2) // "" 負長度視為 0 str.substr(-1, 5) // "01234" 從最後一個字元往前算起點 str.substr(-1, -5) // ""
slice(begin, end):支援負索引,行為最直觀,且不會自動交換參數(起點大於終點時回傳空字串)。新專案請優先使用。substring(begin, end):不支援負索引(一律視為 0),但會自動把較大的參數當成終點。substr(start, length):第二參數是長度而非位置,容易混淆,已被標記為 Annex B 的 legacy 功能,不建議在新程式碼中使用。用「視覺寬度」估算中英混排,其實是個近似手法——它沒有考慮到全形標點、emoji、組合字元等情況。若要更準確,有兩個方向:
// 1. 用 Canvas 量測實際渲染寬度
var ctx = document.createElement("canvas").getContext("2d");
ctx.font = "14px sans-serif";
function truncate(text, maxWidth) {
if (ctx.measureText(text).width <= maxWidth) return text;
var lo = 0, hi = text.length;
while (lo < hi) { // 二分搜尋,比逐字遞增快
var mid = Math.ceil((lo + hi) / 2);
if (ctx.measureText(text.slice(0, mid) + "...").width <= maxWidth) lo = mid;
else hi = mid - 1;
}
return text.slice(0, lo) + "...";
}
// 2. 直接用 CSS,一行搞定,且會隨容器寬度自動調整
.ellipsis {
overflow: hidden;
text-overflow: ellipsis;
white-space: nowrap;
}
如果需求只是「單行超出就顯示省略號」,CSS 的 text-overflow: ellipsis 永遠優於 JavaScript:它依實際字型度量運算、響應視窗縮放、不必等腳本執行、也不會因為字型載入而算錯。需要多行時用 line-clamp:
.ellipsis-multi {
display: -webkit-box;
-webkit-line-clamp: 2;
-webkit-box-orient: vertical;
overflow: hidden;
}
另外提醒一個 Unicode 陷阱:像 emoji 或某些罕用漢字在 UTF-16 中佔兩個 code unit,用 substr 硬切會切壞字元、產生亂碼。若要安全處理,請用 [...str] 或 Array.from(str) 以 code point 為單位切分,或使用 Intl.Segmenter 以「使用者感知的字元」(grapheme)為單位。