{"title":"Mise à jour des gabarits pour Django 1.8","version":"1.11","locale":"fr","docname":"ref/templates/upgrading","url":"/fr/1.11/ref/templates/upgrading/","canonical":"https://djangodocs.dev/fr/1.11/ref/templates/upgrading/","summary":"Le système des gabarits de Django a été retravaillé dans Django 1.8 afin de pouvoir accepter plusieurs moteurs de gabarit. Ce document complète les notes de…","html":"

Mise à jour des gabarits pour Django 1.8Lien vers cette rubrique#

\n

Le système des gabarits de Django a été retravaillé dans Django 1.8 afin de pouvoir accepter plusieurs moteurs de gabarit. Ce document complète les notes de publication avec des instructions de mise à jour détaillées sur certains sujets.

\n
\n

Les réglages TEMPLATESLien vers cette rubrique#

\n

Un nouveau réglage a été introduit dans Django 1.8 : TEMPLATES. Tous les réglages existants liés aux gabarits ont été rendus obsolètes.

\n

Durant la période d’obsolescence, Django crée un réglage TEMPLATES rétrocompatible sur la base des réglages TEMPLATE_* si vous ne l’avez pas fait vous-même.

\n

Voici comment définir TEMPLATES dans votre module de réglages.

\n

Si vous utilisez la valeur par défaut de TEMPLATE_LOADERS, c’est-à-dire s’il n’est pas défini dans vos réglages ou qu’il est défini comme :

\n
Code
['django.template.loaders.filesystem.Loader',\n 'django.template.loaders.app_directories.Loader']\n
\n

voici alors comment définir TEMPLATES:

\n
Code
TEMPLATES = [\n    {\n        'BACKEND': 'django.template.backends.django.DjangoTemplates',\n        'DIRS': [\n            # insert your TEMPLATE_DIRS here\n        ],\n        'APP_DIRS': True,\n        'OPTIONS': {\n            'context_processors': [\n                # Insert your TEMPLATE_CONTEXT_PROCESSORS here or use this\n                # list if you haven't customized them:\n                'django.contrib.auth.context_processors.auth',\n                'django.template.context_processors.debug',\n                'django.template.context_processors.i18n',\n                'django.template.context_processors.media',\n                'django.template.context_processors.static',\n                'django.template.context_processors.tz',\n                'django.contrib.messages.context_processors.messages',\n            ],\n        },\n    },\n]\n
\n

Si vous n’utilisez pas la valeur par défaut de TEMPLATE_LOADERS, voici comment vous devez définir TEMPLATES:

\n
Code
TEMPLATES = [\n    {\n        'BACKEND': 'django.template.backends.django.DjangoTemplates',\n        'DIRS': [\n            # insert your TEMPLATE_DIRS here\n        ],\n        'OPTIONS': {\n            'context_processors': [\n                # Insert your TEMPLATE_CONTEXT_PROCESSORS here or use this\n                # list if you haven't customized them:\n                'django.contrib.auth.context_processors.auth',\n                'django.template.context_processors.debug',\n                'django.template.context_processors.i18n',\n                'django.template.context_processors.media',\n                'django.template.context_processors.static',\n                'django.template.context_processors.tz',\n                'django.contrib.messages.context_processors.messages',\n            ],\n            'loaders': [\n                # insert your TEMPLATE_LOADERS here\n            ]\n        },\n    },\n]\n
\n

De plus, vous devez remplacer django.core.context_processors par django.template.context_processors dans les noms des processeurs de contexte.

\n

Si votre module de réglages définit ALLOWED_INCLUDE_ROOTS ou TEMPLATE_STRING_IF_INVALID, incluez leur valeur dans les clés “allowed_include_roots”` et 'string_if_invalid' du dictionnaire 'OPTIONS'.

\n

Si le réglage TEMPLATE_DEBUG contient une valeur différente de DEBUG, incluez sa valeur dans la clé 'debug' du dictionnaire 'OPTIONS'.

\n

Après avoir défini TEMPLATES, vous pouvez sans problème supprimer ALLOWED_INCLUDE_ROOTS, TEMPLATE_CONTEXT_PROCESSORS, TEMPLATE_DEBUG, TEMPLATE_DIRS, TEMPLATE_LOADERS et TEMPLATE_STRING_IF_INVALID.

\n

Si vous surchargez certains de ces réglages dans des tests, il est nécessaire de surcharger maintenant la totalité de TEMPLATES.

\n
\n
\n

django.template.loaderLien vers cette rubrique#

\n
\n

get_template() et select_template()Lien vers cette rubrique#

\n

Dans Django 1.8, get_template() et select_template() renvoient un objet Template dépendant du moteur au lieu de django.template.Template.

\n

Par exemple, si get_template() charge un gabarit avec un moteur DjangoTemplates, c’est un objet django.template.backends.django.Template qui est renvoyé.

\n

Les objets Template doivent fournir une méthode render() dont la signature diffère légèrement de la méthode render() du langage de gabarit de Django.

\n

Au lieu de :

\n
Code
from django.template import Context\nfrom django.template.loader import get_template\n\ntemplate = get_template('hello.html')\nhtml = template.render(Context({'name': 'world'}))\n
\n

Vous devriez écrire :

\n
Code
from django.template.loader import get_template\n\ntemplate = get_template('hello.html')\nhtml = template.render({'name': 'world'})\n
\n

Et au lieu de :

\n
Code
from django.template import RequestContext\nfrom django.template.loader import get_template\n\ntemplate = get_template('hello.html')\nhtml = template.render(RequestContext(request, {'name': 'world'}))\n
\n

Vous devriez écrire :

\n
Code
from django.template.loader import get_template\n\ntemplate = get_template('hello.html')\nhtml = template.render({'name': 'world'}, request)\n
\n

La transmission d’un Context ou d’un RequestContext est toujours possible lorsque le gabarit est chargé par un moteur DjangoTemplates, mais cette possibilité est obsolète et ne sera plus prise en charge dans Django 1.10.

\n

Si vous chargez un gabarit lorsque vous êtes en train de produire un autre gabarit avec le langage de gabarit de Django et que vous avez accès au contexte courant, par exemple dans la méthode render() d’une balise de gabarit, vous pouvez utiliser le moteur Engine actuel directement. Au lieu de :

\n
Code
from django.template.loader import get_template\ntemplate = get_template('included.html')\n
\n

Vous pouvez écrire :

\n
Code
template = context.template.engine.get_template('included.html')\n
\n

Cela va charger le gabarit avec le moteur actuel sans faire appel à la machinerie des moteurs de gabarits multiples, ce qui est généralement le comportement souhaité. Au contraire des solutions précédentes, ceci renvoie un objet django.template.Template, comme le faisait get_template() dans les versions de Django jusqu’à 1.7, ce qui évite tout problème de rétrocompatibilité.

\n
\n
\n

get_template_from_string()Lien vers cette rubrique#

\n

L’API privée get_template_from_string(template_code) a été supprimée dans Django 1.8 parce qu’il n’était pas possible de choisir un moteur pour compiler le gabarit.

\n

Trois alternatives sont disponibles.

\n

Si vous contrôlez les réglages du projet, vous pouvez utiliser l’un des moteurs configurés :

\n
Code
from django.template import engines\n\ntemplate = engines['django'].from_string(template_code)\n
\n

Cela renvoie un objet Template dépendant du moteur.

\n

Pour les gabarits simplistes qui n’ont pas besoin de processeur de contexte ni aucune autre spécialité, vous pouvez créer un moteur élémentaire et utiliser sa méthode from_string():

\n
Code
from django.template import Engine\n\ntemplate = Engine().from_string(template_code)\n
\n

Cela renvoie un django.template.Template car Engine fait partie de l’API du langage de gabarit de Django. La machinerie des moteurs de gabarits multiples n’est pas concernée ici.

\n

Finalement, si vous avez accès au contexte en cours, vous pouvez utiliser la même astuce que ci-dessus :

\n
Code
template = context.template.engine.from_string(template_code)\n
\n
\n
\n
\n

Template()Lien vers cette rubrique#

\n

À un degré moindre, la création d’une instance de gabarit avec Template(template_code) souffre des mêmes problèmes que get_template_from_string().

\n

Cela fonctionne toujours lorsque le réglage TEMPLATES définit exactement un moteur DjangoTemplates, mais les applications réutilisables ne peuvent pas contrôler cette exigence.

\n

Les deux dernières solutions décrites dans la section précédente sont recommandées dans ce cas.

\n
","rootId":"upgrading-templates-to-django-1-8","toc":[{"title":"Les réglages TEMPLATES","anchor":"the-templates-settings","children":[]},{"title":"django.template.loader","anchor":"django-template-loader","children":[{"title":"get_template() et select_template()","anchor":"get-template-and-select-template","children":[]},{"title":"get_template_from_string()","anchor":"get-template-from-string","children":[]}]},{"title":"Template()","anchor":"template","children":[]}],"breadcrumbs":[{"docname":"ref/index","title":"Référence de l’API","url":"/fr/1.11/ref/"},{"docname":"ref/templates/index","title":"Gabarits","url":"/fr/1.11/ref/templates/"}],"prev":{"docname":"ref/templates/api","title":"Le langage de gabarit de Django : pour les programmeurs Python","url":"/fr/1.11/ref/templates/api/"},"next":{"docname":"ref/template-response","title":"TemplateResponse et SimpleTemplateResponse","url":"/fr/1.11/ref/template-response/"},"formats":{"html":"/fr/1.11/ref/templates/upgrading/","markdown":"/fr/1.11/ref/templates/upgrading.md","json":"/fr/1.11/ref/templates/upgrading.json"},"source":"https://github.com/django/django/blob/stable/1.11.x/docs/ref/templates/upgrading.txt","official":"https://docs.djangoproject.com/fr/1.11/ref/templates/upgrading/","inVersions":["1.11","1.10","1.9"],"inLocales":["en","fr","ja","id","pt-br","ko","es","el","pl"]}