v1.3.1
  1. Foundations
  2. How-tos
  3. Patterns
    1. Autocomplete
    2. Button
    3. Callout
    4. Chat
    5. Description List
    6. Fallback Image
    7. Feedback
    8. Focus Indicator
    9. Footer
    10. Header
    11. Hero
    12. IIIF Image
    13. Link
    14. Page Title
    15. Results per Page

Button

Buttons are for actions. People expect buttons to do an action and links to navigate to another page.

Help people take actions like submitting a form.

When to use

Use buttons for actions like search, request, or delete. Use links for navigation from one page to another.

How to use

Use button types to create a hierarchy that guides people toward the most important actions.

Default buttons should make up most of the page. Too many accent, success, or attention type buttons make it harder for people to focus.

Default

Use .pl-button for most actions on the page. It tells people this is not the main focus.

<div class="pl-margin-m">
  <button class="pl-button">Okay</button>
</div>

Accent

Use .pl-button--accent for the main action on the page. It tells people "start here."

<div class="pl-margin-m">
  <button class="pl-button pl-button--accent">Find it</button>
</div>

Success

Use .pl-button--success for actions that complete a task, like placing a request or saving a change.

<div class="pl-margin-m">
  <button class="pl-button pl-button--success">Request an item</button>
</div>

Attention

Use .pl-button--attention for actions that are hard to undo, like deleting or canceling something.

<div class="pl-margin-m">
  <button class="pl-button pl-button--attention">Delete</button>
</div>

Button labels

Keep labels short and start with a verb that describes what happens when people select the button.

Related guidelines

Design System

About Writing for People Build Digital Spaces v1.3.1