nav.view

Switches which view of the same content is shown: Following / For you, list / grid. Pass pressed on the active view

Component

<Action>

Renders

<a>

Profile

View as Markdown

Navigation intents

Example

Preview

defaultpresseddisabled

<Action intent="nav.view" href="/somewhere" pressed={isOn}>View</Action>

Choosing between neighbours

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

If it is
Use
Switches which view of the same content is shown: Following / For you, list / grid. Pass pressed on the active view
nav.view this page
Narrowing a list to matching items
choice.filter
Switching between views of the same content
rather than nav.page
nav.view this page
Switching between views of the same content
rather than layout.siblings
nav.view 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.base

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 nav.view 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

nav.view

Switches which view of the same content is shown: Following / For you, list / grid. Pass pressed on the active view

rounded-full px-3.5 py-1.5 font-medium text-surface-muted
hover:text-foreground aria-pressed:bg-surface-active
aria-pressed:text-foreground

Final classes

inline-flex shrink-0 items-center justify-center gap-2
whitespace-nowrap 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 rounded-full px-3.5 py-1.5 font-medium
text-surface-muted hover:text-foreground
aria-pressed:bg-surface-active aria-pressed:text-foreground

Definition

'nav.view': {
  kind: 'semantic',
  description: 'Switches which view of the same content is shown: Following / For you, list / grid. Pass pressed on the active view',
  refs: ['control.base'],
  binding: {
    classes: 'rounded-full px-3.5 py-1.5 font-medium text-surface-muted hover:text-foreground aria-pressed:bg-surface-active aria-pressed:text-foreground',
  },
  notFor: [
    {
      context: 'narrowing a list to matching items',
      instead: 'choice.filter',
    },
  ],
},