在 JS 檔裡塞大量字串常數是家常便飯。有些人為了省事,乾脆把介面的 HTML 和 CSS 直接寫進 JS。數量少的時候還好,一旦多起來就是密密麻麻一大坨,於是講究美感的開發者會用大量串接符號加上縮排,硬拆成好幾行:
var html =
'<div>' +
'<p>Hello</p>' +
'<p>World</p>' +
'</div>';
這還算客氣。要是字串裡雙引號單引號一大堆,各種跳脫字元看得眼花撩亂,才是真正的惡夢。
其實有個不起眼的小技巧能一次解決這個問題。大家都認為字串必須寫在 "..." 或 '...' 裡,這沒錯;但還有一個地方也能安全地保存非程式碼語義的文字——函式的 toString()。把整個函式的程式碼當字串輸出時,裡面的註解內容同樣會被保留。
所以我們寫一個空函式,裡面只放一段 /**/ 註解,把想要的常量內容塞進去,toString() 之後再用正則提取即可。
var RES_CODE = _TEXT(function () { /*
#include <iostream>
int main()
{
std::cout << "Hello world" << std::endl;
return 0;
}
*/ });
var RES_POEM = _TEXT(function () { /*
更吹落,星如雨。
寶馬雕車香滿路。
鳳簫聲動,玉壺光轉,一夜魚龍舞。
蛾兒雪柳黃金縷,
笑語盈盈暗香去。
眾裡尋他千百度,
驀然回首,那人卻在燈火闌珊處。
*/ });
var RES_XML = _TEXT(function () { /*
<projectDescription>
<name>Hello</name>
<comment></comment>
</projectDescription>
*/ });
function _TEXT(wrap) {
return wrap.toString().match(/\s*\/\*([\s\S]*?)\*\//)[1];
}
alert(RES_CODE);
alert(RES_POEM);
alert(RES_XML);
用起來就是這麼直接。Chrome 會把註解每行前面的 Tab 去掉,如果只是拿來放程式碼或文字,影響不大。
第一,字串內容裡不能出現 */,否則註解會提早結束。第二,壓縮工具預設會濾掉註解,使用這招時記得手動排除,別讓 build 流程把你的資料整段吃掉。