https://github.com/MatTheCat/twig-whitespace-collapse-extension

Extension Twig fusionnant les espaces des nœuds texte avant la compilation
https://github.com/MatTheCat/twig-whitespace-collapse-extension

Last synced: 21 days ago
JSON representation

Extension Twig fusionnant les espaces des nœuds texte avant la compilation

• Host: GitHub
• URL: https://github.com/MatTheCat/twig-whitespace-collapse-extension
• Owner: MatTheCat
• License: mit
• Archived: true
• Created: 2015-11-12T12:37:27.000Z (over 8 years ago)
• Default Branch: master
• Last Pushed: 2017-08-01T09:51:19.000Z (almost 7 years ago)
• Last Synced: 2023-10-05T14:08:48.436Z (8 months ago)
• Language: PHP
• Homepage:
• Size: 12.7 KB
• Stars: 3
• Watchers: 1
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-twig - Whitespace Collapse - Whitespace collapse extension for Twig (Twig / Extensions)
• awesome-twig - Whitespace Collapse - Whitespace collapse extension for Twig (Twig / Extensions)

README

        
# Twig Whitespace Collapse Extension

Cette extension fusionne les espaces, tabulations et sauts de ligne des nœuds texte Twig avant la compilation,

ce qui permet de réduire le poids du contenu généré tout en gardant le code lisible et sans impact sur le temps

d’exécution.

Par exemple le code suivant

```twig

{# base.html.twig #}

    

        

        test

        

    

    

    

```

sera rendu comme

```html

   test    

```

## Activation

Cette extension s’ajoute à Twig comme n’importe quelle autre extension.

```php

addExtension(new \MatTheCat\Twig\Extension\WhitespaceCollapser());

```

ou si vous êtes sous Symfony par exemple

```yaml

twig.extension.whitespace_collapser:

    class: MatTheCat\Twig\Extension\WhitespaceCollapser

    tags:

        - { name: twig.extension }

```

## Configuration

Le comportement de l’extension dépend du paramètre passé à son constructeur.

Par défaut ce dernier vaut `['html', 'xml', 'svg']`, ce qui active l’extension

pour les templates dont l’extension du fichier est *html*, *html.twig*, *xml*, *xml.twig*,

*svg* ou *svg.twig*.

Vous pouvez donc passer un tableau d’extension ou encore un booléen qui activera l’extension

pour tous les templates, ou la désactivera.

## Tag

L’extension définit également le tag `whitespacecollapse` qui avec un booléen en paramètre permet

d’activer ou désactiver l’extension à l’intérieur d’un template.

Par exemple

```twig

    

        {% whitespacecollapse false %}

            

            test

            

        {% endwhitespacecollapse %}

    

    

    

```

sera rendu comme

```html

              

            test

            

           

```

## :warning: Attention

L’extension fusionne *toute* suite de plus d’un espace, ce qui correspond au cas général

mais peut être destructif dans les cas suivants :

- élément dont la propriété `white-space` vaut `pre`, `pre-wrap` ou `pre-line`

- texte d’éléments de formulaire

- attributs `data-*`

Outre `{% whitespacecollapse false %}`, vous pouvez également rendre le code concerné avec Twig

pour éviter cela. Par exemple

```twig

data-example="{{ 'i  like  spaces' }}"

```