X Enterprises
Data

KeyValueList

List container that renders an array of key-value items using XAKeyValue.

Data

Data components handle the rendering of structured information in detail views, sidebars, and list pages. They cover everything from a single formatted number to a full activity feed with date grouping.

Components

<XAKeyValueList />

Renders an array of key-value item objects as a vertical <dl> list using <XAKeyValue> for each entry. Supports a card style and a default slot for custom rendering.

<XAKeyValueList
  :items="[
    { label: 'Name', value: 'Alice Johnson' },
    { label: 'Email', value: 'alice@example.com', type: 'email' },
    { label: 'Role', value: 'admin', type: 'badge', badgeColor: 'primary' },
    { label: 'Joined', value: '2024-01-15', type: 'date', dateFormat: 'long' },
    { label: 'Active', value: true, type: 'boolean' },
  ]"
  layout="horizontal"
  size="md"
  card
/>

Props

PropTypeDefaultDescription
itemsarray[]Array of item objects. Each item can include any XAKeyValue prop (label, value, type, icon, currency, dateFormat, badgeColor, linkText, emptyText).
layout'horizontal' | 'vertical''horizontal'Applied to all items.
size'sm' | 'md' | 'lg''md'Applied to all items.
emptyTextstring'—'Default empty text for all items (overridden per-item).
showLastBorderbooleanfalseShow the bottom border on the last item.
cardbooleanfalseApply card-like background, padding, and rounded corners.

AI Context

component: XAKeyValueList
package: "@xenterprises/nuxt-x-app"
auto-import: true
prefix: XA
category: Data
use-when: Rendering a metadata block with multiple labeled fields in detail panels, drawers, and sidebars. Pass an items array where each item supports any XAKeyValue prop.
Copyright © 2026