Pivot Docs

    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-byline fallback 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-quote inside 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


    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.