Marketing footer groups
Navigation groups for the marketing shell footer.
Try it
Footer navigation
Two labelled navigation groups.
Use it
Working invocation
This code creates the configuration shown above. Copy the template and the required Python context together.
{% include "brickwork_marketing/components/_marketing_footer_groups.html" %}
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
- Use the public include path "brickwork_marketing/components/_marketing_footer_groups.html" from the installed django-brickwork package.
- Override the marketing footer block in a template that extends the marketing shell.
- Include this template with groups supplied by the view or wrapper.
- Give each group a distinct id when its slugified heading would collide.
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[].links | list of {label, href} | Not set | Yes | Link dictionaries consumed by the footer 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