Skip to main content
brickwork
GitHub Log in Get started
Display
Theme
Density
Direction
Brand

Documentation

Section intro

A convenience include for the public shared section-intro class contract.

All components Marketing Brickwork 4.3.1

Try it

Shared intro

Open full-page preview

All three shared intro roles.

Components

One contract per component

Read supported options from the shipped template.

Use inside bw-section__inner when an existing named component needs shared overline, heading and lede markup.

Use it

Working invocation

This code creates the configuration shown above. Copy the template and the required Python context together.

templates/your_app/component.html

Django template

{% include "brickwork_marketing/components/_section_intro.html" %}

your_app/views.py

Python

context = {'overline': 'Components', 'heading': 'One contract per component', 'lede': 'Read supported options from the shipped template.'}

Guide

Add it to your project

  1. Use the public include path "brickwork_marketing/components/_section_intro.html" from the installed django-brickwork package.
  2. Place it inside a bw-section__inner.
  3. Include with any combination of overline, heading and lede.
  4. Write the same public classes yourself when custom surrounding markup is clearer.

View this component's source for the installed release

Options

Public API

Option Type Default Required Description
overline string Not set No Optional eyebrow above the section heading. Constraint: No additional template constraint beyond the documented type.
heading string Not set No Section heading; its semantic level is set by this component. Constraint: No additional template constraint beyond the documented type.
lede string Not set No Short supporting copy below the section heading. Constraint: No additional template constraint beyond the documented type.

Behaviour

Accessibility and responsive behaviour

Accessibility
Heading is h2; caller owns its correct place in the page outline.
Responsive
Fluid token-based typography, without a breakpoint switch.
Without JavaScript
Static HTML; no JavaScript required.

Need help?

Troubleshooting

The intro has no visual spacing.

Place it inside a `.bw-section__inner` container so the shared section spacing and measure contract applies.

Explore next

Used in examples

Documentation