PHPackages                             studiometa/twig-toolkit - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. studiometa/twig-toolkit

ActiveLibrary

studiometa/twig-toolkit
=======================

A set of useful extension and components for Twig.

2.1.1(11mo ago)1135.2k↓25.9%[2 issues](https://github.com/studiometa/twig-toolkit/issues)2MITPHPPHP ^8.1CI passing

Since Jan 31Pushed 11mo ago9 watchersCompare

[ Source](https://github.com/studiometa/twig-toolkit)[ Packagist](https://packagist.org/packages/studiometa/twig-toolkit)[ RSS](/packages/studiometa-twig-toolkit/feed)WikiDiscussions develop Synced 1mo ago

READMEChangelog (10)Dependencies (7)Versions (23)Used By (2)

studiometa/twig-toolkit
=======================

[](#studiometatwig-toolkit)

[![Packagist Version](https://camo.githubusercontent.com/8b97dee3aaadb59748daa9d6039d70ef05b2c15a1b2a502b56b9e26eb6caeda2/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f73747564696f6d6574612f747769672d746f6f6c6b69743f7374796c653d666c617426636f6c6f72423d33653633646426636f6c6f72413d343134383533266c6162656c3d7061636b6167697374)](https://packagist.org/packages/studiometa/twig-toolkit)[![Downloads](https://camo.githubusercontent.com/3e37938b18ce07ecba938cc1f71e8a0d6dd0fd548a0d830ff0af67f7fbc3b36a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f73747564696f6d6574612f747769672d746f6f6c6b69743f7374796c653d666c617426636f6c6f72423d33653633646426636f6c6f72413d343134383533)](https://packagist.org/packages/studiometa/twig-toolkit)[![Dependency Status](https://camo.githubusercontent.com/07e7dbb0f7884f24340ee60478d19a156cb88fdd260d97945fe15beebb0c40d0/68747470733a2f2f696d672e736869656c64732e696f2f6c6962726172696573696f2f6769746875622f73747564696f6d6574612f747769672d746f6f6c6b69743f7374796c653d666c617426636f6c6f72423d33653633646426636f6c6f72413d343134383533)](https://packagist.org/packages/studiometa/twig-toolkit)[![Codecov](https://camo.githubusercontent.com/d56da959cc30670536c9d2bbfdff8ba7d7d61778640b45bbfaa99776e132a4a8/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f73747564696f6d6574612f747769672d746f6f6c6b69743f7374796c653d666c617426636f6c6f72423d33653633646426636f6c6f72413d343134383533)](https://camo.githubusercontent.com/d56da959cc30670536c9d2bbfdff8ba7d7d61778640b45bbfaa99776e132a4a8/68747470733a2f2f696d672e736869656c64732e696f2f636f6465636f762f632f6769746875622f73747564696f6d6574612f747769672d746f6f6c6b69743f7374796c653d666c617426636f6c6f72423d33653633646426636f6c6f72413d343134383533)[![License MIT](https://camo.githubusercontent.com/db54a58bc54f0b8e528c3b68d3d6b6d268470878b36c16c5f948873ccfaa5913/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f73747564696f6d6574612f747769672d746f6f6c6b69743f7374796c653d666c617426636f6c6f72423d33653633646426636f6c6f72413d343134383533)](https://github.com/studiometa/twig-toolkit/blob/master/LICENSE)

> A set of useful extension and components for Twig.

Installation
------------

[](#installation)

```
composer require studiometa/twig-toolkit
```

Usage
-----

[](#usage)

Add the `Studiometa\TwigToolkit\Extension` to your Twig instance:

```
$loader = new \Twig\Loader\FilesystemLoader();
$twig = new \Twig\Environment($loader);
$twig->addExtension(new \Studiometa\TwigToolkit\Extension());
```

Reference
---------

[](#reference)

### Functions

[](#functions)

#### `{{ html_classes() }}`

[](#-html_classesclasses-)

A function to manage classes more easily.

**Params**

- `classes` (`String | Array | Object`)

**Examples**

```
{# The following examples will render the same HTML #}

{# HTML #}

```

#### `{{ html_styles() }}`

[](#-html_stylesstyles-)

A function to manage style attributes more easily.

**Params**

- `styles` (`Object`)

**Examples**

```

```

#### `{{ html_attributes() }}`

[](#-html_attributesattrs-)

A function to render HTML attributes more easily with the following features:

- The `class` attribute will automatically be processed by the `class` method described above
- Array and objects will be converted to JSON
- Attributes keys will be converted from any format to kebab-case
- Values will be escaped to prevent XSS attacks

**Params**

- `attrs` (`Object`): The attributes to render

**Examples**

```

{# HTML #}

```

#### `{{ merge_html_attributes(attr, default_attr, required_attr) }}`

[](#-merge_html_attributesattr-default_attr-required_attr-)

Merge HTML attributes smartly, useful to define default and required attributes at the component level and allow users to add custom ones.

This filter can also be used as a function.

**Params**

- `attr` (`Object`): The user provided attributes
- `default` (`Object`): The default attributes
- `required` (`Object`): The required attributes

**Examples**

You can define default and required attributes in a component's template:

```
{#
/**
 * @file
 * component
 *
 * @param array $attr
 *   Custom attributes to apply to the root element.
 */
#}

{% set default_attributes = { class: 'bar' } %}
{% set required_attributes = { data_component: 'Component' } %}

{# Merge all attributes #}
{% set attributes = merge_html_attributes(attr, default_attributes, required_attributes)}

{# or #}
{% html_element 'div' with attributes %}
```

And then include your component with custom attributes:

```
{% include 'component.twig' with {
  attr: {
    class: 'mb-10',
    aria_hidden: 'true'
  }
} %}
```

You can take advantage of [named arguments](http://twig.symfony.com/doc/3.x/templates.html#named-arguments) to avoid passing a value for the default attributes argument:

```
{% set required_attributes = { id: 'block' } %}
{% set merged_attributes = merge_html_attributes(attr, required=required_attribute) %}
```

#### `{{ twig_toolkit_url(string) }}`

[](#-twig_toolkit_urlstring-)

Wrapper for the `Spatie\Url\Url` class to easily manipulate URLs. See the [`spatie/url` documentation](https://github.com/spatie/url) for details on its API.

**Params**

- `url` (`string`): The URL to parse for manipulation

**Examples**

```
{# Change host #}
{% set url = twig_toolkit_url(url).withHost('cdn.fqdn.com') %}

{# Change/add query parameters #}
{% set url = twig_toolkit_url(url).withQueryParameter('key', 'value') %}
```

### Filters

[](#filters)

#### `{{ object|twig_toolkit_without('key', 'other_key') }}`

[](#-objecttwig_toolkit_withoutkey-other_key-)

Returns the given hash without the specified keys.

**Params**

- `value` (`array`): the hash to remove the key from
- `...keys` (`string[]`): the keys to remove

**Examples**

```
{# Twig #}
{{ { foo: 1, bar: 2, baz: 3 }|twig_toolkit_without('bar')|keys|join(', ') }}

{# HTML #}
foo, baz
```

### Tags

[](#tags)

#### `{% html_element '' with attrs %}`

[](#-html_element-tag-with-attrs-)

Render an HTML element with the given attributes. Useful to avoid setting dynamic HTML element tags with the `...` pattern.

**Params**

- `tag` (`String`): The name of the tag
- `attrs` (`Object`): An object describing the element's attribues

**Examples**

```
{# Twig #}
{% html_element 'h1' with { class: 'block' } %}
  Hello world
{% end_html_element %}

{# HTML #}

  Hello world

```

###  Health Score

46

—

FairBetter than 93% of packages

Maintenance48

Moderate activity, may be stable

Popularity34

Limited adoption so far

Community18

Small or concentrated contributor base

Maturity71

Established project with proven stability

 Bus Factor1

Top contributor holds 93.1% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~99 days

Recently: every ~66 days

Total

17

Last Release

334d ago

Major Versions

1.3.7 → 2.0.02025-01-20

PHP version history (3 changes)1.0.0PHP >=7.0

1.1.0PHP ^7.3|^8.0

2.0.0PHP ^8.1

### Community

Maintainers

![](https://www.gravatar.com/avatar/7e88435dae9fed57464c2668f35d4c7dd7f874e55e9727972369538d639d6373?d=identicon)[titouanmathis](/maintainers/titouanmathis)

---

Top Contributors

[![titouanmathis](https://avatars.githubusercontent.com/u/250145?v=4)](https://github.com/titouanmathis "titouanmathis (162 commits)")[![perruche](https://avatars.githubusercontent.com/u/11503190?v=4)](https://github.com/perruche "perruche (11 commits)")[![renovate-bot](https://avatars.githubusercontent.com/u/25180681?v=4)](https://github.com/renovate-bot "renovate-bot (1 commits)")

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/studiometa-twig-toolkit/health.svg)

```
[![Health](https://phpackages.com/badges/studiometa-twig-toolkit/health.svg)](https://phpackages.com/packages/studiometa-twig-toolkit)
```

###  Alternatives

[sonata-project/entity-audit-bundle

Audit for Doctrine Entities

644989.8k1](/packages/sonata-project-entity-audit-bundle)[abydahana/aksara

Aksara is a CodeIgniter based CRUD Toolkit you can use to build complex applications become shorter, secure and more reliable just in a few lines of code. Serving both CMS or Framework, produce both HEADLESS (RESTful API) or TRADITIONAL (Browser Based), just by writing single controller. Yet it's reusable, scalable and ready to use!

1101.2k](/packages/abydahana-aksara)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)