Progress Bar

This example shows how to implement a smoothly scrolling progress bar.

We start with an initial state with a button that issues a POST to /start to begin the job:

<div hx-target="this" hx-swap="outerHTML">
  <h3>Start Progress</h3>
  <button class="btn" hx-post="/start">
            Start Job

This div is then replaced with a new div that reloads itself every 600ms:

<div hx-target="this"
    hx-trigger="load delay:600ms" 
  <div class="progress">
    <div id="pb" class="progress-bar" style="width:0%"></div>

This HTML is rerendered every 600 milliseconds, with the โ€œwidthโ€ style attribute on the progress bar being updated. Because there is an id on the progress bar div, htmx will smoothly transition between requests by settling the style attribute into its new value. This, when coupled with CSS transitions, make the visual transition continuous rather than jumpy.

Finally, when the process is complete, a restart button is added to the UI (we are using the class-tools extension in this example):

<div hx-target="this"
  <div class="progress">
      <div id="pb" class="progress-bar" style="width:100%"></div>
<button id="restart-btn" class="btn" hx-post="/start" classes="add show:600ms">
  Restart Job

This example uses styling cribbed from the bootstrap progress bar:

.progress {
    height: 20px;
    margin-bottom: 20px;
    overflow: hidden;
    background-color: #f5f5f5;
    border-radius: 4px;
    box-shadow: inset 0 1px 2px rgba(0,0,0,.1);
.progress-bar {
    float: left;
    width: 0%;
    height: 100%;
    font-size: 12px;
    line-height: 20px;
    color: #fff;
    text-align: center;
    background-color: #337ab7;
    -webkit-box-shadow: inset 0 -1px 0 rgba(0,0,0,.15);
    box-shadow: inset 0 -1px 0 rgba(0,0,0,.15);
    -webkit-transition: width .6s ease;
    -o-transition: width .6s ease;
    transition: width .6s ease;
Server Requests ↑ Show