View on GitHub

Buttons

Use OUDS Web’s custom button styles for actions in forms, dialogs, and more with support for multiple sizes, states, and more.

Base class

OUDS Web has a base .btn class that sets up basic styles such as padding and content alignment. By default, .btn controls have a transparent border and background color, but still defines basic focus and hover styles.

<button type="button" class="btn">Base class</button>

html

The .btn class is intended to be used in conjunction with our button variants, or to serve as a basis for your own custom styles.

Standard variants

OUDS Web includes several button variants, each serving its own semantic purpose, with a few extras thrown in for more control. Please follow the Button design specifications to choose the right button for the right action.

<button type="button" class="btn btn-default">Default</button>
<button type="button" class="btn btn-strong">Strong</button>
<button type="button" class="btn btn-minimal">Minimal</button>
<button type="button" class="btn btn-negative">Negative</button>

html

Bootstrap $enable-bootstrap-compatibility: true

This part is enabled only when $enable-bootstrap-compatibility is set to true. Read more about Bootstrap compatibility.

<button type="button" class="btn btn-primary">Primary</button>
<button type="button" class="btn btn-secondary">Secondary</button>
<button type="button" class="btn btn-success">Success</button>
<button type="button" class="btn btn-danger">Danger</button>
<button type="button" class="btn btn-warning">Warning</button>
<button type="button" class="btn btn-info">Info</button>
<button type="button" class="btn btn-light">Light</button>
<button type="button" class="btn btn-dark">Dark</button>

<!-- <button type="button" class="btn btn-link">Link</button> -->

html

Variants on colored background

OUDS Web offers a few variations to use on colored backgrounds. Their accessibility (readability) is ensured by suitable semi-opaque backgrounds.

Heads up!

Background utilities used to make colored backgrounds, should always be used with the appropriate color theme (see an example below). Please refer to colored backgrounds documentation
Negative buttons should never be used on colored background.

<div class="bg-brand-primary p-tall">
  <div data-bs-theme="light" class="d-flex gap-shorter flex-wrap">
    <button type="button" class="btn btn-default btn-on-colored-bg">Default</button>
    <button type="button" class="btn btn-strong btn-on-colored-bg">Strong</button>
    <button type="button" class="btn btn-minimal btn-on-colored-bg">Minimal</button>
    <!-- BEWARE: `.btn-negative` should never be used on colored backgrounds! -->
  </div>
</div>
<div class="bg-status-negative-emphasized p-tall">
  <div data-bs-theme="root-inverted" class="d-flex gap-shorter flex-wrap">
    <button type="button" class="btn btn-default btn-on-colored-bg">Default</button>
    <button type="button" class="btn btn-strong btn-on-colored-bg">Strong</button>
    <button type="button" class="btn btn-minimal btn-on-colored-bg">Minimal</button>
    <!-- BEWARE: `.btn-negative` should never be used on colored backgrounds! -->
  </div>
</div>

html

With icon

Text and icon

The recommended way of using an icon in a button is an embedded SVG. You need to:

set its dimensions to default 1rem size, the icon will adapt automatically,
fill it using currentColor to respect button color scheme.

You don’t need to apply any spacing utility on the icon to get consistent spacing, as the margin is already handled by OUDS Web.

Please note that if you experience a problem with a cropped SVG, we recommend using the .overflow-visible utility on the SVG to fix its rendering.

If really needed, you can use a font icon associated to the .icon class to set correct parameters for the font-size and line-height.

We strongly advise not using an <img>, in particular because the icon will not benefit from dynamic color changes on states (hover, focus, active) and the color mode system won’t work.

<div class="p-tall d-flex gap-shorter flex-wrap">
  <button type="button" class="btn btn-default">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
    </svg>
    Default
  </button>
  <button type="button" class="btn btn-strong">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
    </svg>
    Strong
  </button>
  <button type="button" class="btn btn-minimal">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
    </svg>
    Minimal
  </button>
  <button type="button" class="btn btn-negative">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
    </svg>
    Negative
  </button>

  <button type="button" class="btn btn-default">
    <span class="icon si si-settings" aria-hidden="true"></span>
    Default
  </button>
</div>

<div class="bg-brand-primary p-tall">
  <div data-bs-theme="light" class="d-flex gap-shorter flex-wrap">
    <button type="button" class="btn btn-default btn-on-colored-bg">
      <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
        <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
      </svg>
      Default
    </button>
    <button type="button" class="btn btn-strong btn-on-colored-bg">
      <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
        <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
      </svg>
      Strong
    </button>
    <button type="button" class="btn btn-minimal btn-on-colored-bg">
      <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
        <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
      </svg>
      Minimal
    </button>

    <button type="button" class="btn btn-default btn-on-colored-bg">
      <span class="icon si si-settings" aria-hidden="true"></span>
      Default
    </button>
  </div>
</div>

html

Icon only

Add .btn-icon to get a squared button, meant to only contain an icon. Make sure to provide an accessible name to your button, either using a .visually-hidden content or an aria-label attribute.

<div class="p-tall d-flex gap-shorter flex-wrap">
  <button type="button" class="btn btn-icon btn-default">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
    </svg>
    <span class="visually-hidden">Default</span>
  </button>
  <button type="button" class="btn btn-icon btn-strong">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
    </svg>
    <span class="visually-hidden">Strong</span>
  </button>
  <button type="button" class="btn btn-icon btn-minimal">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
    </svg>
    <span class="visually-hidden">Minimal</span>
  </button>
  <button type="button" class="btn btn-icon btn-negative">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
    </svg>
    <span class="visually-hidden">Negative</span>
  </button>

  <button type="button" class="btn btn-icon btn-default">
    <span class="icon si si-settings" aria-hidden="true"></span>
    <span class="visually-hidden">Default</span>
  </button>
</div>

<div class="bg-brand-primary p-tall">
  <div data-bs-theme="light" class="d-flex gap-shorter flex-wrap">
    <button type="button" class="btn btn-icon btn-default btn-on-colored-bg">
      <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
        <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
      </svg>
      <span class="visually-hidden">Default</span>
    </button>
    <button type="button" class="btn btn-icon btn-strong btn-on-colored-bg">
      <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
        <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
      </svg>
      <span class="visually-hidden">Strong</span>
    </button>
    <button type="button" class="btn btn-icon btn-minimal btn-on-colored-bg">
      <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
        <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#heart-recommend"/>
      </svg>
      <span class="visually-hidden">Minimal</span>
    </button>

    <button type="button" class="btn btn-icon btn-default btn-on-colored-bg">
      <span class="icon si si-settings" aria-hidden="true"></span>
      <span class="visually-hidden">Default</span>
    </button>
  </div>
</div>

html

Disable text wrapping

If you don’t want the button text to wrap, you can add the .text-nowrap class to the button. In Sass, you can set $btn-white-space: nowrap to disable text wrapping for each button.

Button tags

The .btn classes are designed to be used with the <button> element. However, you can also use these classes on <a> or <input> elements (though some browsers may apply a slightly different rendering).

When using button classes on <a> elements that are used to trigger in-page functionality (like collapsing content), rather than linking to new pages or sections within the current page, these links should be given a role="button" to appropriately convey their purpose to assistive technologies such as screen readers.

Link

<a class="btn btn-default" href="#" role="button">Link</a>
<button class="btn btn-strong" type="submit">Button</button>
<input class="btn btn-minimal" type="button" value="Input">
<input class="btn btn-negative" type="submit" value="Submit">
<input class="btn btn-default" type="reset" value="Reset">

html

Outline buttons

Bootstrap $enable-bootstrap-compatibility: true

This part is enabled only when $enable-bootstrap-compatibility is set to true. Read more about Bootstrap compatibility.

In need of a button, but not the hefty background colors they bring? Replace the default modifier classes with the .btn-outline-* ones to remove all background images and colors on any button.

<button type="button" class="btn btn-outline-primary">Primary</button>
<button type="button" class="btn btn-outline-secondary">Secondary</button>
<button type="button" class="btn btn-outline-success">Success</button>
<button type="button" class="btn btn-outline-danger">Danger</button>
<button type="button" class="btn btn-outline-warning">Warning</button>
<button type="button" class="btn btn-outline-info">Info</button>
<button type="button" class="btn btn-outline-light">Light</button>
<button type="button" class="btn btn-outline-dark">Dark</button>

html

Disabled state

Make buttons look inactive by adding the disabled boolean attribute to any <button> element. Disabled buttons have pointer-events: none applied to, preventing hover and active states from triggering.

<div class="p-tall d-flex gap-shorter flex-wrap">
  <button type="button" class="btn btn-default" disabled>Default</button>
  <button type="button" class="btn btn-strong" disabled>Strong</button>
  <button type="button" class="btn btn-minimal" disabled>Minimal</button>
  <button type="button" class="btn btn-negative" disabled>Negative</button>
</div>

<div class="bg-brand-primary p-tall">
  <div data-bs-theme="light" class="d-flex gap-shorter flex-wrap">
    <button type="button" class="btn btn-default btn-on-colored-bg" disabled>Default</button>
    <button type="button" class="btn btn-strong btn-on-colored-bg" disabled>Strong</button>
    <button type="button" class="btn btn-minimal btn-on-colored-bg" disabled>Minimal</button>
  </div>
</div>

html

Disabled buttons using the <a> element behave a bit different:

Disabled buttons using <a> must include the aria-disabled="true" attribute to indicate the state of the element to assistive technologies and to make it visually appear disabled.
Disabled buttons using <a> should not include the href attribute. In case you need to keep the href, please refer to disabled link accessibility warning.
Some future-friendly styles are included to disable all pointer-events on anchor buttons.

Default link Strong link

<div class="p-tall d-flex gap-shorter flex-wrap">
  <a class="btn btn-default" role="button" aria-disabled="true">Default link</a>
  <a class="btn btn-strong" role="button" aria-disabled="true">Strong link</a>
</div>
<div class="bg-brand-primary p-tall">
  <div data-bs-theme="light" class="d-flex gap-shorter flex-wrap">
    <a class="btn btn-default btn-on-colored-bg" role="button" aria-disabled="true">Default link</a>
    <a class="btn btn-strong btn-on-colored-bg" role="button" aria-disabled="true">Strong link</a>
  </div>
</div>

html

Loading state

The loading state of a button indicates that an action is currently processing or taking place. This state provides feedback to users, enhancing user experience.

To make an animated loading state button, you will add in your standard button:

An animated <svg>: the animation will differ whether the loading time is known or not.
A status message <span>: the message must be updated regularly in order to be vocalized by screen readers; if the loading time is defined, you should indicate the progression.

For example, before loading, your button could be like this:

<button type="button" class="btn btn-default" id="loading-btn-0">
  Download file
  <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
    <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
  </svg>
  <span role="status" id="loading-btn-msg-0" class="visually-hidden d-none"></span>
</button>

html

When the loading starts, you will have to:

Add the class .loading-indeterminate (for an unknown loading time) or .loading-determinate (for a known loading time) to the button to provide the appropriate styles and animation.
For a known loading time, provide a CSS variable --bs-btn-loading-time to set the loading time. For example, add style="--bs-btn-loading-time: 5s;" to the button, for a 5 seconds loading.
Set the disabled state on the button to avoid any unwanted interactions (in case you use a <a> tag, this can be done by setting aria-disabled="true" and removing the href attribute).
Remove the .d-none from the status message <span>.
Update regularly the status message <span> containing the loading message.

