DIV CSS 佈局教程網

用 JS 為博客文章自動生成兩級目錄,並自定義標題樣式
編輯:關於JavaScript     

長文沒有目錄,讀者很難快速定位內容。在博客平台上,我們可以通過一段 JS 腳本掃描正文標題,自動生成可點擊跳轉的目錄,並順手美化一級標題的外觀。

一、開通 JS 權限

很多博客平台需要提交申請才能自定義腳本。進入設置頁面,找到頁腳 HTML 代碼入口,按提示申請即可,通常審核回覆很快。拿到權限後,把下面的代碼貼進頁腳 HTML 代碼框保存就能生效。

需要特別注意的是目錄依賴的標題層級。下面的代碼默認生成二級結構:一級取 h2,二級取 h3。如果你的文章用的是別的標籤,記得同步替換選擇器。

這個目錄具備兩個特點:能在博文首部生成兩級目錄;每個一級標題上方插入一個「回到頂部」的鏈接。

二、生成目錄的 JS 代碼

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

三、一級標題的 CSS 美化

給 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,體驗會更好。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved