This module allows you to customize heading levels and styles for blocks placed using Layout Builder. It improves accessibility and design flexibility for site builders and content creators.
This module is a work in progress and may be very opinionated with help text!The Layout Builder Block Headings module enhances site accessibility, lifts design constraints, and empowers site builders and content creators by allowing for the customization of both heading levels and heading styles when block types are configured and when block instances are placed via Layout Builder.
Users are hereby warned that using this module "out of the box" may not make for a generalized solution for all use cases.
Setting up the module
Installation
Install this module via composer.
composer require drupal/layout_builder_block_headings
Configuration
- Navigate to a block type.
-
Add a text field for the heading text, or choose a pre-existing field of choice.
You might consider making this field formatted text to allow for certain invaluable HTML tags such as<wbr>! The amazing Allowed Formats module can make for a very safe and robust editorial experience! - Add a text list field for the heading level. The option values should be limited to a subset of
h1,h2,h3,h4,h5, andh6. Pick allowed values that jive with your theme! For example, it's highly unlikely thath1is a valid heading level for content creators to choose!
See Create a field type for "heading level" to track progress on making this safer! - Add a text list field for the heading style. The options can be anything under the sun. Hopefully you have a snazzy design system to plug in?
See Add support for adding multiple heading styles to track progress on making this more robust! - Head over to the block type edit form and configure the fields and customization options:
Overriding reusable block fields
When adding a reusable block to a layout, depending on how the block type is configured, one or more customization options may now appear.
Advanced configuration
This module can support an infinite number of different heading, heading level, and heading style configurations on a per-block-type basis. It is not uncommon to provide different options for different blocks.
How are you using this module? I'd love to hear about it! Hit me up in slack, I'm lleber.
Ask your assistant about Layout Builder Block Headings
Check compatibility with your Drupal and PHP version, maintenance and security coverage, from current release data. How it works
Depends on
Dependencies of the latest stable release
- block_content Drupal core
- layout_builder Drupal core
- options Drupal core
- text Drupal core
Required by
Tracked projects that depend on this one
No tracked projects depend on this one yet.