At the end of the loading, you should:

Remove the disabled state on the button to restore its interactivity.
Remove the class .loading-indeterminate or .loading-determinate to restore the button’s look.
Set a final status message in <span>, indicating the loading has ended (so we don’t add again .d-none on this status message).
Put the focus back on the button to ensure similar behavior across browsers and not lose the user after changes.

You can see it live and find a JavaScript example on our loading buttons live example.

<div class="p-tall d-flex gap-shorter flex-wrap">
  <button type="button" class="btn btn-default loading-indeterminate" id="loading-btn-1" disabled>
    Download file 1
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-1" class="visually-hidden">Downloading file 1</span>
  </button>
  <button type="button" class="btn btn-strong loading-indeterminate" id="loading-btn-2" disabled>
    Download file 2
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-2" class="visually-hidden">Downloading file 2</span>
  </button>
  <button type="button" class="btn btn-minimal loading-indeterminate" id="loading-btn-3" disabled>
    Download file 3
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-3" class="visually-hidden">Downloading file 3</span>
  </button>
  <button type="button" class="btn btn-negative loading-indeterminate" id="loading-btn-4" disabled>
    Download file 4
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-4" class="visually-hidden">Downloading file 4</span>
  </button>
</div>

<div class="p-tall d-flex gap-shorter flex-wrap">
  <button type="button" class="btn btn-default loading-determinate" id="loading-btn-5" disabled style="--bs-btn-loading-time: 5s;">
    Download file 5
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-5" class="visually-hidden">Downloading file 5: xx%</span>
  </button>
  <button type="button" class="btn btn-strong loading-determinate" id="loading-btn-6" disabled style="--bs-btn-loading-time: 5s;">
    Download file 6
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-6" class="visually-hidden">Downloading file 6: xx%</span>
  </button>
  <button type="button" class="btn btn-minimal loading-determinate" id="loading-btn-7" disabled style="--bs-btn-loading-time: 5s;">
    Download file 7
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-7" class="visually-hidden">Downloading file 7: xx%</span>
  </button>
  <button type="button" class="btn btn-negative loading-determinate" id="loading-btn-8" disabled style="--bs-btn-loading-time: 5s;">
    Download file 8
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-8" class="visually-hidden">Downloading file 8: xx%</span>
  </button>
</div>

<div class="bg-brand-primary p-tall">
  <div data-bs-theme="light" class="d-flex gap-shorter flex-wrap">
    <button type="button" class="btn btn-default btn-on-colored-bg loading-indeterminate" id="loading-btn-9" disabled>
      Download file 9
      <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
        <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
      </svg>
      <span role="status" id="loading-btn-msg-9" class="visually-hidden">Downloading file 9</span>
    </button>
    <button type="button" class="btn btn-strong btn-on-colored-bg loading-indeterminate" id="loading-btn-10" disabled>
      Download file 10
      <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
        <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
      </svg>
      <span role="status" id="loading-btn-msg-10" class="visually-hidden">Downloading file 10</span>
    </button>
    <button type="button" class="btn btn-minimal btn-on-colored-bg loading-indeterminate" id="loading-btn-11" disabled>
      Download file 11
      <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
        <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
      </svg>
      <span role="status" id="loading-btn-msg-11" class="visually-hidden">Downloading file 11</span>
    </button>
  </div>
</div>

<div class="bg-brand-primary p-tall">
  <div data-bs-theme="light" class="d-flex gap-shorter flex-wrap">
    <button type="button" class="btn btn-default btn-on-colored-bg loading-determinate" id="loading-btn-12" disabled style="--bs-btn-loading-time: 5s;">
      Download file 12
      <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
        <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
      </svg>
      <span role="status" id="loading-btn-msg-12" class="visually-hidden">Downloading file 12: xx%</span>
    </button>
    <button type="button" class="btn btn-strong btn-on-colored-bg loading-determinate" id="loading-btn-13" disabled style="--bs-btn-loading-time: 5s;">
      Download file 13
      <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
        <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
      </svg>
      <span role="status" id="loading-btn-msg-13" class="visually-hidden">Downloading file 13: xx%</span>
    </button>
    <button type="button" class="btn btn-minimal btn-on-colored-bg loading-determinate" id="loading-btn-14" disabled style="--bs-btn-loading-time: 5s;">
      Download file 14
      <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
        <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
      </svg>
      <span role="status" id="loading-btn-msg-14" class="visually-hidden">Downloading file 14: xx%</span>
    </button>
  </div>
</div>

html

Loading state can also be combined with all kind of buttons, including icons.

<div class="p-tall d-flex gap-shorter flex-wrap">
  <button type="button" class="btn btn-icon btn-default loading-indeterminate" id="loading-btn-15" disabled>
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#download"/>
    </svg>
    <span class="visually-hidden">Downloading file 15</span>
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-15" class="visually-hidden">Downloading file 15</span>
  </button>
  <button type="button" class="btn btn-icon btn-default loading-determinate" id="loading-btn-16" disabled style="--bs-btn-loading-time: 5s;">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#download"/>
    </svg>
    <span class="visually-hidden">Downloading file 16</span>
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-16" class="visually-hidden">Downloading file 16: xx%</span>
  </button>
  <button type="button" class="btn btn-strong loading-indeterminate" id="loading-btn-17" disabled>
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#download"/>
    </svg>
    Download file 17
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-17" class="visually-hidden">Downloading file 17</span>
  </button>
  <button type="button" class="btn btn-strong loading-determinate" id="loading-btn-18" disabled style="--bs-btn-loading-time: 5s;">
    <svg width="1rem" height="1rem" fill="currentColor" aria-hidden="true">
      <use xlink:href="/docs/0.3/assets/img/ouds-web-sprite.svg#download"/>
    </svg>
    Download file 18
    <svg viewbox='0 0 40 40' xmlns='http://www.w3.org/2000/svg' class="loader" aria-hidden="true">
      <circle class="loader-inner" cx="20" cy="20" r="17"></circle>
    </svg>
    <span role="status" id="loading-btn-msg-18" class="visually-hidden">Downloading file 18</span>
  </button>
