Reading progress bar in Grav CMS

Hi there! I am looking for solution of reading progress bar in grav cms. I found only plugin for wordpress article is here

As I understood we are haven’t ready plugin on the official site. So is it possible use only html and css for that?


I saw many examples with percentage progress bar etc. But I need at least something similar bar on the top. The rest I can customize through css. Somebody knows how it is will work in Grav CMS?

@alfabuster, There is no prêt-à-porter plugin for this. However, the Typescript for this seems pretty simple. See

Thanks for reply. Yes this is similar, I want to use this one

But how it works in Grav CMS. I connect this script through CDN, but what next. As I understand it should be something like container <div> </div> put in post.html.twig and customize using css.

What to do with the following which is mentioned on the library’s website?

Initialize the scrolld library and done.

var scrolld = new Scrolld();

You might need to track the scroll position in a specific container. E.g. article.

var scrolld = new Scrolld(document.querySelector('#article'));

Get the current scroll position.


I only understand this is javascripts, but where I should to put this code?

It seems the missing piece in your understanding here is how to add external and inline JS (and CSS).

Basically you need to add them into a twig template, probably the base one that includes the other assets.

Have a look at:

  • Asset Manager | Grav Documentation - note that you may need to add some assets to the group which outputs them at the bottom of page
  • note that there are some handy new Twig tags for scripts and styles which you can use instead of the {% do assets.AddJs() %} etc outlined in the main section there.

Hope that helps.

@alfabuster, Maybe a DIY approach with a step-by-step tutorial might help…

Google is your friend… Search the web using keywords like “js page scroll progress example”.

Pick the first response and after reading it, try the following using the default Quark theme:

  • Copy css from the tutorial and the complete javasscript, into the end of block ‘bottom’ in page /user/themes/quark/templates/partials/base.html.twig.

    {% block bottom %}
      {{ assets.js('bottom')|raw }}
    {% endblock %}
  • The script checks the scrolled position of an element on the page. This must be an element at the top, right below <body>. In Quark this is element with id “#page-wrapper”.

    In the copied script, replace
    const section = document.querySelector('section');
    const section = document.querySelector('#page-wrapper');

  • Add an element showing the progress by copying the element from the tutorial (<div class="progressBar"></div>) right above the script you just inserted.

  • The end result should look like:

    {% block bottom %}
      {{ assets.js('bottom')|raw }}
      <div class="progressBar"></div>
        const progressBar = document.querySelector('.progressBar');
        const section = document.querySelector('#page-wrapper');
        const scrollProgressBar = () => {
            let scrollDistance = -(section.getBoundingClientRect().top);
            let progressPercentage =
                (scrollDistance /
                    (section.getBoundingClientRect().height - 
                        document.documentElement.clientHeight)) * 100;
            let val = Math.floor(progressPercentage);
   = val + '%';
            if (val < 0) {
       = '0%';
        window.addEventListener('scroll', scrollProgressBar);
        .progressBar {
          position: fixed;
          top: 0;
          left: 0;
          height: 8px;
          background: linear-gradient(to right, #ff5f6d, #ffc371);
          width: 0;
          z-index: 100;
          transition: width 0.2s ease-out;
    {% endblock %}
  • That’s it folks!

  • Open your website and shed tears of joy… Or despair…


  • Adapt the code for your own theme. You might need to change the #page-wrapper with an id/class/tag of another element.
  • Adjust css to your liking.
  • By adding the code to base.html.twig, each and every page will show the progress bar. You might choose to add the code to only certain templates.
1 Like

hughbris, pamtbaau thanks for reply.

With your’s short tutorial now it works perfect.

Before create this topic I read 2-3 tutorials, but I can’t get success, probably I put code in the wrong place, I use Mediator theme.