{"title":"Surcharge des gabarits","version":"4.2","locale":"fr","docname":"howto/overriding-templates","url":"/fr/4.2/howto/overriding-templates/","canonical":"https://djangodocs.dev/fr/4.2/howto/overriding-templates/","summary":"Dans votre projet, vous pourriez vouloir surcharger un gabarit d’une autre application Django, que ce soit une application tierce ou une application « contrib »…","html":"

Surcharge des gabaritsLien vers cette rubrique#

\n

Dans votre projet, vous pourriez vouloir surcharger un gabarit d’une autre application Django, que ce soit une application tierce ou une application « contrib » telle que django.contrib.admin. Vous pouvez soit placer les gabarits surchargés dans le répertoire des gabarits de votre projet, ou les placer dans le répertoire de gabarits d’une application.

\n

Si vous avez à la fois des gabarits surchargés dans les répertoires du projet et d’une application, le chargeur de gabarits par défaut de Django va essayer de charger le gabarit en commençant par le répertoire du projet. En d’autres termes, la recherche dans DIRS est prioritaire par rapport à APP_DIRS.

\n\n
\n

Surcharge à partir du répertoire des gabarits du projetLien vers cette rubrique#

\n

Tout d’abord, nous allons examiner la surcharge des gabarits en créant les gabarits à remplacer dans le répertoire des gabarits de votre projet.

\n

Admettons que vous essayiez de surcharger les gabarits d’une application tierce appelée blog, qui fournit les gabarits blog/post.html et blog/list.html. Les réglages appropriés du projet ressembleraient à

\n
Code
from pathlib import Path\n\nBASE_DIR = Path(__file__).resolve().parent.parent\n\nINSTALLED_APPS = [\n    ...,\n    "blog",\n    ...,\n]\n\nTEMPLATES = [\n    {\n        "BACKEND": "django.template.backends.django.DjangoTemplates",\n        "DIRS": [BASE_DIR / "templates"],\n        "APP_DIRS": True,\n        # ...\n    },\n]\n
\n

Le réglage TEMPLATES et BASE_DIR existent déjà si vous avez créé votre projet à partir du modèle de projet par défaut. Le réglage devant être modifié est DIRS.

\n

Ces réglages supposent qu’un répertoire templates se trouve à la racine du projet. Pour surcharger les gabarits de l’application blog, créez un dossier dans le répertoire templates et ajoutez les fichiers de gabarit dans ce dossier :

\n
None
templates/\n    blog/\n        list.html\n        post.html\n
\n

Le chargeur de gabarits cherche d’abord les gabarits dans le répertoire DIRS. Lorsque les vues de l’application blog demanderont les gabarits blog/post.html et blog/list.html, le chargeur renverra les fichiers que vous venez de créer.

\n
\n
\n

Surcharge à partir du répertoire des gabarits d’une applicationLien vers cette rubrique#

\n

Comme vous surchargez des gabarits situés en dehors des applications de votre projet, il est plus courant d’utiliser la première méthode et de placer les gabarits à surcharger dans le dossier des gabarits du projet. Cependant, si vous préférez placer ces gabarits dans le répertoire des gabarits d’une application, c’est aussi possible.

\n

Commencez par vous assurer que les réglages des gabarits sont configurés pour rechercher dans les répertoires des applications

\n
Code
TEMPLATES = [\n    {\n        # ...\n        "APP_DIRS": True,\n        # ...\n    },\n]\n
\n

Si vous souhaitez placer les gabarits surchargés dans une application nommée myapp et que les gabarits à surcharger sont nommés blog/list.html et blog/post.html, votre structure de répertoires ressemblera à :

\n
None
myapp/\n    templates/\n        blog/\n            list.html\n            post.html\n
\n

Lorsque APP_DIRS vaut True, le chargeur de gabarits recherche dans les répertoires de gabarits des applications et va donc trouver ces gabarits.

\n
\n
\n

Extension d’un gabarit surchargéLien vers cette rubrique#

\n

Lorsque les chargeurs de gabarits sont configurés, vous pouvez étendre un gabarit en utilisant la balise de gabarit {% extends %} tout en le surchargeant en même temps. Cela peut vous permettre de faire de petites personnalisations sans avoir besoin de réécrire le gabarit en entier.

\n

Par exemple, vous pouvez utiliser cette technique pour ajouter un logo personnalisé au gabarit admin/base_site.html:

\n
\n
templates/admin/base_site.html
\n
Django template
 {% extends "admin/base_site.html" %}\n\n {% block branding %}\n     <img src="link/to/logo.png" alt="logo">\n     {{ block.super }}\n {% endblock %}\n
\n
\n

Points clés à relever :

\n\n

Cette technique fonctionne car le chargeur de gabarits ne considère pas le gabrit surchargé déjà chargé (à templates/admin/base_site.html) lorsqu’il résoud la balise extends. Combiné à block.super, c’est une technique puissante pour appliquer de petits ajustements.

\n
","rootId":"how-to-override-templates","toc":[{"title":"Surcharge à partir du répertoire des gabarits du projet","anchor":"overriding-from-the-project-s-templates-directory","children":[]},{"title":"Surcharge à partir du répertoire des gabarits d’une application","anchor":"overriding-from-an-app-s-template-directory","children":[]},{"title":"Extension d’un gabarit surchargé","anchor":"extending-an-overridden-template","children":[]}],"breadcrumbs":[{"docname":"howto/index","title":"Guides pratiques","url":"/fr/4.2/howto/"}],"prev":{"docname":"howto/outputting-pdf","title":"Création de fichiers PDF","url":"/fr/4.2/howto/outputting-pdf/"},"next":{"docname":"howto/static-files/index","title":"Gestion des fichiers statiques (par ex. images, JavaScript, CSS)","url":"/fr/4.2/howto/static-files/"},"formats":{"html":"/fr/4.2/howto/overriding-templates/","markdown":"/fr/4.2/howto/overriding-templates.md","json":"/fr/4.2/howto/overriding-templates.json"},"source":"https://github.com/django/django/blob/stable/4.2.x/docs/howto/overriding-templates.txt","official":"https://docs.djangoproject.com/fr/4.2/howto/overriding-templates/","inVersions":["6.1","6.0","5.2","5.1","5.0","4.2","4.1","4.0","3.2","3.1","3.0","2.2","2.1","2.0","1.11"],"inLocales":["en","zh-hans","fr","ja","id","it","pt-br","ko","es","el","pl"]}