</div>

html

Block buttons

Create responsive stacks of full-width, “block buttons” with a mix of our display and gap utilities. By using utilities instead of button-specific classes, we have much greater control over spacing, alignment, and responsive behaviors.

Please note that these full-width buttons should not be used on desktop screens.

<div class="d-grid gap-short">
  <button class="btn btn-default" type="button">Button</button>
  <button class="btn btn-default" type="button">Button</button>
</div>

html

Here we create a responsive variation, starting with vertically stacked buttons until the md breakpoint, where .d-md-block replaces the .d-grid class, thus nullifying the gap-short utility. Resize your browser to see them change.

<div class="d-grid gap-short d-md-block">
  <button class="btn btn-default" type="button">Button</button>
  <button class="btn btn-default" type="button">Button</button>
</div>

html

You can adjust the width of your block buttons with grid column width classes. For example, for a half-width “block button”, use .col-6. Center it horizontally with .mx-auto, too.

<div class="d-grid gap-short col-6 mx-auto">
  <button class="btn btn-default" type="button">Button</button>
  <button class="btn btn-default" type="button">Button</button>
</div>

html

Additional utilities can be used to adjust the alignment of buttons when horizontal. Here we’ve taken our previous responsive example and added some flex utilities and a margin utility on the button to right-align the buttons when they’re no longer stacked.

<div class="d-grid gap-short d-md-flex justify-content-md-end">
  <button class="btn btn-default me-md-shorter" type="button">Button</button>
  <button class="btn btn-default" type="button">Button</button>
</div>

html

CSS

Variables

As part of OUDS Web’s evolving CSS variables approach, buttons use local CSS variables on .btn for enhanced real-time customization. Values for the CSS variables are set via Sass, so Sass customization is still supported, too.

scss/_buttons.scss

// OUDS mod: no --#{$prefix}btn-padding-x
--#{$prefix}btn-padding-y: #{$btn-padding-y};
// OUDS mod: no --#{$prefix}btn-font-family
// OUDS mod: no `@include rfs($btn-font-size, --#{$prefix}btn-font-size)`
--#{$prefix}btn-font-weight: #{$btn-font-weight};
// OUDS mod: no `--#{$prefix}btn-line-height`
--#{$prefix}btn-color: #{$btn-color};
--#{$prefix}btn-bg: transparent;
--#{$prefix}btn-border-width: #{$btn-border-width};
--#{$prefix}btn-border-color: transparent;
--#{$prefix}btn-border-radius: #{$btn-border-radius};
--#{$prefix}btn-hover-border-color: initial; // OUDS mod: instead of `transparent`
// OUDS mod: no --#{$prefix}btn-box-shadow
// OUDS mod: no --#{$prefix}btn-disabled-opacity
// OUDS mod: no --#{$prefix}btn-focus-box-shadow

// Additional OUDS variables
--#{$prefix}btn-padding-start: #{$btn-padding-x};
--#{$prefix}btn-padding-end: #{$btn-padding-x};
--#{$prefix}btn-min-width: #{$ouds-button-size-min-width};
--#{$prefix}btn-min-height: #{$ouds-button-size-min-height};
--#{$prefix}btn-interaction-border-width: #{$btn-border-width};
--#{$prefix}btn-icon-size: #{$ouds-button-size-icon};
--#{$prefix}btn-icon-gap: #{$ouds-button-space-column-gap-icon};
--#{$prefix}btn-focus-border-color: var(--#{$prefix}btn-hover-border-color);
--#{$prefix}btn-loading-size: #{$ouds-button-size-loader};
--#{$prefix}btn-loading-dasharray: 96;
--#{$prefix}btn-loading-animation: 2.1875s infinite linear rotate1-indeterminate, 1.25s linear infinite rotate2-indeterminate;
// End mod

Each .btn-* modifier class updates the appropriate CSS variables to minimize additional CSS rules with our button-variant() mixin.

Sass variables

scss/_variables.scss

$btn-color:                   $ouds-button-color-content-default-enabled; // OUDS mod: instead of `var(--#{$prefix}body-color)`
$btn-padding-y:               $ouds-button-space-padding-block; // OUDS mod: instead of $input-btn-padding-y
$btn-padding-x:               $ouds-button-space-padding-inline-icon-none; // OUDS mod: instead of $input-btn-padding-x
// OUDS mod: no $btn-font-family
// OUDS mod: no `$btn-font-size` which is defined within the font size tokens
// OUDS mod: no `$btn-line-height` which is defined within the font size tokens
$btn-white-space:             null; // Set to `nowrap` to prevent text wrapping

// OUDS mod: no $btn-padding-y-sm
// OUDS mod: no $btn-padding-x-sm
// OUDS mod: no $btn-font-size-sm

// OUDS mod: no $btn-padding-y-lg
// OUDS mod: no $btn-padding-x-lg
// OUDS mod: no $btn-font-size-lg

