{"title":"Hur man implementerar en anpassad mallbackend","version":"5.2","locale":"sv","docname":"howto/custom-template-backend","url":"/sv/5.2/howto/custom-template-backend/","canonical":"https://djangodocs.dev/sv/5.2/howto/custom-template-backend/","summary":"Anpassade backends Link to this heading # Så här implementerar du en anpassad mallbackend för att kunna använda ett annat mallsystem. En template backend är en…","html":"

Hur man implementerar en anpassad mallbackendLink to this heading#

\n
\n

Anpassade backendsLink to this heading#

\n

Så här implementerar du en anpassad mallbackend för att kunna använda ett annat mallsystem. En template backend är en klass som ärver django.template.backends.base.BaseEngine. Den måste implementera get_template() och eventuellt from_string(). Här är ett exempel på ett fiktivt mallbibliotek för foobar:

\n
Code
from django.template import TemplateDoesNotExist, TemplateSyntaxError\nfrom django.template.backends.base import BaseEngine\nfrom django.template.backends.utils import csrf_input_lazy, csrf_token_lazy\n\nimport foobar\n\n\nclass FooBar(BaseEngine):\n    # Name of the subdirectory containing the templates for this engine\n    # inside an installed application.\n    app_dirname = "foobar"\n\n    def __init__(self, params):\n        params = params.copy()\n        options = params.pop("OPTIONS").copy()\n        super().__init__(params)\n\n        self.engine = foobar.Engine(**options)\n\n    def from_string(self, template_code):\n        try:\n            return Template(self.engine.from_string(template_code))\n        except foobar.TemplateCompilationFailed as exc:\n            raise TemplateSyntaxError(exc.args)\n\n    def get_template(self, template_name):\n        try:\n            return Template(self.engine.get_template(template_name))\n        except foobar.TemplateNotFound as exc:\n            raise TemplateDoesNotExist(exc.args, backend=self)\n        except foobar.TemplateCompilationFailed as exc:\n            raise TemplateSyntaxError(exc.args)\n\n\nclass Template:\n    def __init__(self, template):\n        self.template = template\n\n    def render(self, context=None, request=None):\n        if context is None:\n            context = {}\n        if request is not None:\n            context["request"] = request\n            context["csrf_input"] = csrf_input_lazy(request)\n            context["csrf_token"] = csrf_token_lazy(request)\n        return self.template.render(context)\n
\n

Se DEP 182 för mer information.

\n
\n
\n

Felsökningsintegration för anpassade motorerLink to this heading#

\n

Djangos debugsida har hooks för att ge detaljerad information när ett mallfel uppstår. Anpassade mallmotorer kan använda dessa hooks för att förbättra den spårningsinformation som visas för användarna. Följande hooks är tillgängliga:

\n
\n

Mall för postmortemLink to this heading#

\n

Postmortem visas när TemplateDoesNotExist utlöses. Den listar de mallmotorer och laddare som användes när man försökte hitta en viss mall. Om till exempel två Django-motorer är konfigurerade kommer postmortem att se ut så här:

\n\"/sv/5.2/_images/postmortem.png\"\n

Anpassade motorer kan fylla i postmortem genom att skicka argumenten backend och tried när TemplateDoesNotExist. Backends som använder postmortem bör ange ett ursprung på mallobjektet.

\n
\n
\n

Kontextuell information om linjenLink to this heading#

\n

Om ett fel inträffar under mallparsning eller rendering kan Django visa den rad där felet inträffade. Till exempel:

\n\"/sv/5.2/_images/template-lines.png\"\n

Anpassade motorer kan fylla i denna information genom att ställa in ett template_debug-attribut på undantag som uppstår under parsning och rendering. Detta attribut är en dict med följande värden:

\n\n

Med tanke på ovanstående mallfel skulle template_debug se ut så här:

\n
Code
{\n    "name": "/path/to/template.html",\n    "message": "Invalid block tag: 'syntax'",\n    "source_lines": [\n        (1, "some\\n"),\n        (2, "lines\\n"),\n        (3, "before\\n"),\n        (4, "Hello {% syntax error %} {{ world }}\\n"),\n        (5, "some\\n"),\n        (6, "lines\\n"),\n        (7, "after\\n"),\n        (8, ""),\n    ],\n    "line": 4,\n    "before": "Hello ",\n    "during": "{% syntax error %}",\n    "after": " {{ world }}\\n",\n    "total": 9,\n    "bottom": 9,\n    "top": 1,\n}\n
\n
\n
\n

Origin API och integration med tredje partLink to this heading#

\n

Django-mallar har ett Origin-objekt som är tillgängligt via attributet template.origin. Detta gör att felsökningsinformation kan visas i template postmortem, samt i tredjepartsbibliotek, som Django Debug Toolbar.

\n

Anpassade motorer kan tillhandahålla sin egen template.origin-information genom att skapa ett objekt som anger följande attribut:

\n\n
\n
","rootId":"how-to-implement-a-custom-template-backend","toc":[{"title":"Anpassade backends","anchor":"custom-backends","children":[]},{"title":"Felsökningsintegration för anpassade motorer","anchor":"debug-integration-for-custom-engines","children":[{"title":"Mall för postmortem","anchor":"template-postmortem","children":[]},{"title":"Kontextuell information om linjen","anchor":"contextual-line-information","children":[]},{"title":"Origin API och integration med tredje part","anchor":"origin-api-and-3rd-party-integration","children":[]}]}],"breadcrumbs":[{"docname":"howto/index","title":"Hur man gör-guider","url":"/sv/5.2/howto/"}],"prev":{"docname":"howto/overriding-templates","title":"Hur man åsidosätter mallar","url":"/sv/5.2/howto/overriding-templates/"},"next":{"docname":"howto/custom-template-tags","title":"Så här skapar du anpassade malltaggar och filter","url":"/sv/5.2/howto/custom-template-tags/"},"formats":{"html":"/sv/5.2/howto/custom-template-backend/","markdown":"/sv/5.2/howto/custom-template-backend.md","json":"/sv/5.2/howto/custom-template-backend.json"},"source":"https://github.com/django/django/blob/stable/5.2.x/docs/howto/custom-template-backend.txt","official":"https://docs.djangoproject.com/sv/5.2/howto/custom-template-backend/","inVersions":["6.1","6.0","5.2"],"inLocales":["en","sv","zh-hans","ga","fr","ja","id","it","pt-br","ko","es","el","pl"]}