This module adds configuration options to Drupal layouts, allowing users to add attributes like IDs, custom classes, or attach libraries to layouts and their regions. These options can be defined and managed primarily through YAML files, reducing the need for custom code.
This module provides a Layout plugin that allows configuration options to easily be added to layouts using YAML files and LayoutOption plugins. In most cases, using no code just YAML files.
Project overview
Layouts defined in *.layouts.yml files that use the LayoutOptions class provided by this module can then add configuration options using a combination of *.layout_option.yml files and LayoutOption plugins.
The module supplies a set of common LayoutOption plugins.
Some no code examples of configuration options that this module can be built with just Yaml files and the supplied default plugins are:
- Adding an id attribute to allow anchor references to content.
- Adding a set of predefined classes users can apply to the layout or it's regions.
- Allowing custom classes to be added.
- Attaching libraries to a layout
UI Suite
UI Suite provides a cohesive set of modules to implement full design systems while preserving and improving the Drupal site building experience.
Layout Options was part of UI Suite from March 2020 to October 2024. We are now recommending using SDC components & UI Patterns 2.x.
Showcase
UI Suite themes are all using Layout Options:
Bootstrap 4 & 5 Material Design 2 Mozilla Protocol See layout_options.yml See layout_options.yml See layout_options.yml DSFR (French Gov) USWDS (US Gov) Zurb Foundation See layout_options.yml See layout_options.yml See layout_options.ymlAsk your assistant about Layout Options
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
- layout_discovery Drupal core
Required by
1 tracked project depends on this one
- DROWL Layouts for Bootstrap 2 sites