Teanga teimpléad DjangoLink to this heading#

TeimpléidLink to this heading#

Is comhad téacs é teimpléad. Féadann sé aon fhormáid téacs-bhunaithe a ghiniúint (HTML, XML, CSV, srl.).

Tá athróga i dteimpléad, a gcuirtear luachanna in ionad nuair a dhéantar an teimpléad a mheas, agus clibe, a rialaíonn loighic an teimpléid.

Seo thíos teimpléad íosta a léiríonn cúpla buneilimintí. Déanfar gach eilimint a mhíniú níos déanaí sa doiciméad seo.

{% extends "base_generic.html" %}

{% block title %}{{ section.title }}{% endblock %}

{% block content %}
<h1>{{ section.title }}</h1>

{% for story in story_list %}
<h2>
  <a href="{{ story.get_absolute_url }}">
    {{ story.headline|upper }}
  </a>
</h2>
<p>{{ story.tease|truncatewords:"100" }}</p>
{% endfor %}
{% endblock %}

AthrógaLink to this heading#

Breathnaíonn athróga mar seo: {{athróg}}. Nuair a thagann an t-inneall teimpléid le hathróg, déanann sé an t-athróg sin a mheas agus cuireann sé an toradh in ionad é Is éard atá i ainmneacha athraitheacha aon teaglaim de charachtair alfa-uimhriúla agus an béim ("_") ach ní fhéadfaidh sé tosú le béim, agus b'fhéidir nach bhfuil sé ina uimhir. Tá an ponc (”. “) le feiceáil freisin i rannáin athraitheacha, cé go bhfuil brí speisialta aige sin, mar a léirítear thíos. Tábhachtach, * ní féidir leat spásanna nó carachtair poncaíochta a bheith agat in ainmneacha athraitheacha. *

Úsáid ponc (.`) chun rochtain a fháil ar thréithe athróg.

Sa sampla thuas, cuirfear an tréith title den réad roinn ``in ionad {{section.title}} ``.

Má úsáideann tú athróg nach bhfuil ann, cuirfidh an córas teimpléid luach an rogha string_if_invalid isteach, atá socraithe go ``"``(an teaghrán folamh) de réir réamhshocraithe.

Tabhair faoi deara go léirmhínítear “barra” i abairt teimpléid cosúil le {{foo.bar}} mar shreang litriúil agus gan úsáid luach an athróg “barra”, má tá ceann ann i gcomhthéacs an teimpléid.

Ní fhéadfar rochtain a fháil ar thréithe athraitheacha a thosaíonn le béim toisc go meastar go príobháideach iad de ghnáth.

ScagairíLink to this heading#

Is féidir leat athróga a mhodhnú le taispeáint trí**scagairí** a úsáid.

Breathnaíonn scagairí mar seo: {{ainm|níos ísle}}. Taispeánann sé seo luach an athróg {{name}} tar éis é a scagadh tríd an scagair:tfilter: lower, a athraíonn téacs go litreacha beaga. Úsáid píopa (| `) chun scagaire a chur i bhfeidhm.

Is féidir scagairí a “slabhraithe.” <p>Cuirtear aschur scagaire amháin i bhfeidhm ar an gcéad cheann eile. {{text|escape|linebreaks}} `is idiom coitianta é chun ábhar téacs a éalú, ansin sosanna líne a thiontú go clibeanna`.

Tugann roinnt scagairí argóintí. Breathnaíonn argóint scagaire mar seo: {{bio|truncatewords:30}}. Taispeánfaidh sé seo an chéad 30 focal den athróg bio.