$btn-border-width:            $ouds-button-border-width-default; // OUDS mod: instead of $input-btn-border-width

$btn-font-weight:             $font-weight-bold;
// OUDS mod: no $btn-box-shadow
$btn-focus-width:             $input-btn-focus-width;
$btn-focus-box-shadow:        0 0 0 $btn-focus-width $white;
// OUDS mod: no $btn-disabled-opacity
$btn-active-box-shadow:       null;

// OUDS mod: no $btn-link-color
// OUDS mod: no $btn-link-hover-color
// OUDS mod: no $btn-link-disabled-color
// OUDS mod: no `$btn-link-focus-shadow-rgb`

// Allows for customizing button radius independently from global border radius
$btn-border-radius:           $ouds-button-border-radius; // OUDS mod: instead of var(--#{$prefix}border-radius)
// OUDS mod: no $btn-border-radius-sm:        var(--#{$prefix}border-radius-sm);
// OUDS mod: no $btn-border-radius-lg:        var(--#{$prefix}border-radius-lg);

$btn-transition:              $transition-focus; // OUDS mod

Sass mixins

There are one mixin for button colors: button variant mixin.

scss/mixins/_buttons.scss

@mixin button-variant(
  $background,
  $border,
  $color, // OUDS mod: no default value
  $hover-background: $ouds-button-color-bg-default-hover, // OUDS mod: instead of calculated default value
  $hover-border: $ouds-button-color-border-default-hover, // OUDS mod: instead of calculated default value
  $hover-color: $ouds-button-color-content-default-hover, // OUDS mod: instead of calculated default value
  $active-background: $ouds-button-color-bg-default-pressed, // OUDS mod: instead of calculated default value
  $active-border: $ouds-button-color-border-default-pressed, // OUDS mod: instead of calculated default value
  $active-color: $ouds-button-color-content-default-pressed, // OUDS mod: instead of calculated default value
  $disabled-background: $ouds-button-color-bg-default-disabled, // OUDS mod: instead of `$background`
  $disabled-border: $ouds-button-color-border-default-disabled, // OUDS mod: instead of `$border`
  $disabled-color: $ouds-button-color-content-default-disabled, // OUDS mod: instead of `color-contrat($disabled-background)`
  $focus-background: $ouds-button-color-bg-default-focus, // OUDS mod
  $focus-border: $ouds-button-color-border-default-focus, // OUDS mod
  $focus-color: $ouds-button-color-content-default-focus, // OUDS mod
  $loading-background: $ouds-button-color-bg-default-loading, // OUDS mod
  $loading-border: $ouds-button-color-border-default-loading, // OUDS mod
  $loading-color: $ouds-button-color-content-default-loading, // OUDS mod
) {
  --#{$prefix}btn-color: #{$color};
  --#{$prefix}btn-bg: #{$background};
  --#{$prefix}btn-border-color: #{$border};
  --#{$prefix}btn-hover-color: #{$hover-color};
  --#{$prefix}btn-hover-bg: #{$hover-background};
  --#{$prefix}btn-hover-border-color: #{$hover-border};
  // OUDS mod: no --#{$prefix}btn-focus-shadow-rgb
  --#{$prefix}btn-active-color: #{$active-color};
  --#{$prefix}btn-active-bg: #{$active-background};
  --#{$prefix}btn-active-border-color: #{$active-border};
  // OUDS mod: no --#{$prefix}btn-active-shadow
  --#{$prefix}btn-disabled-color: #{$disabled-color};
  --#{$prefix}btn-disabled-bg: #{$disabled-background};
  --#{$prefix}btn-disabled-border-color: #{$disabled-border};
  --#{$prefix}btn-focus-color: #{$focus-color}; // OUDS mod
  --#{$prefix}btn-focus-bg: #{$focus-background}; // OUDS mod
  --#{$prefix}btn-focus-border-color: #{$focus-border}; // OUDS mod
  --#{$prefix}btn-loading-color: #{$loading-color}; // OUDS mod
  --#{$prefix}btn-loading-bg: #{$loading-background}; // OUDS mod
  --#{$prefix}btn-loading-border-color: #{$loading-border}; // OUDS mod
}

Bootstrap $enable-bootstrap-compatibility: true

This part is enabled only when $enable-bootstrap-compatibility is set to true. Read more about Bootstrap compatibility.

scss/mixins/_buttons.scss

@mixin button-outline-variant(
  $color,
  $color-hover: color-contrast($color),
  $active-background: $color,
  $active-border: $color,
  $active-color: color-contrast($active-background)
) {
  --#{$prefix}btn-color: #{$color};
  --#{$prefix}btn-border-color: #{$color};
  --#{$prefix}btn-hover-color: #{$color-hover};
  --#{$prefix}btn-hover-bg: #{$active-background};
  --#{$prefix}btn-hover-border-color: #{$active-border};
  // OUDS mod: no --#{$prefix}btn-focus-shadow-rgb
  --#{$prefix}btn-active-color: #{$active-color};
  --#{$prefix}btn-active-bg: #{$active-background};
  --#{$prefix}btn-active-border-color: #{$active-border};
  // OUDS mod: no --#{$prefix}btn-active-shadow
  --#{$prefix}btn-disabled-color: #{$color};
  --#{$prefix}btn-disabled-bg: transparent;
  --#{$prefix}btn-disabled-border-color: #{$color};
  --#{$prefix}gradient: none;
}

scss/mixins/_buttons.scss

