Blockquote

Typography
stable

Typographic citation component with five visual variants, author/source attribution and locale-aware decorative quote marks.

Preview

Rendering the live preview…

default

Rendering the live preview…

elegant

Rendering the live preview…

pull

Rendering the live preview…

minimal

Rendering the live preview…

quoted

Structure

Anatomy

Visual breakdown of the component's internal structure with BEM class call-outs.

Anatomy of OrigamBlockquoteSchematic of the Blockquote component with 5 numbered internal parts. " #default slot — citation body — Author, Source 1 2 3 4 5
Anatomy of <origam-blockquote> — 5 parts: root ①, accent bar ②, quote mark glyph ③ (variant="quoted" only), body ④, attribution footer ⑤ (author + source).
1.origam-blockquote
Root element. Defaults to
; overridable via tag. Carries variant, align, color and accent modifier classes.
2.origam-blockquote__mark--bg
Decorative opening quote glyph. Absolute, z-index 0, opacity ~0.08. Rendered when the quoteMark prop is on — the quoted variant preset turns it on, and it is reachable on any variant.
3.origam-blockquote__body
Citation body wrapper. Raised to z-index 1 by a sibling selector whenever the decorative glyph is present, so the text sits above it.
4.origam-blockquote__attribution
Footer
containing the author span, separator and source . Renders only when author or source is present.
5.origam-blockquote__source
element wrapping the source label. Receives source---color token for secondary italic styling.

API

Props

All props accepted by this component, with their type, default value and description.

variant
'default'
Visual variant: "default" = left accent bar, "elegant" = serif italic, "quoted" = decorative glyph background, "pull" = centered large pull quote with top/bottom rules, "minimal" = thin bar with smaller text.
author
string
Author of the citation rendered as "— Author" in the attribution footer. Can be overridden via the #author slot.
source
string
Source label (book, publication, URL label) appended after the author as ", Source". Wrapped in <cite> when the cite prop is set.
cite
string
URL the citation references. Maps to the native cite attribute on the rendered <blockquote>.
lang
'auto'
Locale hint for decorative quote marks (variant="quoted"). "auto" reads document.documentElement.lang at mount, falling back to "en".
align
'left'
Text alignment. The pull variant forces "center" when this prop is not set. Accepts "left", "center" or "right".
quoteMark
boolean
id
string
class
string | Array<string> | object
style
string | Array<string> | object | StyleValue
tag
string
'blockquote'
HTML element rendered at the root. Defaults to <blockquote>; use "q" for inline citations.
color
Text color axis. Tokenised intents resolve to their fgSubtle shade; custom values are applied verbatim.
accentColor
TColor
bgColor
Accent color axis: drives the decorative bar / pull rules, the background quote glyph and the author label. Does NOT paint a surface fill.
Border-radius token or boolean.
roundedTopRight
boolean | number | string
roundedTopLeft
boolean | number | string
roundedBottomLeft
boolean | number | string
roundedBottomRight
boolean | number | string
roundedStartStart
boolean | number | string
roundedStartEnd
boolean | number | string
roundedEndStart
boolean | number | string
roundedEndEnd
boolean | number | string
elevation
TElevation
Box-shadow elevation token.
border
boolean | number | string | TDirectionBoth | Array<TDirectionBoth>
false
Applies a border. Distinct from the variant accent bar.
borderTop
boolean | number | string
borderLeft
boolean | number | string
borderBottom
boolean | number | string
borderRight
boolean | number | string
borderBlock
boolean | number | string
borderInline
boolean | number | string
borderInlineStart
boolean | number | string
borderInlineEnd
boolean | number | string
borderBlockStart
boolean | number | string
borderBlockEnd
boolean | number | string
borderColor
string
borderStyle
string
borderTopColor
TColor
borderRightColor
TColor
borderBottomColor
TColor
borderLeftColor
TColor
borderInlineStartColor
TColor
borderInlineEndColor
TColor
borderBlockStartColor
TColor
borderBlockEndColor
TColor
padding
boolean | number | string
Custom padding overriding token defaults.
paddingTop
boolean | number | string
paddingLeft
boolean | number | string
paddingBottom
boolean | number | string
paddingRight
boolean | number | string
paddingBlock
boolean | number | string
paddingInline
boolean | number | string
paddingInlineStart
boolean | number | string
paddingInlineEnd
boolean | number | string
paddingBlockStart
boolean | number | string
paddingBlockEnd
boolean | number | string
margin
boolean | number | string
Custom margin. The component imposes no margin by default.
marginTop
boolean | number | string
marginLeft
boolean | number | string
marginBottom
boolean | number | string
marginRight
boolean | number | string
marginBlock
boolean | number | string
marginInline
boolean | number | string
marginInlineStart
boolean | number | string
marginInlineEnd
boolean | number | string
marginBlockStart
boolean | number | string
marginBlockEnd
boolean | number | string
fontFamily
TFontFamily
fontSize
TFontSize
fontWeight
TFontWeight
lineHeight
TLineHeight
letterSpacing
TLetterSpacing
fontStyle
string
textTransform
TTextTransform

