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.

This module is a work in progress and may be very opinionated with help text!

Users are hereby warned that using this module "out of the box" may not make for a generalized solution for all use cases.

There are no backwards-compatibility guarantees until an RC or greater release emerge! Use at your own risk (and only for development purposes)!

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, and h6. Pick allowed values that jive with your theme! For example, it's highly unlikely that h1 is 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.

RTBC issues for Layout Builder Block Headings

Filters