javascriptjqueryhashhyperlinksections

Highlight Menu Item when Scrolling Down to Section


I know this question have been asked a million times on this forum, but none of the articles helped me reach a solution.

I made a little piece of jquery code that highlights the hash-link when you scroll down to the section with the same id as in the hash-link.

$(window).scroll(function() {
    var position = $(this).scrollTop();

    $('.section').each(function() {
        var target = $(this).offset().top;
        var id = $(this).attr('id');

        if (position >= target) {
            $('#navigation > ul > li > a').attr('href', id).addClass('active');
        }
    });
});

The problem now is that it highlights all of the hash-links instead of just the one that the section has a relation to. Can anyone point out the mistake, or is it something that I forgot?


Solution

  • EDIT:

    I have modified my answer to talk a little about performance and some particular cases.

    If you are here just looking for code, there is a commented snippet at the bottom.


    Original answer

    Instead of adding the .active class to all the links, you should identify the one which attribute href is the same as the section's id.

    Then you can add the .active class to that link and remove it from the rest.

            if (position >= target) {
                $('#navigation > ul > li > a').removeClass('active');
                $('#navigation > ul > li > a[href=#' + id + ']').addClass('active');
            }
    

    With the above modification your code will correctly highlight the corresponding link. Hope it helps!


    Improving performance

    Even when this code will do its job, is far from being optimal. Anyway, remember:

    We should forget about small efficiencies, say about 97% of the time: premature optimization is the root of all evil. Yet we should not pass up our opportunities in that critical 3%. (Donald Knuth)

    So if, event testing in a slow device, you experience no performance issues, the best you can do is to stop reading and to think about the next amazing feature for your project!

    There are, basically, three steps to improve the performance:

    Make as much previous work as possible:

    In order to avoid searching the DOM once and again (each time the event is triggered), you can cache your jQuery objects beforehand (e.g. on document.ready):

    var $navigationLinks = $('#navigation > ul > li > a');
    var $sections = $(".section"); 
    

    Then, you can map each section to the corresponding navigation link:

    var sectionIdTonavigationLink = {};
    $sections.each( function(){
        sectionIdTonavigationLink[ $(this).attr('id') ] = $('#navigation > ul > li > a[href=\\#' + $(this).attr('id') + ']');
    });
    

    Note the two backslashes in the anchor selector: the hash '#' has a special meaning in CSS so it must be escaped (thanks @Johnnie).

    Also, you could cache the position of each section (Bootstrap's Scrollspy does it). But, if you do it, you need to remember to update them every time they change (the user resizes the window, new content is added via ajax, a subsection is expanded, etc).

    Optimize the event handler:

    Imagine that the user is scrolling inside one section: the active navigation link doesn't need to change. But if you look at the code above you will see that actually it changes several times. Before the correct link get highlighted, all the previous links will do it as well (because their corresponding sections also validate the condition position >= target).

    One solution is to iterate the sections for the bottom to the top, the first one whose .offset().top is equal or smaller than $(window).scrollTop is the correct one. And yes, you can rely on jQuery returning the objects in the order of the DOM (since version 1.3.2). To iterate from bottom to top just select them in inverse order:

    var $sections = $( $(".section").get().reverse() );
    $sections.each( ... );
    

    The double $() is necessary because get() returns DOM elements, not jQuery objects.

    Once you have found the correct section, you should return false to exit the loop and avoid to check further sections.

    Finally, you shouldn't do anything if the correct navigation link is already highlighted, so check it out:

    if ( !$navigationLink.hasClass( 'active' ) ) {
        $navigationLinks.removeClass('active');
        $navigationLink.addClass('active');
    }
    

    Trigger the event as less as possible:

    The most definitive way to prevent high-rated events (scroll, resize...) from making your site slow or unresponsive is to control how often the event handler is called: sure you don't need to check which link needs to be highlighted 100 times per second! If, besides the link highlighting, you add some fancy parallax effect you can ran fast intro troubles.

    At this point, sure you want to read about throttle, debounce and requestAnimationFrame. This article is a nice lecture and give you a very good overview about three of them. For our case, throttling fits best our needs.

    Basically, throttling enforces a minimum time interval between two function executions.

    I have implemented a throttle function in the snippet. From there you can get more sophisticated, or even better, use a library like underscore.js or lodash (if you don't need the whole library you can always extract from there the throttle function).

    Note: if you look around, you will find more simple throttle functions. Beware of them because they can miss the last event trigger (and that is the most important one!).

    Particular cases:

    I will not include these cases in the snippet, to not complicate it any further.

    In the snippet below, the links will get highlighted when the section reaches the very top of the page. If you want them highlighted before, you can add a small offset in this way:

    if (position + offset >= target) {
    

    This is particullary useful when you have a top navigation bar.

    And if your last section is too small to reach the top of the page, you can hightlight its corresponding link when the scrollbar is in its bottom-most position:

    if ( $(window).scrollTop() >= $(document).height() - $(window).height() ) {
        // highlight the last link
    

    There are some browser support issues thought. You can read more about it here and here.

    Snippet and test

    Finally, here you have a commented snippet. Please note that I have changed the name of some variables to make them more descriptive.

    // cache the navigation links 
    var $navigationLinks = $('#navigation > ul > li > a');
    // cache (in reversed order) the sections
    var $sections = $($(".section").get().reverse());
    
    // map each section id to their corresponding navigation link
    var sectionIdTonavigationLink = {};
    $sections.each(function() {
        var id = $(this).attr('id');
        sectionIdTonavigationLink[id] = $('#navigation > ul > li > a[href=\\#' + id + ']');
    });
    
    // throttle function, enforces a minimum time interval
    function throttle(fn, interval) {
        var lastCall, timeoutId;
        return function () {
            var now = new Date().getTime();
            if (lastCall && now < (lastCall + interval) ) {
                // if we are inside the interval we wait
                clearTimeout(timeoutId);
                timeoutId = setTimeout(function () {
                    lastCall = now;
                    fn.call();
                }, interval - (now - lastCall) );
            } else {
                // otherwise, we directly call the function 
                lastCall = now;
                fn.call();
            }
        };
    }
    
    function highlightNavigation() {
        // get the current vertical position of the scroll bar
        var scrollPosition = $(window).scrollTop();
    
        // iterate the sections
        $sections.each(function() {
            var currentSection = $(this);
            // get the position of the section
            var sectionTop = currentSection.offset().top;
    
            // if the user has scrolled over the top of the section  
            if (scrollPosition >= sectionTop) {
                // get the section id
                var id = currentSection.attr('id');
                // get the corresponding navigation link
                var $navigationLink = sectionIdTonavigationLink[id];
                // if the link is not active
                if (!$navigationLink.hasClass('active')) {
                    // remove .active class from all the links
                    $navigationLinks.removeClass('active');
                    // add .active class to the current link
                    $navigationLink.addClass('active');
                }
                // we have found our section, so we return false to exit the each loop
                return false;
            }
        });
    }
    
    $(window).scroll( throttle(highlightNavigation,100) );
    
    // if you don't want to throttle the function use this instead:
    // $(window).scroll( highlightNavigation );
    #navigation {
        position: fixed;
    }
    #sections {
        position: absolute;
        left: 150px;
    }
    .section {
        height: 200px;
        margin: 10px;
        padding: 10px;
        border: 1px dashed black;
    }
    #section5 {
        height: 1000px;
    }
    .active {
        background: red;
    }
    <script src="https://ajax.googleapis.com/ajax/libs/jquery/2.1.1/jquery.min.js"></script>
    <div id="navigation">
        <ul>
            <li><a href="#section1">Section 1</a></li>
            <li><a href="#section2">Section 2</a></li>
            <li><a href="#section3">Section 3</a></li>
            <li><a href="#section4">Section 4</a></li>
            <li><a href="#section5">Section 5</a></li>
        </ul>
    </div>
    <div id="sections">
        <div id="section1" class="section">
            I'm section 1
        </div>
        <div id="section2" class="section">
            I'm section 2
        </div>
        <div id="section3" class="section">
            I'm section 3
        </div>
        <div id="section4" class="section">
            I'm section 4
        </div>
        <div id="section5" class="section">
            I'm section 5
        </div>
    </div>

    And in case you are interested, this fiddle tests the different improvements we have talked about.

    Happy coding!