action.utility

A small helper command that changes no important data: refresh, mark all read

Component

<Action>

Renders

<button>

Profile

View as Markdown

Action intents

Example

Preview

defaultpresseddisabled

<Action intent="action.utility" onClick={refreshItem}>Refresh</Action>

Code that says refresh, reload, expand, collapse points here. prongs check warns when an element with this intent has a handler or label that points somewhere else.

Choosing between neighbours

Find the row that describes your element, and use the intent on the right.

If it is
Use
A small helper command that changes no important data: refresh, mark all read
action.utility this page
Sharing or copying a link
action.share
Sorting a table by one of its columns
action.sort
Other one-off helper commands
rather than action.share
action.utility this page
A one-off command with no lasting state
rather than action.toggle
action.utility this page

Connections

Declared in the registry, both directions. Where an intent is used in your own code is something check and the gallery see; this site has no app code.

Built from
control.quiet

For registry authors

Starter intents. These are the intents prongs add puts in your registry, shown in this site’s theme. Yours are your own registry.ts: rename, restyle and add to them, and see them with prongs add gallery.

What this intent is built from and its entry in components/prongs/registry.ts. You only need this to change how it looks or to add an intent like it.

How action.utility resolves, and its definition

Each layer adds to the one before it; a later class wins over an earlier one that sets the same thing.

control.base

Shape and behaviour shared by every button

inline-flex shrink-0 items-center justify-center gap-2
whitespace-nowrap rounded-md px-4 py-2 text-sm transition-colors
focus-visible:outline-none focus-visible:ring-2
focus-visible:ring-ring focus-visible:ring-offset-2
ring-offset-surface disabled:pointer-events-none
disabled:opacity-50 aria-disabled:pointer-events-none
aria-disabled:opacity-50

control.quiet

Small text command; shows a pressed state

h-auto px-0 py-0 text-muted-foreground hover:text-foreground
hover:underline underline-offset-4 aria-pressed:text-foreground

action.utility
A small helper command that changes no important data: refresh, mark all read

Final classes

inline-flex shrink-0 items-center justify-center gap-2
whitespace-nowrap rounded-md text-sm transition-colors
focus-visible:outline-none focus-visible:ring-2
focus-visible:ring-ring focus-visible:ring-offset-2
ring-offset-surface disabled:pointer-events-none
disabled:opacity-50 aria-disabled:pointer-events-none
aria-disabled:opacity-50 h-auto px-0 py-0 text-muted-foreground
hover:text-foreground hover:underline underline-offset-4
aria-pressed:text-foreground

Definition

'action.utility': {
  kind: 'semantic',
  description: 'A small helper command that changes no important data: refresh, mark all read',
  refs: ['control.quiet'],
  keywords: ['refresh', 'reload', 'expand', 'collapse'],
  notFor: [
    { context: 'sharing or copying a link', instead: 'action.share' },
    {
      context: 'sorting a table by one of its columns',
      instead: 'action.sort',
    },
  ],
},