Create Automatic Table Of Contents In JavaScript - TOC Plugin

Wikipedia loves adding an automatic Table Of Contents list for each article it publishes because it engages readers more by providing more accessibility and better navigation. Google prefers high-quality content which is well organized and formatted. Adding elements like tables, numbered sections, and an auto-generated TOC is a big bonus for ranking high in SERPS.

Update: TOC Plugin Version 2.0 has been released.  More advanced with more features!

In this article, we will share a lightweight TOC plugin written in pure JavaScript to generate an automatic table of contents from the section headings of a web page. 

DEMO: The contents table bellow is dynamically created on page load using this TOC Script.

What is Table Of Contents or TOC?

In websites, a table of contents abbreviated as TOC or ToC, is a link list, usually found on a web page placed right after the first paragraph. Each anchor link inside a TOC takes you to a specific section of the web page.

An HTML TOC provides a quick way to jump to the desired section of a page. It usually includes the titles of the first-level headers (headings) or second level headers(subheadings).

In printable work, a TOC refers to the index page of the book which contains the page number to each chapter. TOC for books are more in-depth and comprehensive, containing not only section titles but descriptions, author names, and subheadings.

What Is TOC Plugin?

TOC plugin developed by MBT, is an automatic solution to the tedious method of creating a table of contents manually for each web page. It auto-generates a user-friendly TOC for your lengthy blog articles. It is coded in pure JavaScript and loads lightening fast. Contents table generated using TOC plugin is easily crawled and indexed by search robots.

• Read this interesting article by MOZ which mentions SEO support for all JS methods that we have used so far in building TOC plugin.

SEO ALERT: Just minutes after this post was published. Google not only indexed the TOC  anchor Links but also added a "Jump to" label to identify that it is an anchor link that jumps to a particular section. See it to believe it. :)

I have not included lower level heading tags (i.e. h3/h4/h5/h6) in TOC plugin because a blog post is neither a wiki nor a long lengthy book, it is best to show only major headlines for simplicity and accessibility. Adding subheadings or lower levels inside a TOC list only makes it longer in length thus pushing down your main content and destroying visibility.

So far many developers have written a dynamic ToC script but most of these scripts are either coded in jQuery or they are render-blocking JS eating up your page load time. You may even find TOC generator but these scripts again lack flexibility and ease of customization.

TOC should be added only to those articles which are lengthy or contain at least four headings. On contrary, some TOC generators will add the list on all your pages whether containing several headings or just a single heading, which of course is not a sensible thing to do.

jQuery table of contents is much slower compared to this plugin built with traditional pure JS. JavaScript is executed much faster by browsers compared to a JS library (jQuery) that needs to be imported first.

Features of TOC Plugin:

It is the first JavaScript plugin of its kind that is unique in several ways as mentioned below:

• Coded in pure JavaScript - just 10 lines of code!
• Lightweight and fast.
• SEO Friendly
• Adds unique ID to each section automatically.
• Creates both ordered or unordered list
• Contains a Toggle button
• Show on any location you choose
• Easily Customized
• Mobile responsive
• Executes only when invoked!

Pseudo Code Of TOC Plugin

Understand how the TOC Script works in plain English. The numbered list below is the pseudo code for our TOC plugin. It is a simplified description of the JavaScript code we wrote.

1. Create a function to print headline links
2. Count the number of heading sections on a page
3. Run a loop equivalent to the number of heading sections
4. Extract text content from the heading titles
5. Give each heading a different ID
6. Convert the heading text into an anchor link
7. Print the heading anchor links inside a bullet list
8. Find the location by TOC ID to display the list
9. End the loop
10. Trigger the function only when invoked inside the page

Following is the pseudo code for the toggle button which shows or hides the TOC.

1. Create a new function to show/hide the TOC.
2. Show the TOC by default
3. Use a conditional statement to check if TOC is hidden or visible.
4. Use CSS to show or hide the TOC
5. Trigger the function only when button is clicked

How To Install TOC Plugin in Blogger Blogs?

I am sharing below the method of adding TOC plugin in Blogspot blogs but you can apply almost the exact same method for installing this plugin on any website you want, may it be hosted on Wordpress or anywhere else.

Follow these steps to install it in BlogSpot:

