Pull Quote
pivot-pull-quote is a semantic blockquote component designed to display quoted content with optional attribution. It renders an HTML5 <blockquote> for the quote and a <figcaption> for the byline, and assigns role="figure" to the host element to group the two together.
Quick Start
<!-- Basic pull quote with byline -->
<pivot-pull-quote>
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
tempor incididunt ut labore et dolore magna aliqua.
</p>
<span slot="byline">Author Name, Title</span>
</pivot-pull-quote>
<!-- Pull quote with border styling -->
<pivot-pull-quote pivot-border>
<p>
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod
tempor incididunt ut labore et dolore magna aliqua.
</p>
<span slot="byline">Another Author</span>
</pivot-pull-quote>Using the default slot
The default (unnamed) slot accepts the quote content, typically one or more <p> elements. Opening and closing quotation marks are added automatically via CSS ::before/::after on p:first-of-type and p:last-of-type respectively — quote marks only appear when the content uses <p> tags:
<pivot-pull-quote>
<p>The only way to do great work is to love what you do.</p>
</pivot-pull-quote>On firstUpdated and on every subsequent slotchange, the component walks the assigned nodes and trims leading/trailing whitespace from text nodes. This means source-formatting whitespace (e.g. indentation and line breaks around the slotted markup) will not introduce stray spaces before the opening quote mark or after the closing one.
Using the byline slot
The byline slot holds the attribution for the quote (author, title, source) and renders inside a <figcaption>. Prefer setting it explicitly:
<pivot-pull-quote>
<p>Innovation distinguishes between a leader and a follower.</p>
<span slot="byline">Steve Jobs</span>
</pivot-pull-quote>Automatic fallback assignment: if no element is explicitly given slot="byline", the component will look at the default-slotted children and, when there are two or more of them, treat the last one as the byline — but only if that element is a <span>, <cite>, or <small>, or carries a data-byline attribute. If it qualifies, the component assigns slot="byline" to it for you:
<!-- Equivalent to explicitly slotting the <cite> as the byline -->
<pivot-pull-quote>
<p>Innovation distinguishes between a leader and a follower.</p>
<cite>Steve Jobs</cite>
</pivot-pull-quote>This fallback exists primarily for content pipelines (e.g. statically-generated markup) where a slot attribute may be stripped or hard to author directly. When you control the markup, set slot="byline" explicitly rather than relying on tag-name inference — it’s clearer and isn’t affected by the allowed-tag/attribute check.
Whether the byline slot ends up with content (explicit or fallback) is tracked on the host via the data-has-byline attribute, which the component adds or removes on every slot change. This attribute drives the em dash (—) rendered before the byline — it will not appear if the byline slot is empty.
Border Styling
Set the pivot-border attribute to add emphasis border styling — vertical/horizontal padding (--component-pull-quote-inset-y, --component-pull-quote-inset-x) and a colored side border (--global-color-brand-primary1-color, --component-pull-quote-border) — around the quote:
<pivot-pull-quote pivot-border>
<p>Innovation distinguishes between a leader and a follower.</p>
<span slot="byline">Steve Jobs</span>
</pivot-pull-quote>Without pivot-border, the component renders with no padding or border, relying on surrounding layout for spacing.
Styling Best Practices
- Use semantic HTML for content: place quote text in
<p>tags within the default slot so the automatic quotation marks apply. - Prefer an explicit
slot="byline": only rely on the tag-name/data-bylinefallback when you can’t control the slotted markup directly. - Keep the byline concise: attribution should be brief and clear.
- Avoid nesting: do not nest another
pivot-pull-quoteinside the component.
Accessibility
ARIA Roles and Semantics
pivot-pull-quote sets role="figure" on the host element in its constructor (this.role = "figure") rather than rendering a native <figure> element. Inside its shadow root, the quote content is marked up as a <blockquote> and the byline as a <figcaption>, which satisfies WCAG 1.3.1 (Info and Relationships) by conveying the quote/attribution relationship through semantic structure rather than presentation alone.
When a non-empty byline is present, the component sets the host’s aria-label to the byline text. This provides a consistent accessible name for its role="figure" across browser and assistive-technology combinations (WCAG 4.1.2, Name, Role, Value). An aria-label or aria-labelledby supplied directly on pivot-pull-quote takes precedence and is never overwritten.
Screen Reader Behavior
Screen readers encounter the host as a figure containing a blockquote (the quote text) and a figcaption (the byline, when present). The em dash inserted before the byline (via data-has-byline) is a purely visual separator implemented in CSS — it is not additional announced text beyond the character itself.
Keyboard Navigation
pivot-pull-quote is purely presentational and attaches no keyboard handlers of its own. There is no interactive behavior to operate — users encounter and read past the quote using standard text/content navigation (e.g. a screen reader’s reading cursor, or Tab if the slotted content itself contains focusable elements such as a link).
Focus Management
The component does not call .focus()/.blur(), set tabindex, or trap focus. It inherits delegatesFocus: true from PivotBase’s shadow root options, which only becomes observable if slotted content includes a focusable element (e.g. a link in the byline): in that case, calling .focus() on the host would delegate focus to that element, and the host would pick up matching :focus/:focus-within styling while it’s focused. With the typical text-only quote and byline, there is nothing focusable and this has no visible effect.
References
- MDN — HTML
<blockquote>element - MDN — HTML
<figcaption>element - ARIA Authoring Practices Guide — Figure Pattern
- WebAIM — Using Semantic HTML
API Reference
Props
| Name | Type | Default | Description |
|---|---|---|---|
pivot-border |
boolean |
false |
Adds emphasis border styling to the pull quote. Presence of the attribute means true: <pivot-pull-quote pivot-border> |
Slots
| Name | Description |
|---|---|
default |
Default slot for the quote content |
byline |
Optional byline attribution |
CSS Custom Properties
| Name | Description |
|---|---|
--global-color-text-text-max-width |
Maximum inline size of the component. |
--typography-constants-misc-quote-family |
Font family of the quote text. |
--typography-private-quote-size |
Font size of the quote text. |
--typography-private-quote-height |
Line height of the quote text. |
--global-color-text-on-light-header-color |
Text color of the quote and byline. |
--typography-private-quote-space |
Letter spacing of the quote text. |
--typography-private-card-byline-family |
Font family of the byline text. |
--typography-private-card-byline-size |
Font size of the byline text. |
--typography-private-card-byline-height |
Line height of the byline text. |
--typography-private-card-byline-space |
Letter spacing of the byline text. |
--component-pull-quote-inset-y |
Vertical padding applied when `pivot-border` is set. |
--component-pull-quote-inset-x |
Horizontal padding applied when `pivot-border` is set. |
--global-color-brand-primary1-color |
Border color applied when `pivot-border` is set. |
--component-pull-quote-border |
Border width applied when `pivot-border` is set. |
figma_link: https://www.figma.com/design/10MEdQAgIyfij054E7CGV1/Pivot-Design-System–%E2%AD%90%EF%B8%8F?node-id=19632-670
Pull Quote with Border — light surface
Lorem ipsum dolor sit amet consectetur. Mauris sit nulla malesuada vestibulum risus ut ultricies sagittis. Semper egestas nunc egestas at nulla. Consequat eget mattis feugiat fames urna neque. Lectus porttitor ultrices nisl turpis leo sed.
Jane Smith, Grain & Pork Inc<pivot-pull-quote pivot-border>
<p>Lorem ipsum dolor sit amet consectetur...</p>
<span slot="byline">Jane Smith, Grain & Pork Inc</span>
</pivot-pull-quote>Pull Quote without Border — light surface
Lorem ipsum dolor sit amet consectetur. Mauris sit nulla malesuada vestibulum risus ut ultricies sagittis. Semper egestas nunc egestas at nulla. Consequat eget mattis feugiat fames urna neque. Lectus porttitor ultrices nisl turpis leo sed.
Jane Smith, Grain & Pork Inc<pivot-pull-quote>
<p>Lorem ipsum dolor sit amet consectetur...</p>
<span slot="byline">Jane Smith, Grain & Pork Inc</span>
</pivot-pull-quote>Automatic byline fallback assignment (no explicit slot="byline")
Neither child below has a slot attribute. Because there are two unslotted children and the last one is a <cite> — one of the allowed fallback tags (<span>, <cite>, <small>, or any element carrying data-byline) — the component assigns it to the byline slot for you on render. The result is visually identical to setting slot="byline" explicitly; this fallback exists for content pipelines where a slot attribute may get stripped or is hard to author directly. When you control the markup, prefer setting slot="byline" explicitly instead of relying on this inference.
Innovation distinguishes between a leader and a follower.
Steve Jobs<pivot-pull-quote>
<p>Innovation distinguishes between a leader and a follower.</p>
<cite>Steve Jobs</cite>
</pivot-pull-quote>