Available · v0.4.0

Resource toolbar

Keep a compact view selector beside a flexible native search input.

Interactive example

Loading Polaris components…

Usage

<ResourceToolbar><s-select label="View"/><s-text-field label="Search"/><s-button>Columns</s-button></ResourceToolbar>

Properties

PropertyTypeDefaultDescription
childrenReactNodeRequiredNative select, search field and action buttons.

Design and interaction

The view selector is 128px, search fills the remaining width. Do not stretch an All selector across half the table. Wrap at narrow sizes. Use a 3:7 view/search ratio and separate sort and column controls.

Accessibility

Host supplies meaningful labels. DOM order stays identical to visual order.

Implementation and ownership

Source: Kaupvik Website, packages/polaris. React client component; controlled host data. No API credentials or merchant transport are included. Host applications own authentication, validation, localization, errors and persisted preferences. Graph nodes use native Shopify identities; diagram positions are presentation only.

Tokens and states

Native controls use Shopify attributes and inherit the host’s design system. Kaupvik layout tokens: --kp-surface, --kp-surface-subdued, --kp-ink, --kp-ink-subdued, --kp-border, --kp-accent, --kp-focus, --kp-radius, --kp-space. Override only within the product surface. Loading, error and empty states are distinct; host data is never invented to fill a preview.

Verification

Test keyboard and pointer operation, focus visibility, 375px and desktop layouts, reduced motion and server hydration. Test every product adapter independently before release. QO remains on its reviewed implementation until its own adoption release.

Related product patterns