Interaction · Complete runnable example

Async button state simulation

Show the full lifecycle of a local action without pretending to call a server.

Live example

This preview runs in an isolated document. Clipboard writes and saved preferences may be blocked, and printing requires the standalone file. A dialog affects only the example. Reset reloads the original example state.

When to use it

Use this example to study button feedback while a task is in progress. A 900ms local timer produces the explicitly selected outcome, allowing both success and error paths to be reviewed offline.

Try the important details

  1. Run the success path and try activating the button repeatedly while it is loading.
  2. Choose Error, run again, then choose Success and retry.
  3. Reset the demonstration and inspect the idle state, attempt count, and keyboard focus.

How it works

  • A loading guard and disabled action controls prevent repeated work. The chosen outcome is captured before the timer begins.
  • The action surface exposes aria-busy while a separate status region announces progress and completion.
  • Both outcomes use truthful simulation language. Error exposes retry, reset returns to idle, and reduced motion stops spinner animation.

The complete source

The preview, copied text, and downloaded file use this same document.

HTML

<!doctype html>
<!--
MIT License

Copyright (c) 2026 MRHTML

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
-->
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <meta
      http-equiv="Content-Security-Policy"
      content="default-src 'none'; style-src 'unsafe-inline'; script-src 'unsafe-inline'; img-src data: blob:; connect-src 'none'; form-action 'none'; object-src 'none'; base-uri 'none'"
    />
    <title>Every state has a place. | MRHTML example</title>
    <style>
      :root {
        color-scheme: light;
        --ink: #202b36;
        --muted: #596675;
        --line: #d5dde4;
        --blue: #2349c8;
        --pale: #edf1ff;
        --paper: #fff;
        --danger: #a32b30;
        font-family: Arial, Helvetica, sans-serif;
      }
      * {
        box-sizing: border-box;
      }
      [hidden] {
        display: none !important;
      }
      body {
        margin: 0;
        min-width: 0;
        padding: 42px 22px;
        background: #f2f4f7;
        color: var(--ink);
        line-height: 1.55;
      }
      main {
        max-width: 690px;
        margin: auto;
      }
      .brand {
        display: flex;
        align-items: center;
        gap: 10px;
        margin: 0 0 25px;
        color: var(--muted);
        font-size: 12px;
        letter-spacing: 0.04em;
      }
      .brand b {
        color: var(--ink);
        letter-spacing: -0.05em;
        font-size: 17px;
      }
      .brand b span {
        color: var(--blue);
      }
      .brand i {
        flex: 1;
        height: 1px;
        background: var(--line);
      }
      .card {
        background: var(--paper);
        border: 1px solid var(--line);
        border-radius: 18px;
        padding: 32px;
        box-shadow: 0 12px 36px #263a5110;
      }
      .eyebrow {
        margin: 0 0 12px;
        font-size: 11px;
        font-weight: 700;
        text-transform: uppercase;
        letter-spacing: 0.12em;
        color: var(--blue);
      }
      h1 {
        font-size: clamp(29px, 5vw, 38px);
        line-height: 1.13;
        letter-spacing: -0.04em;
        margin: 0 0 14px;
      }
      h2 {
        font-size: 20px;
        line-height: 1.3;
        margin: 0 0 14px;
      }
      p {
        margin: 0 0 18px;
      }
      .intro {
        color: var(--muted);
        max-width: 55ch;
      }
      .hint,
      .small {
        font-size: 13px;
        color: var(--muted);
      }
      .hint {
        margin: 9px 0 0;
      }
      .footer {
        font-size: 12px;
        color: var(--muted);
        margin: 20px 2px 0;
      }
      label,
      legend {
        font-weight: 700;
        font-size: 14px;
      }
      label.field {
        display: block;
        margin: 18px 0 7px;
      }
      fieldset {
        min-width: 0;
        margin: 22px 0;
        padding: 20px;
        border: 1px solid var(--line);
        border-radius: 10px;
      }
      legend {
        padding: 0 7px;
      }
      input,
      select,
      textarea,
      button {
        font: inherit;
      }
      input:not([type='checkbox']):not([type='radio']),
      select,
      textarea {
        width: 100%;
        min-width: 0;
        color: var(--ink);
        background: #fff;
        border: 1px solid #8896a5;
        border-radius: 7px;
        padding: 11px 12px;
        font-size: 16px;
      }
      input[type='checkbox'],
      input[type='radio'] {
        accent-color: var(--blue);
        width: 18px;
        height: 18px;
        flex: none;
      }
      textarea {
        display: block;
        resize: vertical;
      }
      button {
        border: 1px solid var(--blue);
        border-radius: 7px;
        min-height: 44px;
        padding: 10px 17px;
        background: var(--blue);
        color: #fff;
        font-size: 14px;
        font-weight: 700;
        cursor: pointer;
      }
      button.secondary {
        background: #fff;
        color: var(--blue);
      }
      button:disabled {
        cursor: default;
        opacity: 0.55;
      }
      input:disabled,
      select:disabled {
        background: #f0f2f5;
        color: #596675;
      }
      :focus-visible {
        outline: 3px solid #d46a20;
        outline-offset: 3px;
      }
      .actions {
        display: flex;
        flex-wrap: wrap;
        gap: 10px;
        margin-top: 22px;
      }
      .status {
        margin: 18px 0 0;
        font-size: 14px;
        min-height: 1.6em;
      }
      .error {
        color: var(--danger);
      }
      .panel {
        background: var(--pale);
        padding: 20px;
        border-radius: 10px;
        margin-top: 24px;
      }
      .panel p:last-child {
        margin-bottom: 0;
      }
      .row {
        display: flex;
        gap: 12px;
        align-items: center;
      }
      .sr {
        position: absolute;
        width: 1px;
        height: 1px;
        margin: -1px;
        overflow: hidden;
        clip: rect(0, 0, 0, 0);
        white-space: nowrap;
      }
      noscript p {
        border-left: 3px solid #9b6300;
        background: #fff4d6;
        padding: 12px;
        font-size: 14px;
        margin-top: 20px;
      }
      code {
        overflow-wrap: anywhere;
      }
      @media (max-width: 450px) {
        body {
          padding: 25px 14px;
        }
        .card {
          padding: 23px 19px;
          border-radius: 13px;
        }
        fieldset {
          padding: 16px 13px;
        }
        .brand {
          margin-bottom: 18px;
        }
      }
      @media (prefers-reduced-motion: reduce) {
        *,
        *::before,
        *::after {
          animation: none !important;
          transition: none !important;
          scroll-behavior: auto !important;
        }
      }

      .action-surface {
        padding: 25px;
        margin-top: 22px;
        background: #202b36;
        color: #fff;
        border-radius: 10px;
      }
      #state-badge {
        display: inline-block;
        font: 11px monospace;
        letter-spacing: 0.1em;
        border: 1px solid #8192a2;
        padding: 4px 7px;
        border-radius: 4px;
      }
      .action-surface p {
        margin: 15px 0 18px;
        font-size: 21px;
      }
      .action-surface button {
        background: #e4ebff;
        color: #173ba9;
        border-color: #e4ebff;
        display: flex;
        align-items: center;
        gap: 9px;
      }
      .spinner {
        width: 15px;
        height: 15px;
        border: 2px solid currentColor;
        border-right-color: transparent;
        border-radius: 50%;
        animation: spin 1s linear infinite;
      }
      @keyframes spin {
        to {
          transform: rotate(360deg);
        }
      }
    </style>
  </head>
  <body>
    <main>
      <p class="brand">
        <b>MR<span>HTML</span></b
        ><span>THE INTERACTION NOTEBOOK</span><i aria-hidden="true"></i>
      </p>
      <section class="card" aria-labelledby="title">
        <p class="eyebrow">06 / Async action button</p>
        <h1 id="title">Every state has a place.</h1>
        <p class="intro">
          A deterministic local simulation of a background action. Choose the
          next result, then run the 900ms demo.
        </p>
        <label class="field" for="outcome">Next simulated outcome</label
        ><select id="outcome" disabled>
          <option value="success">Success</option>
          <option value="error">Error</option>
        </select>
        <div id="action-surface" class="action-surface" aria-busy="false">
          <span id="state-badge">IDLE</span>
          <p>Local sample check</p>
          <button id="run-action" type="button" disabled>
            <span class="spinner" aria-hidden="true" hidden></span
            ><span id="action-label">Run simulation</span>
          </button>
        </div>
        <p id="action-status" class="status" role="status">
          Ready when JavaScript is available. No network action occurs.
        </p>
        <p id="attempts" class="small">Completed local attempts: 0</p>
        <div class="actions">
          <button id="reset-action" type="button" class="secondary" disabled>
            Reset demo
          </button>
        </div>
        <noscript
          ><p>
            The state preview remains readable. Running this local timer and
            changing the state require JavaScript. No real task is started.
          </p></noscript
        >
      </section>
      <p class="footer">A local MRHTML example. Nothing is sent or saved.</p>
    </main>
    <script>
      (function () {
        'use strict';

        var run = document.getElementById('run-action'),
          reset = document.getElementById('reset-action'),
          outcome = document.getElementById('outcome'),
          surface = document.getElementById('action-surface'),
          badge = document.getElementById('state-badge'),
          label = document.getElementById('action-label'),
          status = document.getElementById('action-status'),
          spinner = document.querySelector('.spinner'),
          attempts = document.getElementById('attempts');
        var loading = false,
          completed = 0;
        run.addEventListener('click', function () {
          if (loading) return;
          loading = true;
          var result = outcome.value;
          run.disabled = true;
          reset.disabled = true;
          outcome.disabled = true;
          surface.setAttribute('aria-busy', 'true');
          badge.textContent = 'LOADING';
          label.textContent = 'Running locally';
          spinner.hidden = false;
          status.textContent = 'Local simulation running. Please wait.';
          window.setTimeout(function () {
            loading = false;
            completed++;
            run.disabled = false;
            reset.disabled = false;
            outcome.disabled = false;
            surface.setAttribute('aria-busy', 'false');
            spinner.hidden = true;
            attempts.textContent = 'Completed local attempts: ' + completed;
            if (result === 'error') {
              badge.textContent = 'ERROR';
              label.textContent = 'Retry simulation';
              status.textContent =
                'Simulated error. No real operation failed. Choose an outcome and retry.';
            } else {
              badge.textContent = 'SUCCESS';
              label.textContent = 'Run again';
              status.textContent =
                'Local simulation complete. Nothing was sent or saved.';
            }
          }, 900);
        });
        reset.addEventListener('click', function () {
          if (loading) return;
          completed = 0;
          outcome.value = 'success';
          badge.textContent = 'IDLE';
          label.textContent = 'Run simulation';
          attempts.textContent = 'Completed local attempts: 0';
          status.textContent = 'Demo reset. No network action occurs.';
          run.focus();
        });
        run.disabled = false;
        reset.disabled = false;
        outcome.disabled = false;
        status.textContent =
          'Ready. This is a local timer, not a network request.';
      })();
    </script>
  </body>
</html>