長文沒有目錄,讀者很難快速定位內容。在博客平台上,我們可以通過一段 JS 腳本掃描正文標題,自動生成可點擊跳轉的目錄,並順手美化一級標題的外觀。
很多博客平台需要提交申請才能自定義腳本。進入設置頁面,找到頁腳 HTML 代碼入口,按提示申請即可,通常審核回覆很快。拿到權限後,把下面的代碼貼進頁腳 HTML 代碼框保存就能生效。
需要特別注意的是目錄依賴的標題層級。下面的代碼默認生成二級結構:一級取 h2,二級取 h3。如果你的文章用的是別的標籤,記得同步替換選擇器。
這個目錄具備兩個特點:能在博文首部生成兩級目錄;每個一級標題上方插入一個「回到頂部」的鏈接。
<script language="javascript" type="text/javascript">
// 生成兩級目錄索引列表
function GenerateContentList() {
var mainContent = $('#cnblogs_post_body');
var h2_list = $('#cnblogs_post_body h2');
// 如果你的章節標題不是 h2,只需替換這裡的選擇器
if (mainContent.length < 1) return;
if (h2_list.length > 0) {
var content = '<a name="_labelTop"></a>';
content += '<div id="navCategory">';
content += '<p style="font-size:18px"><b>目錄</b></p>';
content += '<ul>';
for (var i = 0; i < h2_list.length; i++) {
var go_to_top = '<div style="text-align: right">' +
'<a href="#_labelTop">回到頂部</a>' +
'<a name="_label' + i + '"></a></div>';
$(h2_list[i]).before(go_to_top);
var h3_list = $(h2_list[i]).nextAll("h3");
var li3_content = '';
for (var j = 0; j < h3_list.length; j++) {
// 遇到下一個 h2 就停止,避免把後面章節的 h3 算進來
var tmp = $(h3_list[j]).prevAll('h2').first();
if (!tmp.is(h2_list[i])) break;
var li3_anchor = '<a name="_label' + i + '_' + j + '"></a>';
$(h3_list[j]).before(li3_anchor);
li3_content += '<li><a href="#_label' + i + '_' + j + '">' +
$(h3_list[j]).text() + '</a></li>';
}
var li2_content = '';
if (li3_content.length > 0) {
li2_content = '<li><a href="#_label' + i + '">' + $(h2_list[i]).text() +
'</a><ul>' + li3_content + '</ul></li>';
} else {
li2_content = '<li><a href="#_label' + i + '">' + $(h2_list[i]).text() +
'</a></li>';
}
content += li2_content;
}
content += '</ul></div>';
if ($('#cnblogs_post_body').length != 0) {
$($('#cnblogs_post_body')[0]).prepend(content);
}
}
}
GenerateContentList();
</script>
給 h2 加一個淺灰色背景圖,標題的層次感立刻清晰起來。把下面的規則寫進自定義 CSS,並換成你自己的圖片地址:
#cnblogs_post_body h2 {
background-repeat: no-repeat;
background-image: url('https://xxxx');
padding-left: 20px;
}
第一,錨點 id 用下標拼接,若文章多次渲染腳本會重複插入目錄,建議執行前先判斷 $('#navCategory').length 是否存在。
第二,目錄裡的文本直接取 .text(),如果標題中含有特殊字符,插入 HTML 前最好做一次轉義,避免結構被破壞。
第三,若希望目錄在滾動時固定跟隨,可以給 #navCategory 加 position:sticky,體驗會更好。