「文字太長要截斷並加省略號」是再常見不過的需求,但三種語言的做法差異不小,這裡一次整理清楚。
<?php echo mb_strimwidth("這裡是內容", 0, 3, "...", "utf-8"); ?>
其實一個 mb_strimwidth 就足夠了,它的簽名如下:
string mb_strimwidth ( string $str, int $start, int $width,
[, string $trimmarker = "" [, string $encoding = mb_internal_encoding() ]] )
參數說明:$str 是原字串;$start 是起始位置,預設 0;$width 是修剪後的目標寬度;$trimmarker 是結尾要附加的符號(常用 ...);$encoding 則是編碼。
最後一個參數常被忽略,卻是關鍵:字串含中文時一定要明確指定,否則就會看到一堆 。而且必須與頁面實際編碼一致——曾經在 WordPress 主題裡要顯示文章摘要,結尾莫名出現亂碼,查了很久才發現就是這個參數沒對上。很多時候我們以為是語言本身的問題,其實只是函數沒讀懂。
這兩個方法幾乎長得一模一樣,但第二個參數的含義完全不同,這是最容易踩雷的地方。
substring(start, end):第一參數是起始位置(必填),第二參數是「結束位置」,取出的範圍是 start 到 end,但 不含 end。省略時取到結尾。
substr(start, length):第一參數是起始索引(必填,可為負數,-1 代表最後一個字元),第二參數是「要擷取的長度」,而不是位置。省略時取到結尾。
<script type="text/javascript"> var str = "Hello world!"; document.write(str.substring(3)); // lo world! 從第 3 位到結尾 document.write(str.substring(3,7)); // lo w 第 3 位到第 7 位(不含 7) document.write(str.substr(3)); // lo world! 第 3 位到結尾 document.write(str.substr(3,7)); // lo worl 從第 3 位起取 7 個字 </script>
把「位置」與「長度」記牢,這兩個方法就不會用錯。另外提醒 substr 因第二參數語意特殊,已被標註為 legacy 特性,新專案建議改用 slice 或 substring。
純視覺的截斷交給 CSS 最省事:
text-overflow: [ clip | ellipsis | <string> ]
預設值是 clip,也就是超出容器就直接裁掉;設為 ellipsis 則會以省略號取代溢出的文字;也可以自訂字串(早期僅 Firefox 支援)。經典的三段式寫法如下:
.ellipsis{
overflow: hidden;
white-space: nowrap;
text-overflow: ellipsis;
}
三個屬性缺一不可:white-space: nowrap 讓文字不換行,overflow: hidden 把溢出部分藏起來,text-overflow 才會有機會畫上省略號。若需要的是多行截斷,則要改用 -webkit-line-clamp 搭配 display: -webkit-box。