Beautiful pdf components, built on Takumi and Forme. 100% Free, Zero config, one command setup.
---
title: "Key Value"
description: "Definition list of keys and values."
---
<ComponentPreview base="forme" name="key-value" hideCode />
## Installation
<CodeTabs>
<TabsList>
<TabsTrigger value="cli">Command</TabsTrigger>
<TabsTrigger value="manual">Manual</TabsTrigger>
</TabsList>
<TabsContent value="cli">
```bash
npx shadcn@latest add @pdfcn/forme/key-value
```
</TabsContent>
<TabsContent value="manual">
<Steps>
<Step>Install the following dependencies:</Step>
```bash
npm install @formepdf/react @formepdf/core
```
<Step>Copy and paste the following code into your project.</Step>
<ComponentSource
src="registry/bases/forme/components/key-value/key-value.tsx"
base="forme"
title="components/pdf/key-value/key-value.tsx"
/>
<ComponentSource
src="registry/bases/forme/components/theme-provider.tsx"
base="forme"
title="components/pdf/theme-provider.tsx"
/>
<ComponentSource
src="registry/bases/forme/lib/resolve-color.ts"
base="forme"
title="lib/resolve-color.ts"
/>
<ComponentSource
src="registry/themes/professional.ts"
base="forme"
title="lib/pdf-themes/professional.ts"
/>
<ComponentSource
src="registry/themes/primitives.ts"
base="forme"
title="lib/pdf-themes/primitives.ts"
/>
<ComponentSource
src="registry/types/pdf-themes.ts"
base="forme"
title="types/pdf-themes.ts"
/>
<ComponentSource
src="registry/types/pdf-components.ts"
base="forme"
title="types/pdf-components.ts"
/>
<Step>Update the import paths to match your project setup.</Step>
</Steps>
</TabsContent>
</CodeTabs>
## Usage
```tsx
import { KeyValue } from "@/components/pdf/key-value";
```
```tsx
<KeyValue items={[{ key: "Name", value: "Ada" }]} />
```
## API Reference
### KeyValue
| Prop | Type | Default |
| ------------------ | ---------------------------- | ------------ |
| `items` | `KeyValueEntry[]` | - |
| `direction` | `'horizontal' \| 'vertical'` | 'horizontal' |
| `divided` | `boolean` | false |
| `size` | `'sm' \| 'md' \| 'lg'` | 'md' |
| `labelFlex` | `number` | 1 |
| `labelColor` | `string` | - |
| `valueColor` | `string` | - |
| `boldValue` | `boolean` | false |
| `noWrap` | `boolean` | false |
| `dividerColor` | `string` | - |
| `dividerThickness` | `number` | - |
| `dividerMargin` | `number` | - |