为博客添加目录
转自:http://www.cnblogs.com/xdp-gacl/p/3718879.html#2937655
一、功能描述
这个小工具要实现的核心功能只有两个:
1.自动生成博文目录。
2.点击目录标题定位到标题对应的具体内容,就像使用word生成的目录那样。
1.1、自动生成博文目录
小工具的第一个核心功能,就是通过代码自动抽取标题,然后再包装一下插入文档中。基本实现原理:首先要求博主在写博文的时候,将主标题和次级标题用 HTML标签中的 title tag(如:h1、h2、h3...)包起来;
比如"1.1、自动生成博文目录"这个次级标题现在是段落的形式
将"1.1、自动生成博文目录"设置成"标题3"
然后通过 JS 代码遍历整个包含博文正文的 <div>,过滤出这些标签,再把它们组装成自定义列表的形式,再插入到HTML文档中,如下:
<dl> <dt>一、JAVA流式输入/输出原理</dt> <dt>二、输入输出流分类</dt> <dt>三、节点流和处理流</dt> <dd>3.1.节点流类型</dd> <dd>3.2.处理流类型</dd> <dt>四、InputStream(输入流)</dt> <dd>4.1.InputStream的基本方法</dd> <dt>五、OutputStream(输出流)</dt> <dd>5.1.OutputStream的基本方法</dd> <dt>六、Reader流</dt> <dd>6.1.Reader的基本方法</dd> <dt>七、Writer流</dt> <dd>7.1.Writer的基本方法</dd> <dt>八、节点流讲解</dt> <dt>九、处理流讲解</dt> <dd>9.1.第一种处理流——缓冲流(Buffering)</dd> <dd>9.2.第二种处理流——转换流</dd> <dd>9.3.第三种处理流——数据流</dd> <dd>9.4.打印流——Print</dd> <dd>9.5. 对象流——Object</dd> <dt>十、IO流总结</dt> </dl>
1.2、点击目录标题定位到标题对应的具体内容
常规实现方式:使用HTML的锚点链接
锚点也可以理解成为一种超链接,只不过它是网页内部的超链接
比如我们有一个网页很长很长,而且里面的内容,可以分为N个部分。这样的话,我们就可以在网页的顶部设置一些锚点,这样便可以方便浏览者点击相应的锚点,到达本页内相应的位置,而不必在一个很长的网页里自行寻找。
范例:使用HTML的锚点链接定位到具体的内容
1 <html> 2 <head> 3 <title>使用HTML的锚点链接定位到具体的内容</title> 4 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 5 </head> 6 <body> 7 <h1>目录导航</h1> 8 <dl> 9 <!--设置锚点:<a href="#title0">一、JAVA流式输入/输出原理</a> 10 点击这个超链接时就会自动定位到<h2 id="title0" name="title0">一、JAVA流式输入/输出原理</h2>这个标题所在的位置 11 --> 12 <dt><a href="#title0">一、JAVA流式输入/输出原理</a></dt> 13 <dt><a href="#title1">二、输入输出流分类</a></dt> 14 <dt><a href="#title2">三、节点流和处理流</a></dt> 15 <dd><a href="#title3">3.1.节点流类型</a></dd> 16 <dd><a href="#title4">3.2.处理流类型</a></dd> 17 <dt><a href="#title5">四、InputStream(输入流)</a></dt> 18 <dd><a href="#title6">4.1.InputStream的基本方法</a></dd> 19 <dt><a href="#title7">五、OutputStream(输出流)</a></dt> 20 <dd><a href="#title8">5.1.OutputStream的基本方法</a></dd> 21 <dt><a href="#title9">六、Reader流</a></dt> 22 <dd><a href="#title10">6.1.Reader的基本方法</a></dd> 23 <dt><a href="#title11">七、Writer流</a></dt> 24 <dd><a href="#title12">7.1.Writer的基本方法</a></dd> 25 <dt><a href="#title13">八、节点流讲解</a></dt> 26 <dt><a href="#title14">九、处理流讲解</a></dt> 27 <dd><a href="#title15">9.1.第一种处理流——缓冲流(Buffering)</a></dd> 28 <dd><a href="#title16">9.2.第二种处理流——转换流</a></dd> 29 <dd><a href="#title17">9.3.第三种处理流——数据流</a></dd> 30 <dd><a href="#title18">9.4.打印流——Print</a></dd> 31 <dd><a href="#title19">9.5. 对象流——Object</a></dd> 32 <dt><a href="#title20">十、IO流总结</a></dt> 33 </dl> 34 <hr/> 35 <div style="background-color:Red; width:100%;height:150px;"> 36 <!--经过测试发现,使用name的形式添加锚点在IE8和火狐下都不起作用,要设置Id才起作用 37 为了兼容,还是将name属性和id属性都一起写上,并且属性值设置成相同 38 --> 39 <h2 id="title0" name="title0">一、JAVA流式输入/输出原理</h2> 40 </div> 41 <div style="background-color:Yellow; width:100%;height:150px;"> 42 <h2 name="title1" id="title1">二、输入输出流分类</h2> 43 </div> 44 <div style="background-color:Silver; width:100%;height:150px;"> 45 <h2 name="title2" id="title2">三、节点流和处理流</h2> 46 <h3 name="title3" id="title3">3.1.节点流类型</h3> 47 <h3 name="title4" id="title4">3.2.处理流类型</h3> 48 </div> 49 <div style="background-color:Aqua; width:100%;height:150px;"> 50 <h2 name="title5" id="title5">四、InputStream(输入流)</h2> 51 <h3 name="title6" id="title6">4.1.InputStream的基本方法</h3> 52 </div> 53 <div style="background-color:Fuchsia; width:100%;height:150px;"> 54 <h2 name="title7" id="title7">五、OutputStream(输出流)</h2> 55 <h3 name="title8" id="title8">5.1.OutputStream的基本方法</h3> 56 </div> 57 <div style="background-color:Green; width:100%;height:150px;"> 58 <h2 name="title9" id="title9">六、Reader流</h2> 59 <h3 name="title10" id="title10">6.1.Reader的基本方法</h3> 60 </div> 61 <div style="background-color:Blue; width:100%;height:150px;"> 62 <h2 name="title11" id="title11">七、Writer流</h2> 63 <h3 name="title12" id="title12">7.1.Writer的基本方法</h3> 64 </div> 65 <div style="background-color:Olive; width:100%;height:150px;"> 66 <h2 name="title13" id="title13">八、节点流讲解</h2> 67 </div> 68 <div style="background-color:Green; width:100%;height:150px;"> 69 <h2 name="title14" id="title14">九、处理流讲解</h2> 70 <h3 name="title15" id="title15">9.1.第一种处理流——缓冲流(Buffering)</h3> 71 <h3 name="title16" id="title16">9.2.第二种处理流——转换流</h3> 72 <h3 name="title17" id="title17">9.3.第三种处理流——数据流</h3> 73 <h3 name="title18" id="title18">9.4.打印流——Print</h3> 74 <h3 name="title19" id="title19">9.5. 对象流——Object</h3> 75 </div> 76 <div style="background-color:Purple; width:100%;height:150px;"> 77 <h2 name="title20" id="title20">十、IO流总结</h2> 78 </div> 79 <div style="height:130px;"> </div> 80 <div style="height:130px;"> </div> 81 <div style="height:130px;"> </div> 82 </body> 83 </html>
这是使用HTML锚点链接的解决方案,也是一种常规的实现方式,这种方案我觉得用户体验不怎么好,跳转到具体内容的时候速度太快了,没有一种平滑过度的效果。
JavaScript实现方式
实现原理:首先通过调用 DOM 方法,判断出浏览器滚动条(scroll bar)的当前位置,记为 currentPos;然后计算出目标标题(target title)的距页面顶端的距离,记为 finalPos;最后通过一定的算法实现平滑过度。
二、源代码
下面是这个JS工具的相关源代码:
2.1 js代码
<script type="text/javascript"> /* 功能:生成博客目录的JS工具 测试:IE8,火狐,google测试通过 孤傲苍狼 2014-5-11 */ var BlogDirectory = { /* 获取元素位置,距浏览器左边界的距离(right)和距浏览器上边界的距离(top) */ getElementPosition:function (ele) { var topPosition = 0; var rightPosition = 0; while (ele){ topPosition += ele.offsetTop; rightPosition += ele.offsetRight; ele = ele.offsetParent; } return {top:topPosition, right:rightPosition}; }, /* 获取滚动条当前位置 */ getScrollBarPosition:function () { var scrollBarPosition = document.body.scrollTop || document.documentElement.scrollTop; return scrollBarPosition; }, /* 移动滚动条,finalPos 为目的位置,internal 为移动速度 */ moveScrollBar:function(finalpos, interval) { //若不支持此方法,则退出 if(!window.scrollTo) { return false; } //窗体滚动时,禁用鼠标滚轮 window.onmousewheel = function(){ return false; }; //清除计时 if (document.body.movement) { clearTimeout(document.body.movement); } var currentpos =BlogDirectory.getScrollBarPosition();//获取滚动条当前位置 var dist = 0; if (currentpos == finalpos) {//到达预定位置,则解禁鼠标滚轮,并退出 window.onmousewheel = function(){ return true; } return true; } if (currentpos < finalpos) {//未到达,则计算下一步所要移动的距离 dist = Math.ceil((finalpos - currentpos)/10); currentpos += dist; } if (currentpos > finalpos) { dist = Math.ceil((currentpos - finalpos)/10); currentpos -= dist; } var scrTop = BlogDirectory.getScrollBarPosition();//获取滚动条当前位置 window.scrollTo(0, currentpos);//移动窗口 if(BlogDirectory.getScrollBarPosition() == scrTop)//若已到底部,则解禁鼠标滚轮,并退出 { window.onmousewheel = function(){ return true; } return true; } //进行下一步移动 var repeat = "BlogDirectory.moveScrollBar(" + finalpos + "," + interval + ")"; document.body.movement = setTimeout(repeat, interval); }, htmlDecode:function (text){ var temp = document.createElement("div"); temp.innerHTML = text; var output = temp.innerText || temp.textContent; temp = null; return output; }, /* 创建博客目录, id表示包含博文正文的 div 容器的 id, mt 和 st 分别表示主标题和次级标题的标签名称(如 H2、H3,大写或小写都可以!), interval 表示移动的速度 */ createBlogDirectory:function (id, mt, st, interval){ //获取博文正文div容器 var elem = document.getElementById(id); if(!elem) return false; //获取div中所有元素结点 var nodes = elem.getElementsByTagName("*"); //创建博客目录的div容器 var divSideBar = document.createElement('DIV'); divSideBar.className = 'catSideBar'; divSideBar.setAttribute('id', 'catSideBar'); var divSideBarTab = document.createElement('DIV'); divSideBarTab.setAttribute('id', 'catSideBarTab'); divSideBar.appendChild(divSideBarTab); var h2 = document.createElement('H2'); divSideBarTab.appendChild(h2); var txt = document.createTextNode('目录导航'); h2.appendChild(txt); var divSideBarContents = document.createElement('DIV'); divSideBarContents.style.display = 'none'; divSideBarContents.setAttribute('id', 'catSideBarContents'); divSideBar.appendChild(divSideBarContents); //创建自定义列表 var dlist = document.createElement("dl"); divSideBarContents.appendChild(dlist); var num = 0;//统计找到的mt和st mt = mt.toUpperCase();//转化成大写 st = st.toUpperCase();//转化成大写 //遍历所有元素结点 for(var i=0; i<nodes.length; i++) { if(nodes[i].nodeName == mt|| nodes[i].nodeName == st) { //获取标题文本 var nodetext = nodes[i].innerHTML.replace(/<\/?[^>]+>/g,"");//innerHTML里面的内容可能有HTML标签,所以用正则表达式去除HTML的标签 nodetext = nodetext.replace(/ /ig, "");//替换掉所有的 nodetext = BlogDirectory.htmlDecode(nodetext); //插入锚 nodes[i].setAttribute("id", "blogTitle" + num); var item; switch(nodes[i].nodeName) { case mt: //若为主标题 item = document.createElement("dt"); break; case st: //若为子标题 item = document.createElement("dd"); break; } //创建锚链接 var itemtext = document.createTextNode(nodetext); item.appendChild(itemtext); item.setAttribute("name", num); item.onclick = function(){ //添加鼠标点击触发函数 var pos = BlogDirectory.getElementPosition(document.getElementById("blogTitle" + this.getAttribute("name"))); if(!BlogDirectory.moveScrollBar(pos.top, interval)) return false; }; //将自定义表项加入自定义列表中 dlist.appendChild(item); num++; } } if(num == 0) return false; /*鼠标进入时的事件处理*/ divSideBarTab.onmouseenter = function(){ divSideBarContents.style.display = 'block'; } /*鼠标离开时的事件处理*/ divSideBar.onmouseleave = function() { divSideBarContents.style.display = 'none'; } document.body.appendChild(divSideBar); } }; window.onload=function(){ /*页面加载完成之后生成博客目录*/ BlogDirectory.createBlogDirectory("cnblogs_post_body","h2","h3",20); } </script>
2.2. CSS样式代码
/*生成博客目录的CSS*/ #catSideBar{ font-size:20px; font-family:Arial, Helvetica, sans-serif; text-align:left; position:fixed;/*将div的位置固定到距离top:50px,right:0px的位置,这样div就会处在最右边的位置,距离顶部50px*/ top:50px; left:0px; width: auto; height: auto; } #catSideBarTab{ float:left; width:30px; border:1px solid #e5e5e5; border-right:none; text-align:center; background:#C1CDC1; border-radius: 10px; } #catSideBarContents{ font-size:14px; float:left; overflow:auto; overflow-x:hidden;!important; width:200px; min-height:110px; max-height:660px; border:1px solid #e5e5e5; border-right:none; background:#C1CDC1; border-radius: 10px; } #catSideBarContents dl{ margin:0; padding:0; } #catSideBarContents dt{ margin-top:5px; margin-left:5px; height:18px; line-height:18px; } #catSideBarContents dd, dt { cursor: pointer; } #catSideBarContents dd{ margin-left:20px; height:18px; line-height:18px; } #catSideBarContents dd:hover, dt:hover { color:#A7995A; }
2.3.由JavaScript动态生成的HTML代码结构如下
1 <div id="sideBar" class="sideBar"> 2 <div id="sideBarTab"> 3 <h2>目录导航</h2> 4 </div> 5 <div id="sideBarContents" style="display: none;"> 6 <dl> 7 <dt name="0">一、功能描述</dt> 8 <dd name="1">1.1、自动生成博文目录</dd> 9 <dd name="2">1.2、点击目录标题定位到标题对应的具体内容</dd> 10 <dt name="3">二、源代码</dt> 11 <dd name="4">2.1 js代码</dd> 12 <dd name="5">2.2. CSS样式代码</dd> 13 <dt name="6">三、JS工具的使用</dt> 14 <dd name="7">3.1、后台管理的相关设置</dd> 15 <dd name="8">3.2、博文标题样式设置</dd> 16 <dt name="9">四、总结</dt> 17 </dl> 18 </div> 19 </div>
三、JS工具的使用
3.1、后台管理的相关设置
进入到博客后台管理,点击设置
然后在这里添加CSS样式代码,将上面的CSS样式代码直接copy到这里即可
在这里添加javascript脚本,将上面的JS源代码直接copy到这里即可
点击【保存】按钮,完成设置
3.2、博文标题样式设置
将博文标题的样式设置成标题
例如:
将"三、JS工具的使用"这个一级标题的标题样式设置成【标题2】
将"3.1、后台管理的相关设置"这个二级标题的标题样式设置成【标题3】
这样执行这段代码时就会生成如下图所示的博客目录了
1 window.onload=function(){ 2 /*页面加载完成之后生成博客目录*/ 3 BlogDirectory.createBlogDirectory("cnblogs_post_body","h2","h3",20); 4 }
生成的目录导航在紧挨着页面最右边的滚动条,鼠标移动到【目录导航】时就会显示生成的目录内容,鼠标离开就自动隐藏目录
点击目录上的标题就会平滑跳转到该标题对应的具体内容。
四、总结
开发这个小工具的过程中还是遇到了不少的细节问题的,好在都解决了,目前做出来的效果总体来说还算比较满意,现在将代码分享出来给朋友们,可以自由修改和使用,希望对广大朋友们有所帮助吧!