Twig Toolkit

Twig Toolkit for Drupal integrates the studiometa/twig-toolkit library with Drupal’s Twig layer. It provides ergonomic helpers for composing HTML classes, attributes, and inline styles, plus a Drupal-compatible html_element tag that works with Drupal Attribute objects.

Features

• Exposes Twig Toolkit’s Twig helpers in Drupal templates:
  • html_classes() for building class attributes from strings/arrays/objects.
  • html_styles() for building inline style attributes from key/value maps.
  • html_attributes() and merge_html_attributes() for rendering and
    merging attributes safely and consistently.
  • {% html_element %}...{% end_html_element %} for rendering elements with
    dynamic tags and complex attributes.
• Drupal compatibility for attribute handling:
  • Automatically converts Drupal \Drupal\Core\Template\Attribute objects to
    arrays for use with Twig Toolkit.
• Useful for component-driven theming, design systems, and templates that need clean, reusable
  attribute composition.

Post-Installation

After enabling the module, the functions/filters/tag are immediately available in Twig templates. There is no configuration form. Use it directly in your theme/module templates to build attributes and render elements. Clear caches after enabling (e.g. drush cr).

Additional Requirements

• Requires the PHP library
  studiometa/twig-toolkit
  (typically installed via Composer).
• No additional Drupal modules are required beyond Drupal core.

Recommended modules/libraries

• No specific recommendations. This module is most useful alongside component-based theming approaches and reusable Twig components.

Similar projects

• Twig Tweak: offers many Drupal-specific Twig utilities, but is broader in
  scope. This module focuses on integrating the Twig Toolkit attribute/class/style helpers and
  html_element tag.
• Drupal’s core Attribute API: provides attribute objects; this module
  complements it with ergonomic composition helpers and a convenient element-rendering tag.

Supporting this Module

If you’d like to support upstream development of the underlying library, consider following and supporting the authors of studiometa/twig-toolkit.

Community Documentation

• Upstream reference and examples: studiometa/twig-toolkit.