API

Slots

Content slots exposed by this component.

#default
Citation body content. Rendered inside the __body div.
#author
Custom author rendering (link, badge, locale-formatted name). Wins over the author prop.
#source
Custom source rendering. Wins over the source prop. Wrapped in <cite> by default.

API

Exposed members

Properties and methods accessible via template ref (defineExpose). Use them for programmatic control.

ComputedRef<string>
Resolved locale (after "auto" resolution from DOM or fallback to "en").
ComputedRef<string>
Locale-appropriate opening quote glyph (e.g. """ for en, "«" for fr).
ComputedRef<string>
Locale-appropriate closing quote glyph.
ComputedRef<boolean>
True when the attribution footer should render (author or source present).

Customisation

CSS variables

CSS custom properties exposed by this component. Override them to customise the component without losing theme compatibility.

Block padding of the citation container.
Inline padding. Expanded by the accent bar width in default/elegant variants.
Citation body font size.
Font style. Overridden to italic in elegant and minimal variants.
Citation body line-height.
Citation text color. Overridden by color intent classes.
Resolved accent color driving the bar, glyph and author label.
Width of the decorative accent bar (default / elegant variants).
Author attribution color.
Size of the decorative background quote glyph (variant="quoted").
Opacity of the background glyph.

Inclusion

Accessibility

ARIA roles, keyboard navigation and focus management. Sourced from the real component template.

ARIA roles

blockquote

Keyboard interactions

Keyboard interactions
KeyAction
TabMoves focus through interactive content inside the citation body if any.

Notes

  • The cite prop maps to the native cite attribute on the <blockquote>, providing the URL to assistive technologies and browser inspectors.
  • The decorative quote mark (<span class="origam-blockquote__mark">) is aria-hidden="true" — it is purely decorative and not announced by screen readers.
  • The em-dash before the author name (<span class="origam-blockquote__dash">) is also aria-hidden to avoid double reading.
  • The source label is wrapped in <cite> for semantic correctness per the HTML spec.

Foundation

Design tokens

Excerpt from this component's token declarations — the --origam-<component>---<property> variables, declared in its hand-maintained token sheet with no build step.

Source
dimension
var(--origam-font__size---lg)
Body font size.
number
var(--origam-font__lineHeight---relaxed)
Body line-height.
color
var(--origam-color__action--primary---bg)
Default accent bar / glyph color.
dimension
4px
Accent bar width.
dimension
8rem
Background glyph size in quoted variant.

Interactive

Playground

Edit props live and see the component update in real time. The generated code snippet updates as you change values.

Rendering the live preview…

Usage

Examples

Ready-to-paste code snippets for your templates.

Default variant

vue

Pull-quote variant

vue

Quoted with locale marks

vue