postman/README.md
2024-07-10 11:21:15 -03:00

1.5 KiB

About

Postman delivers the assets of a web page. The library is typically paired with a progress bar that reports progress to the client.

Examples

Progress bar

The following example delivers fonts, scripts, images and stylesheets with the help of a progress bar. The progress bar is removed once the delivery is complete:

index.html

<!DOCTYPE html>
<head>
  <title>Postman</title>
  <script type="module" src="/postman.js"></script>
</head>
<body>
  <div class="postman loader">
    <progress value="0" max="100"></progress>
    <span class="percentage"></span>
   </div>
  </div>
</body>
</html>

postman.js

import postman, { item } from "postman";

const progressBar = document.querySelector("progress")
const span = document.querySelector(".percentage");
postman(
  item.font("Kanit Regular", "url(/fonts/kanit-regular.ttf)"),
  item.script("/js/app.js"),
  item.image("/images/app.png"),
  item.css("/css/app.css"),
  item.progress((percent) => {
    progressBar.value = percent;
    span.innerText = `${percent}%`;
  })
).fetch()
 .then((package) => {
    /* Add page assets */
    package.fonts.forEach((font) => documents.fonts.add(font));
    package.scripts.forEach((script) => document.body.appendChild(script));
    package.css.forEach((css) => document.head.appendChild(css));

    /* Replace progress bar */
    progressBar.remove();
    span.remove();
 })

License

BSD Zero Clause
See LICENSE