Code
Headless code typography primitive for consumer-owned inline and block code styling.
| Package | @vizejs/ui/code |
| Maturity | stable |
| Own the source | vize lib pull code |
| Requires | — |
| Aliases | inline code, code snippet, code block, monospace text |
| Covers | HTML code element, HTML pre element, Reka UI Primitive |
Minimal setup
Use a Vue 3.5+ project with Vue SFC compilation configured (see Vite+ integration).
vp install @vizejs/ui
Add the public import below to <script setup lang="ts">. Components provide behavior without styles; the preview uses optional Paper styles.
import { Code } from "@vizejs/ui/code";
Or copy the source into your project with vize lib pull code (see Source Distribution).
Try it
This is the basic example maintained with the component source, using the public package imports. The preview adds the optional Paper styles.
Open the interactive example · Styling these components
Copy the example
<!-- Inline code within prose next to a preformatted block of shell commands. -->
<script setup lang="ts">
import { Code } from "@vizejs/ui/code";
</script>
<template>
<div>
<p>
Install the package, then import <Code>Button</Code> from
<Code tone="accent">@vizejs/ui</Code>.
</p>
<pre><Code variant="block" size="sm">npm install @vizejs/ui
npx vize lint src</Code></pre>
</div>
</template>
API
Code
Source: src/families/typography/code/code.vue
Props
| Prop | Type | Default | Description |
|---|---|---|---|
as |
PrimitiveAs |
"code" |
Native element, custom element, or component to render. |
size |
CodeSize |
"md" |
Consumer code-size token mirrored to data-size; no CSS is emitted. |
variant |
CodeVariant |
"inline" |
Code presentation token mirrored to data-variant; no CSS is emitted. |
tone |
CodeTone |
"neutral" |
Consumer tone token mirrored to data-tone; no CSS is emitted. |
Slots
| Slot | Slot props | Description |
|---|---|---|
default |
CodeSlotState |
Renders code content with current typography hook state. |
Exposed
| Member | Type | Description |
|---|---|---|
size |
CodeSize |
Consumer size token mirrored to data-size. |
variant |
CodeVariant |
Presentation variant mirrored to data-variant. |
tone |
CodeTone |
Consumer tone token mirrored to data-tone. |
element |
CodeElement | null |
Rendered host element or component instance. |
Behavior
Normative state x input -> outcome table for code.vue (@vizejs/ui/code).
Every row is proven by the named mounted-DOM or SSR test. A row without a
passing test is a contract violation.
| # | State | Input | Outcome | Proven by |
|---|---|---|---|---|
| C1 | default | render / Tab | renders native <code data-vize-ui="code">, part="root", default hooks, slot text, and no focus |
renders native code by default without adding semantics or styling |
| C2 | custom hooks | render | renders the requested host while mirroring strict size, variant, and tone hooks | mirrors code presentation hooks on a custom host |
| C3 | consumer ARIA | fallthrough attrs | preserves consumer-owned role, label, and focus attributes without deriving custom semantics | keeps custom semantics and focus policy consumer owned through attrs |
| C4 | any | slot/expose | passes size, variant, and tone to the slot and exposes the rendered element with live props | passes slot state and exposes live code state |
| C5 | SSR default | isolated requests | renders byte-identical native code markup without request-global state | renders byte-identical native code markup across isolated SSR requests |
| C6 | SSR custom | render | renders custom host markup with consumer-owned semantics and no default aria-hidden or style |
renders consumer-owned server semantics without implicit accessibility attrs |
| C7 | DOM/SSR/Vapor | compile | authored SFC compiles in every renderer lane without warnings or fallback | scripts/check-renderers.ts |
| C8 | SSR/hydration | hydrate | server code markup hydrates without warnings, node replacement, or accessibility drift | src/conformance/runtime-conformance.test.ts |
| C9 | root/subpath | consumer bundle | root and subpath consumers retain only Code, emit no CSS, and stay within gzip budget | scripts/check-tree-shaking.mjs |
Props
| Prop | Type | Purpose | Default |
|---|---|---|---|
as |
PrimitiveAs |
Native element, custom element, or component rendered as host. | "code" |
size |
"sm" | "md" | "lg" |
Consumer code-size token mirrored to data-size. |
"md" |
variant |
"inline" | "block" | "snippet" |
Code presentation token mirrored to data-variant. |
"inline" |
tone |
"neutral" | "muted" | "accent" | "success" | "warning" | "danger" |
Consumer color or semantic tone token mirrored to data-tone. |
"neutral" |
Slots
| Slot | Props | Purpose | Default |
|---|---|---|---|
default |
{ size: CodeSize; variant: CodeVariant; tone: CodeTone } |
Render inline code, block code, or snippets. | none |
Expose
| Name | Type | Purpose | Default |
|---|---|---|---|
element |
CodeElement | null |
Rendered host element or component instance. | null |
size |
CodeSize |
Current visual-size token. | "md" |
variant |
CodeVariant |
Current presentation token. | "inline" |
tone |
CodeTone |
Current tone token. | "neutral" |
Data Attributes
| Attribute | Values | Purpose | Default |
|---|---|---|---|
data-vize-ui |
"code" |
Stable family selector. | always |
data-size |
"sm", "md", "lg" |
Consumer visual-size hook. | "md" |
data-variant |
"inline", "block", "snippet" |
Presentation hook. | "inline" |
data-tone |
"neutral", "muted", "accent", "success", "warning", "danger" |
Consumer tone hook. | "neutral" |
ARIA Attributes
Code never sets role, tabindex, aria-hidden, aria-live, aria-label,
or aria-labelledby by default. Native <code> remains exposed as code
content. Consumers that need a labelled region, term, focusable command
example, or hidden decorative code pass ordinary Vue fallthrough attributes
themselves.
CSS Custom Properties
Code defines no CSS custom properties and ships no stylesheet. Consumers own monospace font selection, syntax color, wrapping, white-space, indentation, block layout, and inline rhythm through ordinary CSS.
Parts
| Part | Purpose | Default |
|---|---|---|
root |
Single rendered host. | always |