Skip to contentKino
Skip to Content

Item

A row of content, alone or in a group that reads as a list. One that is a link or a button takes the rows' tint, and in a group one highlight glides from row to row, as in the Listbox and the Sidebar.

npx shadcn add https://kinoui.com/r/item.json
Share on

Examples

Two-factor authentication

Ask for a code from your authenticator app each time you sign in.

Weekly digest

Your team’s issues, every Monday at 9:00.

Notifications paused

Until 9:00 tomorrow.

Variants

outline draws a border, for an item that stands on its own. muted fills it, to set it apart. default has neither, for items in a list.

Priya Raman

Invited you to Checkout

Priya Raman

Invited you to Checkout

Sizes

sm is as tall as a control with one line of text, and its description is small print, for lists of people or files.

Members

4 people in Kino
Amara Okafor

amara@kinoui.com

Lead
Kenji Watanabe

kenji@kinoui.com

Engineer
Lucía Fernández

lucia@kinoui.com

Designer
Tobias Lindqvist

tobias@kinoui.com

Product

Group

ItemGroup reads as a list, each item an entry of it. ItemSeparator draws a line between them.

Attachments

KN-1284 · Checkout copy
Maya Chen

Added two files today

invoice-march.pdf

182 KB · PDF

hero-mountains.webp

1.4 MB · 2400 × 1600

Media

ItemMedia shows an avatar as it is, an icon in a tile with variant="icon", or a picture cropped to a square with variant="image".

Installation

npx shadcn@latest add https://kinoui.com/r/item.json
Files
components/kino/separator.tsxlib/reduce-motion.tslib/resize.tslib/run-progress.tslib/highlight.tscomponents/kino/item.tsx
Packages
@base-ui/reactclass-variance-authority

New to Kino? Installation covers what your project needs first and the @kino namespace.

API reference

Item

PropTypeDefaultDescription
variant"default""outline""muted""default"Outline draws a border; muted fills it.
size"default""sm""default"Small is as tall as a control with one line of text, with a small-print description.

ItemMedia

PropTypeDefaultDescription
variant"default""icon""image""default"Default shows what it holds as it is, such as an avatar. Icon puts an icon in a tile. Image crops a picture to a square.

Data attributes

AttributeOnDescription
data-variantItem, ItemMediaIts variant.
data-sizeItemIts size.
data-glidedItemPresent while the group’s highlight is on it.

Accessibility

  • ItemGroup is a list, and each item an entry of it, so a screen reader says how many there are.
  • An item that does something is a link (<a href>) or a <button>, given with render. Don’t put another link or button inside one: give a static item ItemActions instead.
  • A link can’t be disabled. Mark one aria-disabled="true": it stays in the tab order so it is read, but a press or Enter does nothing, and the highlight leaves it.
  • The focus ring sits inside the item, so a list that scrolls never cuts it off.
  • The media and the separators are hidden from screen readers. The title names the item.
  • Muted text in an item under the highlight turns darker, so it keeps 4.5:1 on the tint.
  • When the system asks for less motion, the highlight fades between items instead of gliding.