Articles

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

Drupal dispose d’un puissant système de gestion des images qui permet de créer des styles d’image, lesquels peuvent appliquer différents effets aux images et générer des dérivés de l’image source.

De nombreux développeurs préfèrent stocker les codes d’en-tête et de pied de page dans un fichier séparé et inclure ce fichier dans page.html.twig.

Processus

Supposons que vous avez créé le fichier suivant dans le dossier de votre thème pour l’en-tête :

THEME_NAME/templates/includes/header.html.twig

Et maintenant, vous souhaitez inclure ce fichier dans :