4.6.1 • Public • Published


Javascript library to load pages using ajax and replace the content in the current page. It changes the title, the url, css and javascript. You can use this library to improve the page load speed and create beautiful page transitions. It has the following features:

  • No dependencies
  • Superlight
  • It can be used with regular links and forms
  • Follows the progressive enhancement strategy: if javascript fails, the web page keeps working
  • Built with ES6, so you may need a transpiler for old browser support

Other libraries with a similar purpose are barba.js, turbolinks or highway. The main aim of page-loader is to be lighter and less magical, in order to be more flexible and customizable.



npm install @oom/page-loader



Let's start with the following html code:

<!DOCTYPE html>
    <meta charset="utf-8">
    <title>Page title</title>
    <link rel="stylesheet" href="styles.css">
    <script src="scripts.js"></script>
    <nav class="menu">
        <a href="section1.html">Section 1</a>
        <a href="section2.html">Section 2</a>
        <a href="section3.html">Section 3</a>
    <main class="content">
        <h1>This is the first section</h1>

        <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
        tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,
        quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo
        consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse
        cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
        proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>


Use javascript for a complete experience:

import Navigator from "./vendors/@oom/page-loader/src/navigator.js";

const nav = new Navigator(async (load, event) => {
  //Load the page
  const page = await load();

  await page.replaceStyles(); //Load the new css styles defined in <head> not present currently
  await page.replaceScripts(); //Load the new js files defined in <head> not present currently
  await page.replaceContent("main"); //Replace the <main> element
  await page.updateState(); //Update the page status (change url, title etc)
  await page.resetScroll(); //Reset the scroll position

//Init the navigation, capturing all clicks in links and form submits

//Optionally, you can filter links and forms to disable this behaviour
nav.addFilter((el) => !el.classList.contains("no-loader"));

//For example, to disable forms:
nav.addFilter((el) => el.tagName !== "FORM");

//Subscribe to events
nav.on("error", (err) => console.error(err));

//You can go manually to other url when you want

//Or submit a form via ajax
const form = document.getElementById("my-form");

//And handle downloads (links with download attribute)
nav.download(async (download, event, link) => {
  await download();


A page instance contains the info about the loaded page. It has the following methods and properties:

const nav = new Navigator(async (load, event, target, submitter) => {
  //By clicking a link, the target is the A element
  //By submitting a form, the target is the form but you can get the submitter element (the button being pressed)
  const trigger = submitter || target;


  const page = await load();

  //Replace an element in the document with the same element in the page
  await page.replaceContent("#content");

  //Append the children of the loaded page to the same element in the document
  await page.appendContent("#content");

  //Remove content from the document
  await page.removeContent("#content > .unwanted");

  //Change the css styles used in the new page (<link rel="stylesheet"> in <head>).
  await page.replaceStyles();

  //Change the js styles used in the new page (<script src="..."> in <head>).
  await page.replaceScripts();

  //Performs a document.querySelector in the page. Throws an exception on empty result
  await page.querySelector("p");

  //Performs a document.querySelectorAll in the page. Throws an exception on empty result
  await page.querySelectorAll("p");

  //Runs a history.pushState changing the url and title.
  await page.updateState();

  //Reset the page scroll to top (or to the #target element)
  await page.resetScroll();

  page.dom; //HTMLDocument with the content of the page
  page.url; //The url of the loaded page
  page.status; //The http status code of the ajax response



  • beforeFilter (element, url, [submitter])
  • beforeLoad (element, url, [submitter])
  • load (element, loader, event, [submitter])
  • error (error, element, loader, event, [submitter])


There's an online demo here: https://oom-components.github.io/page-loader/

Package Sidebar


npm i @oom/page-loader

Weekly Downloads






Unpacked Size

24.1 kB

Total Files


Last publish


  • oscarotero