Ní mór argóintí scagaire ina bhfuil spásanna a lua; mar shampla, chun liosta le camóga agus spásanna a bheith agat le {{list|join:”, "}}.

Soláthraíonn Django thart ar seasca scagaire teimpléad ionsuite <ref-templates-builtins-filters>Is féidir leat gach rud fúthu a léamh in:ref: `tagairt scagaire ionsuite `. Chun blas a thabhairt duit ar na rudaí atá ar fáil, seo cuid de na scagairí teimpléid is coitianta a úsáidtear:

default

Má tá athróg bréagach nó folamh, bain úsáid as réamhshocrú tugtha. Seachas sin, bain úsáid as luach an athróg. Mar shampla:

Django template

{{ value|default:"nothing" }}

Mura gcuirtear luach ar fáil nó mura bhfuil sé folamh, taispeánfaidh an méid thuas “``aon rud ``”.

length

Tugann sé ar ais fad an luacha. Oibríonn sé seo le haghaidh teaghráin agus liostaí araon. Mar shampla:

Django template

{{ value|length }}

Más é luach ['a', 'b', 'c', 'd'], is é 4 an t-aschur.

filesizeformat

Formáidigh an luach cosúil le méid comhaid “inléite don duine” (ie '13 KB', 4.1 MB', `102 bytes', srl.). Mar shampla:

Django template

{{ value|filesizeformat }}

Más é “luach” 123456789, is é 117.7 MB an t-aschur.

Arís, níl ach cúpla sampla seo; féach an:ref: `tagairt scagaire ionsuite <ref-templates-builtins-filters>`don liosta iomlán.

Is féidir leat do scagairí teimpléad saincheaptha féin a chruthú freisin; féach: doc: /howto/custom-template-tags.

ClibeannaLink to this heading#

Breathnaíonn clibeanna mar seo: {% tag%}. Tá clibeanna níos casta ná athróga: Cruthaíonn cuid acu téacs san aschur, sreabhadh rialaithe roinnt trí lúb nó loighic a dhéanamh, agus luchtaíonn cuid acu faisnéis sheachtrach isteach sa teimpléad le húsáid ag athróga níos déanaí.

Teastaíonn clibeanna tosaigh agus deireadh ó roinnt clibeanna (ie {% tag%}... tag content... {% endtag%}).

Loingíonn Django le thart ar dhá dhosaen clibeanna teimpléad ionsuite. <ref-templates-builtins-tags>Is féidir leat gach rud fúthu a léamh in:ref: `tagairt clibeanna ionsuite `. Chun blas a thabhairt duit ar na rudaí atá ar fáil, seo cuid de na clibeanna is coitianta a úsáidtear:

for

Lúb thar gach mír i sraith. Mar shampla, chun liosta lúthchleasaithe a chuirtear ar fáil in athlete_list` a thaispeáint:

Django template

<ul>
{% for athlete in athlete_list %}
    <li>{{ athlete.name }}</li>
{% endfor %}
</ul>

if, elif, and else

Déanann sé athróg a mheas, agus má tá an athróg sin “fíor” taispeántar ábhar an bhloc:

Django template

{% if athlete_list %}
    Number of athletes: {{ athlete_list|length }}
{% elif athlete_in_locker_room_list %}
    Athletes should be out of the locker room soon!
{% else %}
    No athletes.
{% endif %}

Sa mhéid thuas, mura bhfuil athlete_list folamh, taispeánfar líon na lúthchleasaithe ag an athróg {{athlete_list|length}}. Seachas sin, mura bhfuil athlete_in_locker_room_list` folamh, taispeánfar an teachtaireacht “Ba chóir go mbeadh lúthchleasaithe amach...”. Má tá an dá liosta folamh, taispeánfar “Gan lúthchleasaithe.”

Is féidir leat scagairí agus oibreoirí éagsúla a úsáid freisin sa chlib: ttag: `if:

Django template

{% if athlete_list|length > 1 %}
   Team: {% for athlete in athlete_list %} ... {% endfor %}
{% else %}
   Athlete: {{ athlete_list.0.name }}
{% endif %}

Cé go n-oibríonn an sampla thuas, bí ar an eolas go bhfilleann an chuid is mó de na scagairí teimpléid teaghráin, mar sin de ghnáth ní oibreoidh comparáidí matamaitice :tfilter: Is eisceacht é fad.

block and extends

Socraigh oidhreacht teimpléad (féach thíos), bealach cumhachtach chun “boilerplate” a ghearradh síos i dteimpléid.

Arís, níl an méid thuas ach rogha den liosta iomlán; féach an:ref: `tagairt clibeanna ionsuite <ref-templates-builtins-tags>`don liosta iomlán.

Is féidir leat do chlibeanna teimpléad saincheaptha féin a chruthú freisin; féach: doc: /howto/custom-template-tags.

TuairimíLink to this heading#

Chun trácht a dhéanamh amach cuid de líne i dteimpléad, bain úsáid as an gcomhréir tráchtaireachta: {# #}.

Mar shampla, rinneadh an teimpléad seo mar 'hello':

{# greeting #}hello

Is féidir aon chód teimpléid a bheith i dtrácht, neamhbhailí nó nach bhfuil. Mar shampla:

{# {% if foo %}bar{% else %} #}

Ní féidir an comhréir seo a úsáid ach le haghaidh tuairimí aonlíne (ní cheadaítear aon línte nua idir na teorainneacha {# agus #}`). Más gá duit trácht a dhéanamh ar chuid illíne den teimpléad, féach an clibe:ttag: comment.

Teimpléad oidhreachtLink to this heading#

Is é an chuid is cumhachtaí - agus dá bhrí sin an chuid is casta - d'inneall teimpléad Django ná oidhreacht teimpléad. Ligeann oidhreacht teimpléad duit teimpléad “cnámharlaigh” bonn a thógáil ina bhfuil na heilimintí coitianta go léir de do shuíomh agus a shainmhíníonn t**bloic** ar féidir le teimpléid leanaí a ath

Breathnaímid ar oidhreacht teimpléid trí thosú le sampla:

<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="stylesheet" href="style.css">
    <title>{% block title %}My amazing site{% endblock %}</title>
</head>

<body>
    <div id="sidebar">
        {% block sidebar %}
        <ul>
            <li><a href="/">Home</a></li>
            <li><a href="/blog/">Blog</a></li>
        </ul>
        {% endblock %}
    </div>

    <div id="content">
        {% block content %}{% endblock %}
    </div>
</body>
</html>

Sainmhíníonn an teimpléad seo, a thabharfaimid ``base.html`, doiciméad cnámharlaigh HTML a d'fhéadfá a úsáid le haghaidh leathanach dhá cholún. Is obair teimpléid “leanbh” é na bloic folmha a líonadh le hábhar.

Sa sampla seo, sainmhíníonn an clibe:ttag: bloc trí bhloc ar féidir le teimpléid leanaí a líonadh isteach. Is é an clibe:ttag: bloc go léir ná insint don inneall teimpléid go bhféadfadh teimpléad leanbh na codanna sin den teimpléad a shárú.

D'fhéadfadh cuma seo a bheith ar theimpléad linbh:

{% extends "base.html" %}

{% block title %}My amazing blog{% endblock %}

{% block content %}
{% for entry in blog_entries %}
    <h2>{{ entry.title }}</h2>
    <p>{{ entry.body }}</p>
{% endfor %}
{% endblock %}

Is é an clib: ttag: extens an eochair anseo. Insíonn sé don inneall teimpléid go leathnaíonn an teimpléad seo teimpléad eile. Nuair a dhéanann an córas teimpléid measúnú ar an teimpléad seo, aimsíonn sé an tuismitheoir ar dtús - sa chás seo, "base.html”.

Ag an bpointe sin, tabharfaidh inneall an teimpléid faoi deara na trí chlib: ttag: bloc i base.html` agus cuirfidh ábhar an teimpléid linbh in ionad na bloic sin. Ag brath ar luach blog_entries, d'fhéadfadh cuma ar an aschur:

<!DOCTYPE html>
<html lang="en">
<head>
    <link rel="stylesheet" href="style.css">
    <title>My amazing blog</title>
</head>

<body>
    <div id="sidebar">
        <ul>
            <li><a href="/">Home</a></li>
            <li><a href="/blog/">Blog</a></li>
        </ul>
    </div>

    <div id="content">
        <h2>Entry one</h2>
        <p>This is my first entry.</p>

        <h2>Entry two</h2>
        <p>This is my second entry.</p>
    </div>
</body>
</html>

Tabhair faoi deara ós rud é nár sainmhínigh an teimpléad linbh an bloc taobharra`, go n-úsáidtear an luach ón teimpléad tuismitheora ina ionad. Úsáidtear ábhar laistigh de chlib ``{% block%} i dteimpléad tuismitheora mar fhriotán i gcónaí.

Is féidir leat an oiread leibhéil oidhreachta a úsáid agus is gá. Bealach coitianta amháin chun oidhreacht a úsáid ná an cur chuige trí leibhéal seo a leanas:

• Cruthaigh teimpléad ``base.html` a choinníonn príomh-chuma agus mothú do shuíomh.

• Cruthaigh teimpléad Base_SectionName.html ``do gach “rannóg” de do shuíomh. Mar shampla, ``base_news.html, base_sports.html. Leathnaíonn na teimpléid seo go léir base.html agus folaíonn stílea/dearadh roinn-shonrach.

• Cruthaigh teimpléid aonair do gach cineál leathanaigh, mar shampla alt nuachta nó iontráil blag. Leathnaíonn na teimpléid seo an teimpléad roinn cuí

Uasmhéadaíonn an cur chuige seo athúsáid cód agus cuidíonn sé le míreanna a chur le réimsí ábhar roinnte, mar shampla nascleanúint ar fud an ranná

Seo roinnt leideanna chun oibriú le oidhreacht:

• Má úsáideann tú: ttag: {% leathnaíonn%}<extends> i dteimpléad, ní mór gurb é an chéad chlib teimpléad sa teimpléad sin. Ní oibreoidh oidhreacht teimpléid, ar shlí eile.

• Tuilleadh: TTag: Tá clibeanna {% block%}<block> i do theimpléid bonn níos fearr. Cuimhnigh, ní gá le teimpléid leanaí gach bloc tuismitheora a shainiú, ionas gur féidir leat réamhshocruithe réasúnta a líonadh isteach i roinnt bloic, ansin na cinn a theastaíonn uait a shainiú níos déanaí. Is fearr níos mó crúcaí a bheith agat ná níos lú crúcaí.

• Má aimsíonn tú féin ag dúbailt ábhar i roinnt teimpléid, is dócha go gciallaíonn sé gur chóir duit an t-ábhar sin a bhogadh go ``{% block%} `i dteimpléad tuismitheoirí.

• Más gá duit ábhar an bhloc a fháil ón teimpléad tuismitheora, déanfaidh an athróg {{block.super}} an cleas. Tá sé seo úsáideach más mian leat cur le hábhar tuismitheoirí bloc in ionad é a shárú go hiomlán. Ní éalófar sonraí a cuireadh isteach ag baint úsáide as {{block.super}} go huathoibríoch (féach an `chéad roinn eile `_), ós rud é go raibh sé éalaithe cheana féin, más gá, sa teimpléad tuismitheora.

• Trí úsáid a bhaint as an ainm teimpléid céanna a bhfuil tú ag oidhreacht uaidh, is <extends>féidir: ttag: {%%} a úsáid chun teimpléad a oidhreacht ag an am céanna agus é a shárú. In éineacht le {{block.super}}, is féidir leis seo a bheith ina bhealach cumhachtach chun saincheaptha beaga a dhéanamh. Féach:ref: extending_an_overridden_template sna teimpléid *Overriding * Conas le haghaidh sampla iomlán.

• Ní féidir athróga a cruthaíodh lasmuigh de a:ttag: {% block%}<block> ag baint úsáide as an gclib teimpléad ``as ``comhréiteach taobh istigh den bhloc. Mar shampla, ní dhéanann an teimpléad seo aon rud:

  Django template

  {% translate "Title" as title %}
  {% block content %}{{ title }}{% endblock %}
  

• Le haghaidh léiteachta breise, is féidir leat ainm a thabhairt go roghnach do chlib {% endblock%}. Mar shampla:

  Django template

  {% block content %}
  ...
  {% endblock content %}
  

  I dteimpléid níos mó, cabhraíonn an teicníc seo leat a fheiceáil cé na clibeanna {% block%} atá á dhúnadh.

• {% block %} tags are evaluated first. That's why the content of a block is always overridden, regardless of the truthiness of surrounding tags. For example, this template will always override the content of the title block:

  Django template

  {% if change_title %}
      {% block title %}Hello!{% endblock title %}
  {% endif %}
  

Mar fhocal scoir, tabhair faoi deara nach féidir leat clibeanna iolracha: ttag: bloc a shainiú leis an ainm céanna sa teimpléad céanna. Tá an teorannú seo ann toisc go n-oibríonn bloc clib sa “dá threo”. Is é sin, ní sholáthraíonn bloc clib ach poll le líonadh - sainmhíníonn sé freisin an t-ábhar a líonann an poll san tuismitheoir. Dá mbeadh dhá chlib den chineál céanna: ttag: bloc i dteimpléad, ní bheadh a fhios ag tuismitheoir an teimpléid sin cén ceann de ábhar na mbloic le húsáid.

Éalú uathoibríoch HTMLLink to this heading#

Agus HTML á ghiniúint agat ó theimpléid, tá baol ann i gcónaí go mbeidh carachtair san athróg a théann i bhfeidhm ar an HTML mar thoradh air Mar shampla, smaoinigh ar an mblúirt teimpléid seo

Hello, {{ name }}

Ar dtús, is cosúil gur bealach neamhdhíobhálach é seo chun ainm úsáideora a thaispeáint, ach smaoinigh ar cad a tharlódh dá gcuirfeadh an t-úsáideoir a ainm isteach mar seo:

<script>alert('hello')</script>

Leis an luach ainm seo, déanfaí an teimpléad a léiriú mar:

Hello, <script>alert('hello')</script>

... rud a chiallaíonn go gcuirfeadh an brabhsálaí bosca foláirimh JavaScript!

Ar an gcaoi chéanna, cad a tharlaíonn má bhí siombail '<' san ainm, mar seo?

<b>username

Bheadh teimpléad rindreáilte mar seo mar thoradh air sin:

Hello, <b>username

... rud a d'fhágfadh, ina dhiaidh sin, go mbeadh an chuid eile den leathanach gréasáin i dtrom!

Is léir, níor cheart muinín a bheith ag sonraí a chuirtear isteach ag úsáideoirí go dall agus a chur isteach go díreach i do leathanaigh ghréasáin, toisc go bhféadfadh úsáideoir mailíseach poll den chineál seo a úsáid chun rudaí a d'fhéad Tugtar ionsaí Cross Site Scripting (XSS) ar an gcineál seo saothrú slándála.

Chun an fhadhb seo a sheachaint, tá dhá rogha agat:

• Ceann amháin, is féidir leat a chinntiú go rith gach athróg neamhiontaofa tríd an scagair:tfilter: escape (doiciméadaithe thíos), a athraíonn carachtair HTML a d'fhéadfadh a bheith díobhálach go cinn neamhdhíobhálacha. Ba é seo an réiteach réamhshocraithe i Django dá chéad chúpla bliain, ach is í an fhadhb ná go gcuireann sé an t-ualach ar* uis*, an forbróir/údar teimpléid, chun a chinntiú go bhfuil tú ag éalú ó gach rud. Tá sé éasca dearmad a dhéanamh ar shonraí a éalú.

• Dá cheann, is féidir leat leas a bhaint as éalú uathoibríoch HTML Django. Déanann an chuid eile den chuid seo cur síos ar an gcaoi a n-oibríonn éalú uath

De réir réamhshocraithe i Django, éalaíonn gach teimpléad aschur gach clib athraitheach go huathoibríoch. Go sonrach, éalaítear na cúig charachtar seo:

• Déantar < a thiontú go <

• Tiontaítear >` go >`

• Tiontaítear ````(luachan aonair) go ```

• Déantar "``(luachan dúbailte) a thiontú go"``

• Tiontaítear & ``go `&`

Arís, cuirimid béim go bhfuil an t-iompar seo ar siúl de réir réamhshocraithe. Má tá córas teimpléad Django á úsáid agat, tá tú cosanta.

This will be escaped: {{ data }}
This will not be escaped: {{ data|safe }}

This will be escaped: <b>
This will not be escaped: <b>

{% autoescape off %}
    Hello {{ name }}
{% endautoescape %}

Auto-escaping is on by default. Hello {{ name }}

{% autoescape off %}
    This will not be auto-escaped: {{ data }}.

    Nor this: {{ other_data }}
    {% autoescape on %}
        Auto-escaping applies again: {{ name }}
    {% endautoescape %}
{% endautoescape %}

{% autoescape off %}
<h1>{% block title %}{% endblock %}</h1>
{% block content %}
{% endblock %}
{% endautoescape %}

{% extends "base.html" %}
{% block title %}This & that{% endblock %}
{% block content %}{{ greeting }}{% endblock %}

<h1>This &amp; that</h1>
<b>Hello!</b>

{{ data|default:"This is a string literal." }}

{{ data|default:"3 < 2" }}

{{ data|default:"3 < 2" }}  {# Bad! Don't do this. #}

Glaonna modh a rochtainLink to this heading#

Tá an chuid is mó de na glaonna modh atá ceangailte le rudaí ar fáil ó theimpléid laisti Ciallaíonn sé seo go bhfuil rochtain ag teimpléid ar i bhfad níos mó ná tréithe ranga amháin (cosúil le hainmneacha réimse) agus athróga a rith isteach ó thuairimí Mar shampla, soláthraíonn an ORM Django comhréire:ref: `"entry_set” <topics-db-queries-related>`chun bailiúchán rudaí a bhaineann le heochair eachtrach a aimsiú. Dá bhrí sin, i bhfianaise samhail ar a dtugtar “trácht” le príomhchaidreamh eachtrach le samhail ar a dtugtar “tasc” is féidir leat lúb trí gach trácht atá ceangailte le tasc ar leith mar seo:

{% for comment in task.comment_set.all %}
    {{ comment }}
{% endfor %}

Ar an gcaoi chéanna, soláthraíonn :doc: QuerySets modh</ref/models/querysets> ``count () ``chun líon na rudaí atá iontu a chomhaireamh. Dá bhrí sin, is féidir leat comhaireamh de na tuairimí go léir a bhaineann leis an tasc reatha a fháil le:

{{ task.comment_set.all.count }}

Is féidir leat rochtain a fháil ar mhodhanna atá sainmhínithe agat go sainráite ar do chuid samhlacha féin:

class Task(models.Model):
    def foo(self):
        return "bar"

{{ task.foo }}

Toisc go gcuireann Django teorainn d'aon ghnó ar an méid próiseála loighic atá ar fáil i dteanga na teimpléid, ní féidir argóintí a chur ar aghaidh chuig glaonna modh a rochtaítear orthu ó laistigh Ba chóir sonraí a ríomh i radhairc, ansin a chur chuig teimpléid le taispeáint.

Clib saincheaptha agus leabharlanna scagaireLink to this heading#

Soláthraíonn feidhmchláir áirithe leabharlanna clibeanna saincheaptha Chun rochtain a fháil orthu i dteimpléad, cinntigh go bhfuil an feidhmchlár in:setting: INSTALLED_APPS (chuirfimid ``django.contrib.humanize' leis an sampla seo), agus ansin úsáid an clibe:ttag: `load i dteimpléad:

{% load humanize %}

{{ 45000|intcomma }}

Sa mhéid thuas, luchtaíonn an clibe:ttag: load leabharlann clibeanna humanize, rud a fhágann go bhfuil an scagaire ``intcomma` ar fáil le húsáid ansin. Má tá: mod: django.contrib.admindocs cumasaithe agat, is féidir leat dul i gcomhairle leis an réimse doiciméadaithe i do riarachán chun liosta na leabharlanna saincheaptha i do shuiteáil a fháil.

Is féidir leis an gclibe:ttag: `load `ilainmneacha leabharlainne a thógáil, scartha le spásanna. Sampla:

{% load humanize i18n %}

Féach: doc: /howto/custom-template-tags le haghaidh faisnéise maidir le do leabharlanna teimpléad saincheaptha féin a scríobh.