Surcharger les modèles DXPR Builder.

Apprendre DXPR BuilderGérer le siteAux couleurs de votre marque

DXPR Builder rend ses éléments dans le navigateur, depuis des modèles compilés dans l’éditeur. Il n’y a aucun modèle d’élément à copier dans un thème. Le module livre quatre modèles Twig pour ses propres pages, et vous les surchargez de la façon Drupal normale. Cette page les liste, explique pourquoi le balisage des éléments ne peut pas être surchargé, et pointe vers les chemins que le module prend en charge.

Modèles Twig surchargeables

Les modèles vivent dans le dossier templates/ du module :

Modèle Utilisé pour Variables
dxpr-license-info.html.twig Le résumé d’usage sur les pages User Licenses et Content items, et le bloc License info correspondant used_count, total_count, limit, block_label, total_label, used_label, more_info_link
page--dxpr-builder--media-library.html.twig L’enveloppe de page du dialogue de médiathèque sous /dxpr_builder/media-library les variables page standard
html--dxpr-builder--media-library.html.twig L’enveloppe <html> du même dialogue les variables html standard
page--people-list.html.twig Un point de départ pour la page People (/admin/people) avec un résumé de licence les variables page standard plus user_license

Les trois premiers marchent tels quels. Drupal ne charge pas page--people-list.html.twig depuis le module. DXPR Builder ajoute seulement la suggestion page__people_list et la variable user_license sur la page People. Pour y montrer le résumé, copiez le fichier dans votre thème d’admin.

Pour surcharger un modèle :

  1. Copiez le fichier depuis modules/contrib/dxpr_builder/templates/ dans le dossier templates/ du thème qui le rend. Les pages d’admin et le dialogue de médiathèque utilisent le thème d’admin. Le bloc License info utilise le thème de la région où vous l’avez placé.
  2. Modifiez la copie.
  3. Videz les caches avec drush cr.

Pourquoi le balisage des éléments ne peut pas être surchargé

Le balisage de chaque élément est un modèle twig.js dans dxpr_builder/templates/, par exemple elements/alert/alert.twig.html. Le build compile ces modèles dans dxpr_builder/dxpr_templates.js. L’éditeur les rend dans le navigateur et enregistre le HTML résultant dans le champ. Deux choses s’ensuivent :

  • Un modèle changé exige une reconstruction de l’éditeur. Les sites qui chargent l’éditeur depuis le CDN DXPR ne peuvent pas du tout utiliser un modèle changé.
  • Les pages enregistrées gardent le HTML avec lequel elles ont été enregistrées. Un nouveau modèle n’affecte que les éléments rendus après le changement.

Le module n’offre donc aucune surcharge par site des modèles d’élément. Utilisez l’un des chemins ci-dessous.

Chemins de personnalisation pris en charge

Objectif Chemin
Mises en page réutilisables pour les contributeurs Modèles de page et Modèles d’utilisateur, tous deux choisis dans le builder
Changer l’aspect des éléments CSS personnalisé dans le thème, visant vos propres classes ou les classes az-* fournies
Donner aux contributeurs des styles nommés Classes utilitaires depuis le .info.yml du thème, et styles personnalisés pour l’éditeur de texte
Jeux d’icônes supplémentaires Bibliothèques d’icônes
Nouveaux types d’éléments Créer des éléments personnalisés

Et ensuite ?