CSS Pseudo-elements

Introduction

Pseudo-elements style a part of an element — its first letter, its first line, or content inserted before/after. They're written with double colons (::).

Business problem

Business pressure: Product teams need CSS pseudo-elements implemented consistently — layout regressions, WCAG failures, and LCP/CLS cliffs on Material Design-scale surfaces directly hit conversion and brand trust.

• Conversion: Visual polish and render performance on CSS pseudo-elements surfaces affect checkout and signup funnels at Polaris.
• Brand: Inconsistent CSS pseudo-elements fragments Carbon design-system contracts across squads.
• Velocity: CSS debt around CSS pseudo-elements slows every feature team — staff engineers treat styling as platform infrastructure.

Why this feature exists

Platform history: CSS standardized CSS pseudo-elements so authors could separate presentation from HTML without table-layout hacks or per-element JavaScript layout engines.

• Problem solved: Declarative, cacheable styling for CSS pseudo-elements across entire sites and design systems.
• Rejected alternative: Inline styles and JS layout — unmaintainable at Material Design product scale.

Browser rendering perspective

Rendering impact: CSS Pseudo-elements touches the style → layout → paint → composite pipeline differently per engine when CSS pseudo-elements rules change.

• Chrome (Blink): Style invalidation → LayoutNG → Paint → Viz compositor; properties used in CSS pseudo-elements may trigger layout-only or paint-only invalidation.
• Firefox (Gecko): Servo Stylo resolves cascade; WebRender composites — subpixel CSS pseudo-elements rounding can differ from Blink.
• Safari (WebKit): WebKit style resolver + GPU layer rules; CSS pseudo-elements bugs often surface only on iOS Safari — validate on real devices.

Internal browser workflow

Workflow: DOM + CSSOM → selector matching for CSS pseudo-elements rules → cascade/specificity → computed values → layout tree → paint → composite.

• Matching cost: Overly broad selectors for CSS pseudo-elements increase style recalc on large Polaris product DOMs.
• Cascade: Source order, specificity, and inheritance pick winning CSS pseudo-elements declarations.
• DevTools: Computed tab shows final CSS pseudo-elements values — diff across Chrome, Firefox, and Safari.

Syntax

The most-used pseudo-elements:

