Pour savoir quel template génère le balisage pour un élément donné, vous pouvez utiliser l’option intégrée debug de Twig. Ce paramètre affichera des commentaires HTML avec la sortie affichée, incluant les hooks de thème utilisés, les suggestions de noms de fichiers de template, ainsi que le fichier Twig exact utilisé pour rendre une section spécifique de votre balisage.

Les filtres dans Twig peuvent être utilisés pour modifier des variables. Les filtres sont séparés de la variable par le symbole pipe. Ils peuvent avoir des arguments optionnels entre parenthèses. Plusieurs filtres peuvent être chaînés. La sortie d'un filtre est appliquée au suivant.

Exemple :

{{ content|safe_join(", ")|lower }}

Il se peut que vous deviez rendre un élément avant de l'appliquer à un filtre :

Twig fournit plusieurs fonctions utiles que vous pouvez utiliser directement dans les templates.

Liste des fonctions Twig

Le cœur Drupal ajoute plusieurs fonctions personnalisées spécifiques à Drupal. Elles sont définies dans la classe TwigExtension.

D’après la documentation officielle de Twig : « Les macros sont comparables aux fonctions dans les langages de programmation classiques. Elles sont utiles pour placer des idiomes HTML fréquemment utilisés dans des éléments réutilisables, afin d’éviter les répétitions ».

Pour rendre la thématisation Drupal 8 aussi performante que possible et offrir plus de possibilités de personnalisation dans les templates Twig, suivez les recommandations suivantes :

L’idée générale dans Drupal 8 est que vous souhaitez éviter de créer du HTML directement dans le code PHP de votre module personnalisé. Vous voulez que cela soit géré via des templates Twig. Pour créer de nouveaux templates Twig dans votre module, suivez les étapes suivantes.

Les templates Twig peuvent être étendus en utilisant la syntaxe suivante :

{% extends 'html.twig' %}

Pour plus de détails, consultez https://symfony.com/doc/current/templates.html#template-inheritance-and-layouts

Les sous-thèmes, comme tout autre thème, ont une différence : ils héritent des ressources du thème parent. Il n’y a aucune limite dans la chaîne reliant les sous-thèmes à leurs parents. Un sous-thème peut être enfant d’un autre sous-thème, et il peut être ramifié et organisé selon vos besoins.

Classy est le thème de base principal de Drupal 8 et le thème de base utilisé par Bartik et Seven. Le balisage HTML trouvé dans Classy (et ses sous-thèmes) contient des classes CSS structurées d’une manière similaire aux conventions de nommage CSS BEM et SMACSS.

Documentez tous les sélecteurs de classes CSS présents dans le thème Classy Drupal8 RC 2

format :

.foo { }
.foo-bar { }

filename.html.twig / filename.css