Primary Intent

The .primary class provides a visual style for links and buttons that indicate a primary action. Use it to highlight actions that are the main focus or most important.

Links

Apply .primary to <a> elements or elements with [role="link"] to indicate a primary action.

<a href="#" class="primary">Regular Link</a>

<hr>

<a href="#" aria-current="page" class="primary">Active link</a>
<hr>
<button class="primary" role="link">
  &lt;button&gt; as link
</button>

<hr>

<button role="link" aria-current="page" class="primary">Active button</button>

<hr>

<div class="primary" role="link">
  &lt;div&gt; as link
</div>

<hr>

<div role="link" aria-current="page" class="primary">Active div</div>

Buttons

Apply .primary to <button> elements or elements with [role="button"] for a primary action button.

<div class="auto-grid">
  <button class="primary">
    Button
  </button>
  
  <div class="primary" role="button">
    &lt;div&gt; as button
  </div>
  
  <details>
    <summary class="primary" role="button" aria-haspopup="menu">
      Dropdown as a button
    </summary>
    <ul role="menu">
      <li><a role="menuitem" href="#">Solid</a></li>
      <li><a role="menuitem" href="#">Liquid</a></li>
      <li><a role="menuitem" href="#">Gas</a></li>
      <li><a role="menuitem" href="#">Plasma</a></li>
    </ul>
  </details>
</div>

Cards

Apply .primary to an element with .card for a primary action card.

See code

<div class="card primary">
  <hgroup>
    <h2>Card title</h2>
    <p>This is the subtitle</p>
  </hgroup>
  <p>This is the main content of the card.</p>
</div>

<hr>

<div class="card primary">
  <header>
    <h2>Card title</h2>
  </header>
  <p>Cards support optional header and footer sections that are visually distinct from the main content.</p>
  <footer>
    <button class="secondary">Cancel</button>
    <button>Confirm</button>
  </footer>
</div>

Modifiers

.primary can be modified with .subtle to create cards with a more muted appearance, often used for less prominent actions.

See code

<div class="auto-grid">
  <button class="subtle primary">
    Button
  </button>
  
    <div class="subtle primary" role="button">
    &lt;div&gt; as button
  </div>
  
  <details>
    <summary class="subtle primary" role="button" aria-haspopup="menu">
      Dropdown as a button
    </summary>
    <ul role="menu">
      <li><a role="menuitem" href="#">Solid</a></li>
      <li><a role="menuitem" href="#">Liquid</a></li>
      <li><a role="menuitem" href="#">Gas</a></li>
      <li><a role="menuitem" href="#">Plasma</a></li>
    </ul>
  </details>
</div>

<br>

<div class="card subtle primary">
  <hgroup>
    <h2>Card title</h2>
    <p>This is the subtitle</p>
  </hgroup>
  <p>This is the main content of the card.</p>
</div>

<div class="card subtle primary">
  <header>
    <h2>Card title</h2>
  </header>
  <p>Cards support optional header and footer sections that are visually distinct from the main content.</p>
  <footer>
    <button class="secondary">Cancel</button>
    <button>Confirm</button>
  </footer>
</div>

.primary can be modified with .ghost to create ghost buttons and cards, which have a transparent background and a border, making them less visually prominent while still maintaining the primary effect.

See code

<div class="auto-grid">
  <button class="ghost primary">
    Button
  </button>
  
    <div class="ghost primary" role="button">
    &lt;div&gt; as button
  </div>
  
  <details>
    <summary class="ghost primary" role="button" aria-haspopup="menu">
      Dropdown as a button
    </summary>
    <ul role="menu">
      <li><a role="menuitem" href="#">Solid</a></li>
      <li><a role="menuitem" href="#">Liquid</a></li>
      <li><a role="menuitem" href="#">Gas</a></li>
      <li><a role="menuitem" href="#">Plasma</a></li>
    </ul>
  </details>
</div>

<br>

<div class="card ghost primary">
  <hgroup>
    <h2>Card title</h2>
    <p>This is the subtitle</p>
  </hgroup>
  <p>This is the main content of the card.</p>
</div>

<div class="card ghost primary">
  <header>
    <h2>Card title</h2>
  </header>
  <p>Cards support optional header and footer sections that are visually distinct from the main content.</p>
  <footer>
    <button class="secondary">Cancel</button>
    <button>Confirm</button>
  </footer>
</div>