1. Sign in Blogger > Template
2. Backup your template
3. Click "Edit HTML"
4. Just above </head> tag paste the following source links:

          
   <link href='http://fortawesome.github.io/Font-Awesome/assets/font-awesome/css/font-awesome.css' rel='stylesheet'/>           
   <link href='http://fonts.googleapis.com/css?family=Oswald' rel='stylesheet' type='text/css'/>
           
   <script type='text/javascript'>              
   //<![CDATA[           
   //*************TOC plugin by MyBloggerTricks.com           
   function mbtTOC() {var mbtTOC=i=headlength=gethead=0;           
   headlength = document.getElementById("post-toc").getElementsByTagName("h2").length;for (i = 0; i < headlength; i++)           
   {gethead = document.getElementById("post-toc").getElementsByTagName("h2")[i].textContent;document.getElementById("post-toc").getElementsByTagName("h2")[i].setAttribute("id", "point"+i);mbtTOC = "<li><a href='#point"+i+"'>"+gethead+"</a></li>";document.getElementById("mbtTOC").innerHTML += mbtTOC;}}function mbtToggle() {var mbt = document.getElementById('mbtTOC');if (mbt .style.display === 'none') {mbt .style.display = 'block';} else {mbt .style.display = 'none';}}           
   //]]>              
   </script>
        

   
   
   

   Note that I am adding source links to Oswald font and Font-Awesome for styling purposes. You may or may not wish to add them. The code inside purple highlighted lines is the major TOC script in no more than 10 lines!

   
   
   

   Make this change only if needed:

   
   
   

   The major heading tag in blogger is H2 but if you are selecting the subheading tag in blogger editor then your default tag would be H3. If you are using the subheading tag as your main heading in your blog posts then please replace h2 with h3 thrice in the code above.  TOC plugin will not work if your heading tag is not correct.

   
   



5. Next search ]]></b:skin> and just above it paste the following CSS code:
   
   

         
   /*####Automatic TOC Plugin by MyBloggerTricks####*/          
   .mbtTOC{border:5px solid #f7f0b8;box-shadow:1px 1px 0 #EDE396;background-color:#FFFFE0;color:#707037;line-height:1.4em;margin:30px auto;padding:20px 30px 20px 10px; font-family:oswald, arial;display: block;width: 70%;}           
   .mbtTOC ol,.mbtTOC ul {margin:0;padding:0;}           
   .mbtTOC ul {list-style:none;}           
   .mbtTOC ol li,.mbtTOC ul li {padding:15px 0 0; margin:0 0 0 30px;font-size:15px;}           
   .mbtTOC a{color:#0080ff;text-decoration:none;}           
   .mbtTOC a:hover{text-decoration:underline; }
           
   .mbtTOC button{background:#FFFFE0; font-family:oswald, arial; font-size:20px;position:relative; outline:none;cursor:pointer; border:none; color:#707037;padding:0 0 0 15px;}           
   .mbtTOC button:after{content: "\f0dc"; font-family:FontAwesome; position:relative; left:10px; font-size:20px;}
        

   
   
   

   Make these color changes if you want:

   
   
   
   
   
   • To change background color of TOC box edit #FFFFE0
   
   
   
   • To change border color of TOC box edit #f7f0b8
   
   
   
   • To change font color of TOC headline text edit #707037
   
   
   
   • To change anchor link color edit #0080ff
   
   
   
   • To change font size of anchor links edit 15px
   
   
   
   • To change font size of TOC headline text edit 20px
   
   
   
   



6. Finally search for <data:post.body/> and replace it with the code below:
   
   

   Note: You will find two or more occurrences of this code so replace all its instances with the code below. TOC Plugin will not work if you replace <data:post.body/>  just once.

   
   
   

   <div id="post-toc"><data:post.body/></div>

   
   



7. Save your template and you are all done!

Show Table Of Contents Automatically in Blog Posts

Each time you may want to display TOC inside a specific post, follow these two steps.

Step #1  Mention Location Of TOC Container

It is best to display TOC right after your starting paragraph or show it before the first heading on your blog post.

To do this, switch to "HTML" mode of blogger editor and then paste the following HTML code just before the first heading or anywhere else you may want.

<div class="mbtTOC"> 
    <button onclick="mbtToggle()">Contents</button> 
    <ol id="mbtTOC"></ol> 
    </div>

• You can replace the text "Contents" with any other text you may like.



• If in case your headings already contain numbers in beginning then replace ol with ul.

Step #2    Activate TOC Plugin

Finally, its time to invoke the plugin so that it could auto-generate a TOC on page load,

To do this, paste the following JS code at the bottom of your blogger editor where your post ends:

<script>mbtTOC();</script>

Publish your post and see the magic! :)

TOC Plugin Copyrights

© 2008-2017 MyBloggerTricks.com

Version: 1.0  2017/02/14

TOC Plugin by MyBloggerTricks (MBT) is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.

You are most welcomed to share the plugin with your readership as long as you attach attribution link back to this page. You are most welcomed to use the plugin in your commercial products as long as you keep the source credits intact.

Need Help With TOC Plugin?

I tried my best making this tutorial as easy as possible but if there is anything you could not understand then please feel free to post your queries below in the comment section. I would love to answer as soon as possible.

I hope it adds a positive impact on your SERPS ranking and help you in making your content more search-friendly. I will develop the plugin with time, adding more features and functionalities if required. Till then, I would love to hear your feedback on this.  :)