@mixin button-size($padding-y, $padding-x, $font-size, $border-radius) {
  --#{$prefix}btn-padding-y: #{$padding-y};
  --#{$prefix}btn-padding-x: #{$padding-x};
  @include rfs($font-size, --#{$prefix}btn-font-size);
  --#{$prefix}btn-border-radius: #{$border-radius};
}

Button variants use their respective mixin to generate the modifier classes in scss/_buttons.scss. Here are the way we define the OUDS Buttons.

scss/_buttons.scss

.btn-default {
  --#{$prefix}btn-border-width: #{$ouds-button-border-width-default};
  --#{$prefix}btn-interaction-border-width: #{$ouds-button-border-width-default-interaction};

  @include button-variant(
    $ouds-button-color-bg-default-enabled,
    $ouds-button-color-border-default-enabled,
    $ouds-button-color-content-default-enabled,
    $ouds-button-color-bg-default-hover,
    $ouds-button-color-border-default-hover,
    $ouds-button-color-content-default-hover,
    $ouds-button-color-bg-default-pressed,
    $ouds-button-color-border-default-pressed,
    $ouds-button-color-content-default-pressed,
    $ouds-button-color-bg-default-disabled,
    $ouds-button-color-border-default-disabled,
    $ouds-button-color-content-default-disabled,
    $ouds-button-color-bg-default-focus,
    $ouds-button-color-border-default-focus,
    $ouds-button-color-content-default-focus,
    $ouds-button-color-bg-default-loading,
    $ouds-button-color-border-default-loading,
    $ouds-button-color-content-default-loading
  );
}

.btn-minimal {
  --#{$prefix}btn-border-width: #{$ouds-button-border-width-minimal};
  --#{$prefix}btn-interaction-border-width: #{$ouds-button-border-width-minimal-interaction};

  @include button-variant(
    $ouds-button-color-bg-minimal-enabled,
    $ouds-button-color-border-minimal-enabled,
    $ouds-button-color-content-minimal-enabled,
    $ouds-button-color-bg-minimal-hover,
    $ouds-button-color-border-minimal-hover,
    $ouds-button-color-content-minimal-hover,
    $ouds-button-color-bg-minimal-pressed,
    $ouds-button-color-border-minimal-pressed,
    $ouds-button-color-content-minimal-pressed,
    $ouds-button-color-bg-minimal-disabled,
    $ouds-button-color-border-minimal-disabled,
    $ouds-button-color-content-minimal-disabled,
    $ouds-button-color-bg-minimal-focus,
    $ouds-button-color-border-minimal-focus,
    $ouds-button-color-content-minimal-focus,
    $ouds-button-color-bg-minimal-loading,
    $ouds-button-color-border-minimal-loading,
    $ouds-button-color-content-minimal-loading
  );
}

.btn-strong {
  --#{$prefix}btn-border-width: #{$ouds-border-width-none};
  --#{$prefix}btn-interaction-border-width: #{$ouds-border-width-none};

  @include button-variant(
    var(--#{$prefix}color-action-enabled),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-action-enabled),
    var(--#{$prefix}color-action-hover),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-action-hover),
    var(--#{$prefix}color-action-pressed),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-action-pressed),
    var(--#{$prefix}color-action-disabled),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-action-disabled),
    var(--#{$prefix}color-action-focus),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-action-focus),
    var(--#{$prefix}color-action-loading),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-action-loading)
  );
}

.btn-negative {
  --#{$prefix}btn-border-width: #{$ouds-border-width-none};
  --#{$prefix}btn-interaction-border-width: #{$ouds-border-width-none};

  @include button-variant(
    var(--#{$prefix}color-action-negative-enabled),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-status-emphasized-alt),
    var(--#{$prefix}color-action-negative-hover),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-status-emphasized-alt),
    var(--#{$prefix}color-action-negative-pressed),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-status-emphasized-alt),
    var(--#{$prefix}color-action-disabled),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-action-disabled),
    var(--#{$prefix}color-action-negative-focus),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-status-emphasized-alt),
    var(--#{$prefix}color-action-negative-loading),
    var(--#{$prefix}color-opacity-transparent),
    var(--#{$prefix}color-content-on-status-emphasized-alt)
  );
}

.btn-default.btn-on-colored-bg {
  --#{$prefix}btn-border-width: #{$ouds-button-border-width-default};
  --#{$prefix}btn-interaction-border-width: #{$ouds-button-border-width-default-interaction-mono};

  @include button-variant(
    $ouds-button-color-bg-default-enabled-mono,
    $ouds-button-color-border-default-enabled-mono,
    $ouds-button-color-content-default-enabled-mono,
    $ouds-button-color-bg-default-hover-mono,
    $ouds-button-color-border-default-hover-mono,
    $ouds-button-color-content-default-hover-mono,
    $ouds-button-color-bg-default-pressed-mono,
    $ouds-button-color-border-default-pressed-mono,
    $ouds-button-color-content-default-pressed-mono,
    $ouds-button-color-bg-default-disabled-mono,
    $ouds-button-color-border-default-disabled-mono,
    $ouds-button-color-content-default-disabled-mono,
    $ouds-button-color-bg-default-focus-mono,
    $ouds-button-color-border-default-focus-mono,
    $ouds-button-color-content-default-focus-mono,
    $ouds-button-color-bg-default-loading-mono,
    $ouds-button-color-border-default-loading-mono,
    $ouds-button-color-content-default-loading-mono
  );
}

.btn-strong.btn-on-colored-bg {
  --#{$prefix}btn-border-width: #{$ouds-border-width-none};
  --#{$prefix}btn-interaction-border-width: #{$ouds-border-width-none};

  @include button-variant(
    $ouds-button-color-bg-strong-enabled-mono,
    $ouds-button-color-border-strong-enabled-mono,
    $ouds-button-color-content-strong-enabled-mono,
    $ouds-button-color-bg-strong-hover-mono,
    $ouds-button-color-border-strong-hover-mono,
    $ouds-button-color-content-strong-hover-mono,
    $ouds-button-color-bg-strong-pressed-mono,
    $ouds-button-color-border-strong-pressed-mono,
    $ouds-button-color-content-strong-pressed-mono,
    $ouds-button-color-bg-strong-disabled-mono,
    $ouds-button-color-border-strong-disabled-mono,
    $ouds-button-color-content-strong-disabled-mono,
    $ouds-button-color-bg-strong-focus-mono,
    $ouds-button-color-border-strong-focus-mono,
    $ouds-button-color-content-strong-focus-mono,
    $ouds-button-color-bg-strong-loading-mono,
    $ouds-button-color-border-strong-loading-mono,
    $ouds-button-color-content-strong-loading-mono
  );
}

.btn-minimal.btn-on-colored-bg {
  --#{$prefix}btn-border-width: #{$ouds-button-border-width-minimal};
  --#{$prefix}btn-interaction-border-width: #{$ouds-button-border-width-minimal-interaction};

  @include button-variant(
    $ouds-button-color-bg-minimal-enabled-mono,
    $ouds-button-color-border-minimal-enabled-mono,
    $ouds-button-color-content-minimal-enabled-mono,
    $ouds-button-color-bg-minimal-hover-mono,
    $ouds-button-color-border-minimal-hover-mono,
    $ouds-button-color-content-minimal-hover-mono,
    $ouds-button-color-bg-minimal-pressed-mono,
    $ouds-button-color-border-minimal-pressed-mono,
    $ouds-button-color-content-minimal-pressed-mono,
    $ouds-button-color-bg-minimal-disabled-mono,
    $ouds-button-color-border-minimal-disabled-mono,
    $ouds-button-color-content-minimal-disabled-mono,
    $ouds-button-color-bg-minimal-focus-mono,
    $ouds-button-color-border-minimal-focus-mono,
    $ouds-button-color-content-minimal-focus-mono,
    $ouds-button-color-bg-minimal-loading-mono,
    $ouds-button-color-border-minimal-loading-mono,
    $ouds-button-color-content-minimal-loading-mono
  );
}

@if $enable-bootstrap-compatibility {
  .btn-primary {
    @extend .btn-strong;
  }

  .btn-success {
    @extend .btn-default;
  }

  .btn-danger {
    @extend .btn-negative;
  }

  .btn-warning {
    @extend .btn-negative;
  }

  .btn-info {
    @extend .btn-minimal;
  }

  .btn-light {
    @extend .btn-minimal;
  }

  .btn-dark {
    @extend .btn-strong;
  }

  .btn-secondary {
    @extend .btn-default;
  }

  @each $color, $value in $theme-colors {
    .btn-outline-#{$color} {
      @extend .btn-default; // OUDS mod
    }
  }
}

Component tokens

scss/tokens/_component.scss

$ouds-button-border-radius: $ouds-border-radius-none;
$ouds-button-border-width-default-interaction-mono: $ouds-border-width-none;
$ouds-button-border-width-default-interaction: $ouds-border-width-medium;
$ouds-button-border-width-default: $ouds-border-width-default;
$ouds-button-border-width-minimal-interaction: $ouds-border-width-none;
$ouds-button-border-width-minimal: $ouds-border-width-none;
$ouds-button-color-bg-default-disabled-mono: $ouds-color-opacity-transparent;
$ouds-button-color-bg-default-disabled: $ouds-color-opacity-transparent;
$ouds-button-color-bg-default-enabled-mono: $ouds-color-opacity-transparent;
$ouds-button-color-bg-default-enabled: $ouds-color-opacity-transparent;
$ouds-button-color-bg-default-focus-mono: $ouds-color-opacity-black-680;
$ouds-button-color-bg-default-focus: $ouds-color-opacity-transparent;
$ouds-button-color-bg-default-hover-mono: $ouds-color-opacity-black-680;
$ouds-button-color-bg-default-hover: $ouds-color-opacity-transparent;
$ouds-button-color-bg-default-loading-mono: $ouds-color-opacity-white-800;
$ouds-button-color-bg-default-loading: $ouds-color-opacity-transparent;
$ouds-button-color-bg-default-pressed-mono: $ouds-color-opacity-white-800;
$ouds-button-color-bg-default-pressed: $ouds-color-opacity-transparent;
$ouds-button-color-bg-minimal-disabled-mono: $ouds-color-opacity-transparent;
$ouds-button-color-bg-minimal-disabled: $ouds-color-opacity-transparent;
$ouds-button-color-bg-minimal-enabled-mono: $ouds-color-opacity-transparent;
$ouds-button-color-bg-minimal-enabled: $ouds-color-opacity-transparent;
$ouds-button-color-bg-minimal-focus-mono: $ouds-color-opacity-black-680;
$ouds-button-color-bg-minimal-focus: $ouds-color-action-support-focus;
$ouds-button-color-bg-minimal-hover-mono: $ouds-color-opacity-black-680;
$ouds-button-color-bg-minimal-hover: $ouds-color-action-support-hover;
$ouds-button-color-bg-minimal-loading-mono: $ouds-color-opacity-white-800;
$ouds-button-color-bg-minimal-loading: $ouds-color-action-support-loading;
$ouds-button-color-bg-minimal-pressed-mono: $ouds-color-opacity-white-800;
$ouds-button-color-bg-minimal-pressed: $ouds-color-action-support-pressed;
$ouds-button-color-bg-strong-disabled-mono: $ouds-color-opacity-black-280;
$ouds-button-color-bg-strong-enabled-mono: $ouds-color-functional-black;
$ouds-button-color-bg-strong-focus-mono: $ouds-color-opacity-black-680;
$ouds-button-color-bg-strong-hover-mono: $ouds-color-opacity-black-680;
$ouds-button-color-bg-strong-loading-mono: $ouds-color-opacity-white-800;
$ouds-button-color-bg-strong-pressed-mono: $ouds-color-opacity-white-800;
$ouds-button-color-border-default-disabled-mono: $ouds-color-opacity-black-280;
$ouds-button-color-border-default-disabled: $ouds-color-action-disabled;
$ouds-button-color-border-default-enabled-mono: $ouds-color-functional-black;
$ouds-button-color-border-default-enabled: $ouds-color-action-enabled;
$ouds-button-color-border-default-focus-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-default-focus: $ouds-color-action-focus;
$ouds-button-color-border-default-hover-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-default-hover: $ouds-color-action-hover;
$ouds-button-color-border-default-loading-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-default-loading: $ouds-color-action-loading;
$ouds-button-color-border-default-pressed-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-default-pressed: $ouds-color-action-pressed;
$ouds-button-color-border-minimal-disabled-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-disabled: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-enabled-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-enabled: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-focus-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-focus: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-hover-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-hover: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-loading-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-loading: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-pressed-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-minimal-pressed: $ouds-color-opacity-transparent;
$ouds-button-color-border-strong-disabled-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-strong-enabled-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-strong-focus-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-strong-hover-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-strong-loading-mono: $ouds-color-opacity-transparent;
$ouds-button-color-border-strong-pressed-mono: $ouds-color-opacity-transparent;
$ouds-button-color-content-default-disabled-mono: $ouds-color-opacity-black-280;
$ouds-button-color-content-default-disabled: $ouds-color-action-disabled;
$ouds-button-color-content-default-enabled-mono: $ouds-color-functional-black;
$ouds-button-color-content-default-enabled: $ouds-color-action-enabled;
$ouds-button-color-content-default-focus-mono: $ouds-color-functional-white;
$ouds-button-color-content-default-focus: $ouds-color-action-focus;
$ouds-button-color-content-default-hover-mono: $ouds-color-functional-white;
$ouds-button-color-content-default-hover: $ouds-color-action-hover;
$ouds-button-color-content-default-loading-mono: $ouds-color-functional-black;
$ouds-button-color-content-default-loading: $ouds-color-action-loading;
$ouds-button-color-content-default-pressed-mono: $ouds-color-functional-black;
$ouds-button-color-content-default-pressed: $ouds-color-action-pressed;
$ouds-button-color-content-minimal-disabled-mono: $ouds-color-opacity-black-280;
$ouds-button-color-content-minimal-disabled: $ouds-color-action-disabled;
$ouds-button-color-content-minimal-enabled-mono: $ouds-color-functional-black;
$ouds-button-color-content-minimal-enabled: $ouds-color-action-enabled;
$ouds-button-color-content-minimal-focus-mono: $ouds-color-functional-white;
$ouds-button-color-content-minimal-focus: $ouds-color-action-focus;
$ouds-button-color-content-minimal-hover-mono: $ouds-color-functional-white;
$ouds-button-color-content-minimal-hover: $ouds-color-action-hover;
$ouds-button-color-content-minimal-loading-mono: $ouds-color-functional-black;
$ouds-button-color-content-minimal-loading: $ouds-color-content-default;
$ouds-button-color-content-minimal-pressed-mono: $ouds-color-functional-black;
$ouds-button-color-content-minimal-pressed: $ouds-color-action-pressed;
$ouds-button-color-content-strong-disabled-mono: $ouds-color-opacity-white-640;
$ouds-button-color-content-strong-enabled-mono: $ouds-color-functional-white;
$ouds-button-color-content-strong-focus-mono: $ouds-color-functional-white;
$ouds-button-color-content-strong-hover-mono: $ouds-color-functional-white;
$ouds-button-color-content-strong-loading-mono: $ouds-color-functional-black;
$ouds-button-color-content-strong-pressed-mono: $ouds-color-functional-black;
$ouds-button-size-icon-only: $ouds-size-icon-with-label-large-size-sm;
$ouds-button-size-icon: $ouds-size-icon-with-label-large-size-xs;
$ouds-button-size-loader: $ouds-size-icon-with-label-large-size-xs;
$ouds-button-size-max-height-icon-only: $ouds-dimension-600;
$ouds-button-size-min-height: $ouds-dimension-600;
$ouds-button-size-min-width: $ouds-dimension-600;
$ouds-button-space-column-gap-arrow: $ouds-space-column-gap-shorter;
$ouds-button-space-column-gap-icon: $ouds-space-column-gap-short;
$ouds-button-space-inset-icon-only: $ouds-space-inset-medium;
$ouds-button-space-padding-block: $ouds-space-padding-block-medium;
$ouds-button-space-padding-inline-arrow-end: $ouds-space-padding-inline-tall;
$ouds-button-space-padding-inline-arrow-start: $ouds-space-padding-inline-tall;
$ouds-button-space-padding-inline-end-icon-start: $ouds-space-padding-inline-spacious;
$ouds-button-space-padding-inline-icon-none: $ouds-space-padding-inline-huge;
$ouds-button-space-padding-inline-icon-start: $ouds-space-padding-inline-taller;
$ouds-button-space-padding-inline-start-icon-end: $ouds-space-padding-inline-spacious;

Buttons

On this page On this page

Base class

Standard variants

Variants on colored background

With icon

Text and icon

Icon only

Disable text wrapping

Button tags

Outline buttons

Disabled state

Loading state

Block buttons

CSS

Variables

Sass variables

Sass mixins

Component tokens

On this page