p::first-letter { font-size: 3em; float: left; }
p::first-line   { font-weight: 600; }
.quote::before  { content: "“"; color: #94a3b8; }
.quote::after   { content: "”"; color: #94a3b8; }
::selection     { background: #4f46e5; color: white; }

Real-world use

Custom checkboxes are built almost entirely with ::before drawing the box and :checked + label::before drawing the checkmark — no JavaScript needed.

Real production example

Production: Material Design, Polaris, and Shopify codify CSS pseudo-elements via design tokens, Stylelint, visual regression CI, and component prop APIs aligned with Carbon.

• Pattern: Token-driven CSS pseudo-elements with Percy/Chromatic snapshots on every PR.
• Observability: CrUX/RUM tie CSS pseudo-elements changes to LCP and CLS on high-traffic templates.
• Contract: Design system documents allowed values — no rogue hex in product CSS.

Enterprise use case

Enterprise: Polaris, Carbon, and Material Design encode CSS pseudo-elements in multi-brand token pipelines, dark mode, and white-label tenant themes.

• Component APIs: Apps consume CSS pseudo-elements via tokens and props — not ad-hoc stylesheets.
• CI gates: axe, contrast checks, and Coverage audits block CSS pseudo-elements regressions before merge.
• Migration: Legacy CSS pseudo-elements refactors use codemods plus visual diff baselines.

Accessibility considerations

A11y: CSS pseudo-elements must not remove focus visibility, break 200% zoom, convey state by color alone, or hide content from assistive technology (WCAG 2.2).

• Focus: :focus-visible + outline — never naked outline: none.
• Contrast: Verify CSS pseudo-elements color choices meet 4.5:1 on Polaris checkout and form flows.
• Motion: Gate CSS pseudo-elements animations behind prefers-reduced-motion.

Performance considerations

Performance: CSS pseudo-elements can trigger reflow, expensive selectors, compositor layer explosion, or unused CSS bloat — profile with DevTools Performance and Coverage.

• Animation: Animate transform/opacity for CSS pseudo-elements — avoid layout-thrashing properties.
• Selectors: Deep chains for CSS pseudo-elements slow style recalc on Material Design-size pages.
• Payload: Purge unused CSS pseudo-elements rules in production bundles (Tailwind JIT, PurgeCSS).

SEO considerations

SEO: CSS pseudo-elements affects LCP, CLS, and mobile usability — Google Core Web Vitals and readable above-the-fold content are ranking signals.

• LCP: CSS pseudo-elements on hero type and images determines largest contentful paint timing.
• CLS: Reserve space with sizing (CSS pseudo-elements) before fonts and images load.
• Mobile: Readable CSS pseudo-elements at 320px — Material Design mobile-first baseline.

Scalability considerations

Scale: CSS pseudo-elements choices compound across micro-frontends, A/B skins, dark mode, and Polaris multi-tenant white-label themes.

• Tokens: Centralize CSS pseudo-elements in custom properties — not magic numbers per squad.
• Specificity: Flat selectors scale better than nested wars across dozens of teams.
• Theming: Polaris and Carbon theme switches depend on consistent CSS pseudo-elements architecture.

Common production issues

Production failures: Specificity overrides, Safari-only CSS pseudo-elements glitches, stacking contexts, and breakpoints that pass Chrome CI but fail iOS WebKit.

• Cross-browser: Subpixel CSS pseudo-elements differs Blink vs WebKit — test real Safari.
• Regression: Global token change breaks unrelated CSS pseudo-elements — visual CI catches it.
• Third-party: Widget CSS collides with app CSS pseudo-elements — namespace or Shadow DOM.

Debugging guide

Debug: Chrome DevTools Elements (Styles + Computed), Layout/Flex/Grid overlays; Firefox layout tools; Safari Web Inspector on device.

• Overrides: Crossed-out CSS pseudo-elements rules — trace specificity winner.
• Box model: Inspect margin/padding/border when CSS pseudo-elements layout surprises.
• Coverage: Find dead CSS pseudo-elements CSS bloating bundles.

/* DevTools workflow — pseudo-elements */
1. Elements → select target node
2. Computed → filter relevant properties
3. Layout → box model + flex/grid overlay
4. Performance → record scroll/interaction

Best practices

• Use double colons (::) — single colon is the old syntax.
• content is required on ::before and ::after.

Anti-patterns

• Inline styles: CSS pseudo-elements via style="" — unmaintainable at Material Design scale.
• !important wars: Fixing CSS pseudo-elements with specificity nukes instead of architecture.
• Magic numbers: Random px for CSS pseudo-elements outside the spacing/type token scale.

Trade-offs

• Utility vs components: Tailwind velocity vs Carbon-style token components for CSS pseudo-elements.
• Reset vs normalize: Predictable CSS pseudo-elements baseline vs faster initial ship.
• Pure CSS vs JS: CSS pseudo-elements without JavaScript until touch/a11y needs progressive enhancement.

Architecture review questions

• Which CSS pseudo-elements properties trigger layout vs paint vs composite-only updates?
• How does this CSS pseudo-elements choice affect WCAG contrast and keyboard focus visibility?
• What happens to CSS pseudo-elements under dark mode and Carbon design tokens?
• Where could CSS pseudo-elements cause CLS or LCP regression on Polaris templates?
• How would you debug overridden CSS pseudo-elements rules in production?
• What is the migration path for CSS pseudo-elements across 20 micro-frontends?

Interview questions

Hands-on exercise

Exercise: Implement CSS pseudo-elements on a component using Polaris spacing tokens — pass axe, Lighthouse ≥ 90, and Percy snapshots on mobile + desktop.

• Deliverable: PR with CSS pseudo-elements CSS, token references, before/after screenshots.
• Verify: Keyboard-only nav, 200% zoom, prefers-reduced-motion.
• Stretch: ADR for CSS pseudo-elements token naming in your design system.

Staff engineer notes

• Rendering lens: Classify every CSS pseudo-elements property as layout, paint, or composite — animate composite-safe properties only.
• Platform lens: CSS pseudo-elements belongs in the design-system layer; product teams consume tokens.
• Measurement lens: Tie CSS pseudo-elements changes to CrUX LCP/CLS on Polaris — CSS is revenue infrastructure.

Common pitfalls

• ::before / ::after don't work on replaced elements (img, input).

Try it yourself

Edit the CSS panel — the preview updates live. Use DevTools Performance and Accessibility panels to validate.

Summary

CSS Pseudo-elements is core CSS engineering. Staff engineers evaluate CSS pseudo-elements through browser pipelines (Blink, Gecko, WebKit), WCAG 2.2, and design-system contracts (Material Design, Polaris, Carbon) — scaling across Material Design-class product surfaces without layout or accessibility debt.

Key takeaways

• Double colons mark pseudo-elements.
• content is required on ::before / ::after.
• Replace fake-HTML decorations with pseudo-elements.