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

Documentation

Marketing footer groups

Navigation groups for the marketing shell footer.

All components Marketing Brickwork 4.3.1

Try it

Footer navigation

Open full-page preview

Two labelled navigation groups.

Use when filling the shell marketing_footer block with grouped navigation.

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/_marketing_footer_groups.html" %}

your_app/views.py

Python

context = {'groups': [{'heading': 'Product', 'links': [{'label': 'Components', 'href': '/components/'}, {'label': 'Documentation', 'href': '/docs/'}]}, {'heading': 'Company', 'links': [{'label': 'About', 'href': '/about/'}]}]}

Guide

Add it to your project

  1. Use the public include path "brickwork_marketing/components/_marketing_footer_groups.html" from the installed django-brickwork package.
  2. Override the marketing footer block in a template that extends the marketing shell.
  3. Include this template with groups supplied by the view or wrapper.
  4. Give each group a distinct id when its slugified heading would collide.

View this component's source for the installed release

Options

Public API

Option Type Default Required Description
groups list of {heading, links:[{label, href}], id?} Not set Yes Footer navigation groups: `{heading, links: [{label, href}], id?}`. Constraint: Every group needs `heading` and `links`; omit `id` only when its slugified heading will be unique on the page.
groups[].heading string Not set Yes Visible heading for this footer navigation group. Constraint: No additional template constraint beyond the documented type.
groups[].id string Not set No Unique heading id; otherwise generated from heading. Constraint: No additional template constraint beyond the documented type.

Behaviour

Accessibility and responsive behaviour

Accessibility
Each group is a nav labelled by its heading.
Responsive
One column then two from sm.
Without JavaScript
Static navigation; no JavaScript required.

Need help?

Troubleshooting

A footer group has no usable links.

Supply the documented link dictionaries for each group and validate their destinations in the consumer application.

Explore next

Used in examples

Documentation