UI Controls

Visual controls for Display Builder on top of UI Styles and UI Patterns forms: a spacing box, color swatches, button groups, column presets and variant axes instead of long lists of classes and raw props.

Controls are mapped per theme in config, so the module has no dependency on any theme.
Display Builder recipes ship the mapping of their theme, such as the Display Builder Bootstrap recipe for UI Suite Bootstrap.

Proof of concept. APIs and config may change without notice.

Requirements

• Drupal 11.4 or later
• UI Patterns 2.0.23 or later
• UI Styles

Installation

Install as you would normally install a contributed Drupal module. See Installing Modules for further information.

Enable ui_controls_display_builder to use the controls in Display Builder 1.0.0-beta9 or later. UI Controls 1.1 does not install with an older Display Builder.

Configuration

A mapping is a ui_controls.mapping.THEME config entity, edited as YAML for now. It names the styles and component props each control drives.
The mapping of the default theme is used, falling back to its base themes, even when the form is rendered with the admin theme.
Saving a mapping logs its mistakes as warnings. See Writing a mapping, which also covers using a recipe's mapping without the recipe.

In Display Builder, the "Show visual controls" setting of the Styles and Config islands turns their controls on or off per profile.
Off leaves the plain UI Styles or UI Patterns form, writing the same values.

Maintainers

• Jean Valverde - mogtofu33

Support

Support my open source work on Liberapay. Need a feature, a fix or help on your project? I take sponsored work and freelance missions: contact me.