Clibeanna teimpléad ionsuite agus scagairLink to this heading
Déanann an doiciméad seo cur síos ar chlibeanna agus scagairí teimpléad ion Moltar duit an doiciméadú uathoibríoch: doc: a úsáid, má tá sé ar fáil, mar beidh cáipéisíocht ann freisin le haghaidh aon chlibeanna nó scagairí saincheaptha atá suiteáilte </ref/contrib/admin/admindocs>.
Tagairt clibeanna ionsuiteLink to this heading
autoescapeLink to this heading
Rialaíonn sé an t-iompar uathoibríoch reatha. Tógann an chlib seo on nó off ``mar argóint agus cinneann sé sin an bhfuil éalú uathoibríoch i bhfeidhm taobh istigh den bhloc. Tá an bloc dúnta le clib deireadh ``endautoescape.
Úsáid samplach:
{% autoescape on %}
{{ body }}
{% endautoescape %}
Nuair a bhíonn éalú uathoibríoch i bhfeidhm, tá éalú HTML i bhfeidhm ag gach ábhar a dhíorthaítear ó athróga sula gcuirtear an toradh isteach san aschur (ach tar éis aon scagairí a chur i bhfeidhm). Tá sé seo comhionann leis an scagaire: tfilter: escape a chur i bhfeidhm de láimh ar gach athróg.
Is iad na heisceachtaí amháin ná athróga atá marcáilte cheana féin mar “sábháilte” ó éalú. D'fhéadfaí athróga a mharcáil mar “sábháilte” leis an gcód a rinne an athróg, tríd na scagairí:tfilter: safe nó: tfilter: escape a chur i bhfeidhm, nó toisc gurb é toradh scagaire roimhe seo a mharcálaigh an sreang mar “sábháilte”.
Laistigh de raon feidhme an éalaithe uathoibríoch faoi mhíchumas, d'fhéadfadh torthaí gan choinne (ach doiciméadaithe) mar an méid seo a leanas a bheith ina chúis le scagairí slabhraithe, lena n-áirítear: tfilter: `éalú `
{% autoescape off %}
{{ my_list|join:", "|escape }}
{% endautoescape %}
Aschróidh an cód thuas na heilimintí ceangailte de my_list gan éalú. Tá sé seo toisc go bhfeidhmíonn seicheamh slabhraí an scagaire ar dtús: tfilter: join ar my_list (gan éalú a chur i bhfeidhm ar gach mír ós rud é go bhfuil autoescape ``off ``), ag marcáil an toradh mar shábháilte. Ina dhiaidh sin, cuirfear an toradh sábháilte seo chuig scagaire: tfilter: escape, nach gcuireann an dara babhta éalaithe i bhfeidhm.
D'fhonn éalú i gceart gach eilimint i seicheamh, bain úsáid as an scagair:tfilter: escapeseq:
{% autoescape off %}
{{ my_list|escapeseq|join:", " }}
{% endautoescape %}
``Bloc ``Link to this heading
Sainmhíníonn bloc is féidir le teimpléid leanaí a shárú. Féach:ref: `Oidhreacht teimpléad <template-inheritance>`le haghaidh tuilleadh faisnéise.
`TráchtaireLink to this heading
Déanann sé neamhaird ar gach rud idir {% comment%} agus {% endcomment%}. Féadfar nóta roghnach a chur isteach sa chéad chlib. Mar shampla, tá sé seo úsáideach agus tú ag trácht amach cód chun doiciméadú cén fáth a raibh an cód faoi dhíchumasú.
Úsáid samplach:
<p>Rendered text with {{ pub_date|date:"c" }}</p>
{% comment "Optional note" %}
<p>Commented out text with {{ create_date|date:"c" }}</p>
{% endcomment %}
Ní féidir clibeanna tráchtaire a neadú.
csrf_tokenLink to this heading
Úsáidtear an chlib seo le haghaidh cosaint CSRF, mar a thuairiscítear sa dhoiciméadú daga:doc: Iarratas Cross Site For</ref/csrf> geries.
rothaLink to this heading
Táirgeann sé ceann dá argóintí gach uair a thagann an chlib seo. Cuirtear an chéad argóint ar an gcéad teagmháil, an dara argóint ar an dara teagmháil, agus mar sin de. Nuair a bheidh na hargóintí go léir ídithe, timthriallann an chlib go dtí an chéad argóint agus táirgeann sé ar
Tá an clib seo úsáideach go háirithe i lúb:
{% for o in some_list %}
<tr class="{% cycle 'row1' 'row2' %}">
...
</tr>
{% endfor %}
Táirgeann an chéad athrú HTML a thagraíonn d'aicme row1, an dara ceann go row2, an tríú go row1 arís, agus mar sin de do gach athrú den lúb.
Is féidir leat athróga a úsáid freisin. Mar shampla, má tá dhá athróg teimpléad agat, rowvalue1 agus rowvalue2, is féidir leat a gcuid luachanna mar seo a mhalartú:
{% for o in some_list %}
<tr class="{% cycle rowvalue1 rowvalue2 %}">
...
</tr>
{% endfor %}
Éalófar athróga atá san áireamh sa timthriall. Is féidir leat éalú uathoibríoch a dhíchumasú le
{% for o in some_list %}
<tr class="{% autoescape off %}{% cycle rowvalue1 rowvalue2 %}{% endautoescape %}">
...
</tr>
{% endfor %}
Is féidir leat athróga agus teaghráin a mheascadh:
{% for o in some_list %}
<tr class="{% cycle 'row1' rowvalue2 'row3' %}">
...
</tr>
{% endfor %}
I roinnt cásanna b'fhéidir gur mhaith leat tagairt a dhéanamh do luach reatha timthrialla gan dul chun cinn go dtí an chéad luach eile. Chun seo a dhéanamh, tabhair ainm don chlib {% timthriall%}, ag baint úsáide as “mar”, mar seo:
{% cycle 'row1' 'row2' as rowcolors %}
Ón sin ar aghaidh, is féidir leat luach reatha an timthriall a chur isteach cibé áit ar mhaith leat i do theimpléad trí thagairt a dhéanamh ar ainm an timthriall mar athróg comhthéacs. Más mian leat an timthriall a bhogadh go dtí an chéad luach eile go neamhspleách ar an gclib “timthriall” bunaidh, is féidir leat clib ``timthriall` eile a úsáid agus ainm an athróg a shonrú. Mar sin, an teimpléad seo a leanas:
<tr>
<td class="{% cycle 'row1' 'row2' as rowcolors %}">...</td>
<td class="{{ rowcolors }}">...</td>
</tr>
<tr>
<td class="{% cycle rowcolors %}">...</td>
<td class="{{ rowcolors }}">...</td>
</tr>
bheadh aschur:
<tr>
<td class="row1">...</td>
<td class="row1">...</td>
</tr>
<tr>
<td class="row2">...</td>
<td class="row2">...</td>
</tr>
Is féidir leat aon líon luachanna a úsáid i gclib timthriall`, atá scartha le spásanna. Déileáltar le luachanna atá iargúlta i luachana aonair (```) nó i luachana dúbailte (`) mar litríochtaí teaghrán, agus déileáltar le luachanna gan luachanna mar athróga teimpléid.
De réir réamhshocraithe, nuair a úsáideann tú an eochairfhocal as ``leis an gclib timthriall, táirgfidh úsáid {% timthriall%} a thosaíonn an timthriall an chéad luach sa timthriall féin. D'fhéadfadh sé seo a bheith ina fhadhb más mian leat an luach a úsáid i lúb neadaithe nó teimpléad san áireamh. Mura dteastaíonn uait ach an timthriall a dhearbhú ach gan an chéad luach a tháirgeadh, is féidir leat eochairfhocal ``ciúna a chur leis mar an eochairfhocal deireanach sa chlib. Mar shampla:
{% for obj in some_list %}
{% cycle 'row1' 'row2' as rowcolors silent %}
<tr class="{{ rowcolors }}">{% include "subtemplate.html" %}</tr>
{% endfor %}
Aschróidh sé seo liosta d'eilimintí ```` le aic <tr>me malartach idir sraith 1 agus row2. <tr>Beidh rochtain ag an bhfotheimpléad ar rowdats' ina chomhthéacs agus meaitneoidh an luach le rang an `` a chuimsíonn sé. <tr>Dá ndéanfaí an eochairfhocal ciúna a fhágáil, astófaí sraith 1 agus row2 mar ghnáththéacs, lasmuigh den eilimint ```.
Nuair a úsáidtear an eochairfhocal ciúin ar shainiú timthriall, baineann an tost go huathoibríoch le gach úsáid ina dhiaidh sin den chlib timthriall sonrach sin. Ní chuirfeadh an teimpléad seo a leanas aschuir* rud ar bith, cé nach sonraíonn an dara glao chuig {% timthriall%} ciúna:
{% cycle 'row1' 'row2' as rowcolors silent %}
{% cycle rowcolors %}
Is féidir leat an clibe:ttag: resetcycle a úsáid chun clib {% cycle%} a atosú óna chéad luach nuair a bhíonn sé amach romhainn.
DebugLink to this heading
Aisíonn sé ualach iomlán faisnéise dífhabhtaithe, lena n-áirítear an comhthéacs reatha agus modúil allmhairithe. {% debug%} `ní aschuireann {% debug%} aon rud nuair is é an socrú:setting: `DEBUG` `False.
síneamhLink to this heading
Comharthaíonn sé go leathnaíonn an teimpléad seo teimpléad
Is féidir an chlib seo a úsáid ar dhá bhealach:
{% leathnaíonn "base.html"%} `(le luachana) úsáideann an luach liteartha” base.html “``mar ainm an teimpléad tuismitheora le leathnú.{% leathnaíonn athróg%} `úsáideann luach ``inathraithe. Má dhéanann an t-athróg meastóireacht ar shreang, úsáidfidh Django an sreang sin mar ainm an teimpléid tuismitheora. Má dhéanann an t-athróg meastóireacht ar réad ``Teimpléad`, úsáidfidh Django an réad sin mar an teimpléad tuismitheora.
Féach:ref: template-heritance le haghaidh tuilleadh faisnéise.
De ghnáth bíonn ainm an teimpléid i gcoibhneas le eolaire fréimhe an lódóra Féadfaidh argóint teaghrán a bheith ina cosán coibhneasta freisin ag tosú le ./` nó .. /. Mar shampla, glacadh leis an struchtúr eolaire seo a leanas:
dir1/
template.html
base2.html
my/
base3.html
base1.html
I template.html`, bheadh na cosáin seo a leanas bailí:
{% extends "./base2.html" %}
{% extends "../base1.html" %}
{% extends "./my/base3.html" %}
ScagairLink to this heading
Scagann ábhar an bhloc trí scagaire amháin nó níos mó. Is féidir scagairí iolracha a shonrú le píopaí agus is féidir argóintí a bheith ag scagairí, díreach mar atá i gcomhré
Tabhair faoi deara go gcuimsíonn an bloc uach an téacs idir na clibeanna filter agus endfilter.
Úsáid samplach:
{% filter force_escape|lower %}
This text will be HTML-escaped, and will appear in all lowercase.
{% endfilter %}
FirstoffLink to this heading
Aschur an chéad athróg argóint nach bhfuil “bréagach” (ie ann, níl folamh, ní luach bréagach boolean é, agus ní luach uimhriúil nialasach é). Ní aschur aon rud mura bhfuil na hathróga rithaithe go léir “bréagach”.
Úsáid samplach:
{% firstof var1 var2 var3 %}
Tá sé seo coibhéiseach le:
{% if var1 %}
{{ var1 }}
{% elif var2 %}
{{ var2 }}
{% elif var3 %}
{{ var3 }}
{% endif %}
Is féidir leat teaghrán litriúil a úsáid freisin mar luach titim i gcás go bhfuil gach athróg rith bréagach:
{% firstof var1 var2 var3 "fallback value" %}
Éalaíonn an chlib seo luachanna athraitheacha go huathoibr Is féidir leat éalú uathoibríoch a dhíchumasú le
{% autoescape off %}
{% firstof var1 var2 var3 "<strong>fallback value</strong>" %}
{% endautoescape %}
Nó mura chóir ach roinnt athróg a éalú, is féidir leat úsáid a bhaint as:
{% firstof var1 var2|safe var3 "<strong>fallback value</strong>"|safe %}
Is féidir leat an comhréir {% firstof var1 var2 var3 a úsáid mar luach%} chun an t-aschur a stóráil taobh istigh d'athróg.
Invalid section title or transition marker.Link to this heading
Lúbanna thar gach mír in eagar, rud a fhágann go bhfuil an mír ar fáil in athróg comhthéacs. Mar shampla, chun liosta lúthchleasaithe a chuirtear ar fáil in athlete_list` a thaispeáint:
<ul>
{% for athlete in athlete_list %}
<li>{{ athlete.name }}</li>
{% endfor %}
</ul>
Is féidir leat lúb thar liosta ar ais trí úsáid a bhaint as {% le haghaidh obj i liosta aisiompthe%}.
Más gá duit lúb a dhéanamh thar liosta liostaí, is féidir leat na luachanna i ngach suliosta a dhíphacáil in athróga aonair. Mar shampla, má tá liosta de chomhordanáidí (x, y) ar a dtugtar ``pointí ``i do chomhthéacs, d'fhéadfá an méid seo a leanas a úsáid chun an liosta pointí a aschur:
{% for x, y in points %}
There is a point at {{ x }},{{ y }}
{% endfor %}
Is féidir leis seo a bheith úsáideach freisin más gá duit rochtain a fháil ar na míreanna i bhfoclóir. Mar shampla, dá mbeadh foclóir `sonraí ``i do chomhthéacs, taispeánfaí eochracha agus luachanna an fhoclóra seo a leanas:
{% for key, value in data.items %}
{{ key }}: {{ value }}
{% endfor %}
Coinnigh i gcuimhne go bhfuil tosaíocht ag cuardach eochair foclóra maidir leis an oibreoir ponc seachas cuardach modhanna. Dá bhrí sin má tá eochair darb ainm 'items' sa fhoclóir ``sonra, cuirfidh data.items` ar ais data ['items'] ``in ionad ``data.items (). Seachain eochracha a ainmnítear cosúil le modhanna foclóra a chur leis más mian leat na modhanna sin a úsáid i dteimpléad (earraí `, luacha`, eochair`, srl.). <template-variables>Léigh tuilleadh faoi ord cuardaigh an oibreora ponc in:ref: doiciméadú athróga teimpléad.
Socraíonn an lúb for roinnt athróg atá ar fáil laistigh den lúb:
Athraitheach |
Cur síos |
|---|---|
|
Athraitheadh reatha an lúb (1-innéacsaithe) |
|
An t-athrú reatha ar an lúb (0-innéacsaithe) |
|
Líon na n-athrá ó dheireadh an lúb (1-innéacsaithe) |
|
Líon na n-athrá ó dheireadh an lúb (0-innéacsaithe) |
|
Fíor más é seo an chéad uair tríd an lúb |
``forloop.last `` |
Fíor más é seo an uair dheireanach tríd an lúb |
|
Maidir le lúb neadaithe, is é seo an lúb timpeall leis an gceann reatha |
``... folamLink to this heading
Is féidir leis an gclib for clásal roghnach {% folamh%} a thógáil a thaispeántar a théacs má tá an eagar tugtha folamh nó mura bhféadfaí é a aimsiú:
<ul>
{% for athlete in athlete_list %}
<li>{{ athlete.name }}</li>
{% empty %}
<li>Sorry, no athletes in this list.</li>
{% endfor %}
</ul>
Tá an méid thuas comhionann le - ach níos giorra, níos glaine, agus b'fhéidir níos gasta ná - an méid seo a leanas:
<ul>
{% if athlete_list %}
{% for athlete in athlete_list %}
<li>{{ athlete.name }}</li>
{% endfor %}
{% else %}
<li>Sorry, no athletes in this list.</li>
{% endif %}
</ul>
``má `Link to this heading
Déanann an chlib {% if%} meastóireacht ar athróg, agus má tá an athróg sin “fíor” (ie ann, níl sé folamh, agus ní luach boolean bréagach é) tá ábhar an bhloc aschur:
{% 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}}.
Mar a fheiceann tú, féadfaidh clásal {% elif%} `amháin nó roinnt clásal {% elif%} a thógáil, chomh maith le clásal {% else%} ``a thaispeánfar má theipeann ar gach coinníoll roimhe seo. Tá na clásail seo roghnach.
Oibreoirí BooleanLink to this heading
if tags may use and, or or not to test a number of
variables or to negate a given variable:
{% if athlete_list and coach_list %}
Both athletes and coaches are available.
{% endif %}
{% if not athlete_list %}
There are no athletes.
{% endif %}
{% if athlete_list or coach_list %}
There are some athletes or some coaches.
{% endif %}
{% if not athlete_list or coach_list %}
There are no athletes or there are some coaches.
{% endif %}
{% if athlete_list and not coach_list %}
There are some athletes and absolutely no coaches.
{% endif %}
Ceadaítear clásail agus ``nó ``araon a úsáid laistigh den chlib céanna, agus tosaíocht níos airde ag ``agus ná nó `, m.sh.:
{% if athlete_list and coach_list or cheerleader_list %}
léirmhínítear mar:
if (athlete_list and coach_list) or cheerleader_list:
...
Úsáid lúibíní iarbhír sa chlib: ttag: `if `is comhréir neamhbhailí. Má theastaíonn uait chun tosaíocht a léiriú, ba cheart duit clibeanna nested:ttag: `if a úsáid.
if tags may also use the operators ==, !=, <, >,
<=, >=, in, not in, is, and is not which work as
follows:
== oibreoirLink to this heading
Comhionannas. Sampla:
{% if somevar == "x" %}
This appears if variable somevar equals the string "x"
{% endif %}
! = oibreoirLink to this heading
Éagothroime. Sampla:
{% if somevar != "x" %}
This appears if variable somevar does not equal the string "x",
or if somevar is not found in the context
{% endif %}
< oibreoirLink to this heading
Níos lú ná. Sampla:
{% if somevar < 100 %}
This appears if variable somevar is less than 100.
{% endif %}
> oibreoirLink to this heading
Níos mó ná. Sampla:
{% if somevar > 0 %}
This appears if variable somevar is greater than 0.
{% endif %}
<= oibreoirLink to this heading
Níos lú ná nó cothrom le. Sampla:
{% if somevar <= 100 %}
This appears if variable somevar is less than 100 or equal to 100.
{% endif %}
>= oibreoirLink to this heading
Níos mó ná nó comhionann leis. Sampla:
{% if somevar >= 1 %}
This appears if variable somevar is greater than 1 or equal to 1.
{% endif %}
Oibreoir inLink to this heading
Ag fáil laistigh. Tacaíonn go leor coimeádáin Python leis an oibreoir seo chun tástáil a dhéanamh an bhfuil an luach a thugtar sa choimeádán. Seo a leanas roinnt samplaí den chaoi a léirmhínítear x in y:
{% if "bc" in "abcdef" %}
This appears since "bc" is a substring of "abcdef"
{% endif %}
{% if "hello" in greetings %}
If greetings is a list or set, one element of which is the string
"hello", this will appear.
{% endif %}
{% if user in users %}
If users is a QuerySet, this will appear if user is an
instance that belongs to the QuerySet.
{% endif %}
Oibreoir ``nach bhfuil i `Link to this heading
Níl ann laistigh. Is é seo diúltú an oibreora in.
``Is ``oibreoirLink to this heading
Féiniúlacht réada. Tástálacha má tá dhá luach an réad céanna. Sampla:
{% if somevar is True %}
This appears if and only if somevar is True.
{% endif %}
{% if somevar is None %}
This appears if somevar is None, or if somevar is not found in the context.
{% endif %}
``ní 'oibreoir'Link to this heading
Féiniúlacht réad diúltaithe. Tástálacha mura bhfuil dhá luach an rud céanna. Is é seo diúltú an oibreora ``is ``. Sampla:
{% if somevar is not True %}
This appears if somevar is not True, or if somevar is not found in the
context.
{% endif %}
{% if somevar is not None %}
This appears if and only if somevar is not None.
{% endif %}
ScagairíLink to this heading
Is féidir leat scagairí a úsáid freisin sa léir:ttag: `if `. Mar shampla:
{% if messages|length >= 100 %}
You have lots of messages today!
{% endif %}
Nathanna castaLink to this heading
Is féidir gach ceann de na nithe thuas a chomhcheangal chun nathanna casta a fhoirmiú Maidir le nathanna den sórt sin, d'fhéadfadh sé a bheith tábhachtach a fháil amach conas a ghrúpáiltear na hoibreoirí nuair a dhéantar an abairt a mheas - is é sin, na rialacha tosaíochta. Is é seo a leanas tosaíocht na n-oibreoirí, ón ísle go dtí an airde:
(Leanann sé seo Python go díreach). Mar sin, mar shampla, an casta seo a leanas: ttag: `if `tag:
{% if a == b or c == d and e %}
Déanfar... léirmhíniú mar:
(a == b) or ((c == d) and e)
Má theastaíonn tosaíocht dhifriúil uait, beidh ort clibeanna nested:ttag: `if `a úsáid. Uaireanta bíonn sé sin níos fearr le haghaidh soiléireachta ar aon nós, ar mhaithe leo siúd nach bhfuil a fhios acu na rialacha tosaíochta.
Ní féidir na hoibreoirí comparáide a 'slabhraithe' cosúil le Python nó i nótaí matamaitice. Mar shampla, in ionad úsáid a bhaint as:
{% if a > b > c %} (WRONG)
ba chóir duit úsáid a bhaint as:
{% if a > b and b > c %}
``má athraíthí'Link to this heading
Seiceáil an bhfuil luach athraithe ón athrú deireanach de lúb.
Úsáidtear an chlib bloc {% ifchanged%} laistigh de lúb. Tá dhá úsáid féideartha aige.
Seiceálann sé a ábhar rindreáilte féin i gcoinne a staid roimhe seo agus ní thaispeánann sé an t-ábhar ach má Mar shampla, taispeánann sé seo liosta laethanta, ag taispeáint an mhí ach má athraíonn sé:
<h1>Archive for {{ year }}</h1> {% for date in days %} {% ifchanged %}<h3>{{ date|date:"F" }}</h3>{% endifchanged %} <a href="{{ date|date:"M/d"|lower }}/">{{ date|date:"j" }}</a> {% endfor %}Má thugtar athróg amháin nó níos mó, seiceáil an bhfuil athróg ar bith athraithe. Mar shampla, taispeánann an méid seo a leanas an dáta gach uair a athraíonn sé, agus an uair a thaispeánann sé má athraigh an uair an chloig nó an dáta:
{% for date in days %} {% ifchanged date.date %} {{ date.date }} {% endifchanged %} {% ifchanged date.hour date.date %} {{ date.hour }} {% endifchanged %} {% endfor %}
Is féidir leis an gclib if changed clásal roghnach ``{% else%} `a thógáil freisin a thaispeánfar mura bhfuil an luach athraithe:
{% for match in matches %}
<div style="background-color:
{% ifchanged match.ballot_id %}
{% cycle "red" "blue" %}
{% else %}
gray
{% endifchanged %}
">{{ match }}</div>
{% endfor %}
``san áireamh ``Link to this heading
Luchtaíonn sé teimpléad agus déanann sé leis an gcomhthéacs reatha é. Is bealach é seo chun teimpléid eile a “áireamh” laistigh de theimpléad.
Is féidir le hainm an teimpléid a bheith ina athróg nó ina shreang crua-chódaithe (luaite), i luachana aonair nó dúbailte.
Cuimsíonn an sampla seo ábhar an teimpléid ” foo/bar.html “:
{% include "foo/bar.html" %}
De ghnáth bíonn ainm an teimpléid i gcoibhneas le eolaire fréimhe an lódóra Féadfaidh argóint teaghrán a bheith ina cosán coibhneasta freisin ag tosú le ./ nó .. / mar a thuairiscítear sa chlibe:ttag: extens.
Cuimsíonn an sampla seo ábhar an teimpléid a bhfuil a ainm san athróg template_name:
{% include template_name %}
Féadfaidh an t-athróg a bheith ina rud ar bith le modh render () ``a ghlacann le comhthéacs. Ligeann sé seo duit tagairt a thabhairt do ``Teimpléad tiomsaithe i do chomhthéacs.
Ina theannta sin, d'fhéadfadh go mbeadh an t-athróg ina athraitheach d'ainmneacha teimpléad, agus sa chás sin úsáidfear an chéad cheann is féidir a luchtú, mar per:func: ~django.template.loader.select_template.
Déantar teimpléad san áireamh ar fáil laistigh de chomhthéacs an teimpléid a chuimsíonn é. Táirgeann an sampla seo an t-aschur ``"Dia duit, John!” ``:
Comhthéacs: tá athróg
`duine ``socraithe go ``"John"agus socraítear athróg`grántgo`Hello".Teimpléad:
{% include "name_snippet.html" %}An teimpléad
name_snippet.html:{{ greeting }}, {{ person|default:"friend" }}!
Is féidir leat comhthéacs breise a chur ar aghaidh chuig an teimpléad ag baint úsáide as
{% include "name_snippet.html" with person="Jane" greeting="Hello" %}
Más mian leat an comhthéacs a rinneadh ach leis na hathróga a chuirtear ar fáil (nó fiú gan aon athróg ar chor ar bith), bain úsáid as an rogha ``amháin ``. Níl aon athróga eile ar fáil don teimpléad san áireamh:
{% include "name_snippet.html" with greeting="Hi" only %}
`ualachLink to this heading
Luchtaíonn sé tacar clib teimpléad saincheaptha.
Mar shampla, luchtálfadh an teimpléad seo a leanas na clibeanna agus na scagairí go léir atá cláraithe i somelibrary agus leabharlann eile ``atá lonnaithe i bpacáiste ``pacáist:
{% load somelibrary package.otherlibrary %}
Is féidir leat scagairí nó clibeanna aonair ó leabharlann a luchtú go roghnach freisin, ag baint úsáide as an argóint ó ``. Sa sampla seo, luchtálfar na clibeanna/scagairí teimpléad darb ainm ``foo agus bar ó somelibrary`:
{% load foo bar from somelibrary %}
Féach: doc: `Clib saincheaptha agus leabharlanna scagair' le haghaidh tuilleadh faisnéise. </howto/custom-template-tags>
LoremLink to this heading
Taispeánann sé téacs Laidineach randamach “torem ipsum”. Tá sé seo úsáideach chun sonraí samplacha a sholáthar i dteimpléid.
Úsáid:
{% lorem [count] [method] [random] %}
Is féidir an chlib {% lorem%} a úsáid le nialas, aon, dhá nó trí argóint. Is iad na hargóintí:
Argóint |
Cur síos |
|---|---|
|
Uimhir (nó athróg) ina bhfuil líon na míreanna nó na bhfocal le giniúint (is é 1 réamhshocraithe). |
|
Ceachtar |
|
An focal |
Samplaí:
{% lorem%}aschur an mhír choitianta “lorem ipsum”.<p>Aschur
{% lorem 3 p%} `an mhír choitianta “lorem ipsum” agus dhá mhír randamach gach ceann atá fillte i gclibeanna HTML`.Aschur
{% lorem 2 w randamach%}dhá fhocal randamacha Laidine.
anoisLink to this heading
Taispeánann sé an dáta agus/nó an t-am reatha, ag baint úsáide as formáid de réir an teaghrán tugtha. Is féidir carachtair sonraitheoirí formáide a bheith i sreang den sórt sin mar a thuairiscítear sa chuid scagaire: tfilter: dáta.
Sampla:
It is {% now "jS F Y H:i" %}
Tabhair faoi deara gur féidir leat teaghrán formáide a éalú ar ais más mian leat an luach “amh” a úsáid. Sa sampla seo, tá “o” agus “f” araon éalaithe le cúltaca, mar ar shlí eile is teaghrán formáide é gach ceann acu a thaispeánann an bhliain agus an t-am, faoi seach:
It is the {% now "jS \o\f F" %}
Taispeánfaí sé seo mar “Is é an 4 Meán Fómhair é”.
Is féidir leat an comhréir {% now “Y” a úsáid mar current_year%} chun an t-aschur (mar shreang) a stóráil taobh istigh d'athróg. Tá sé seo úsáideach más mian leat {% now%} a úsáid taobh istigh de chlib teimpléad cosúil:ttag: blocktranslate mar shampla:
{% now "Y" as current_year %}
{% blocktranslate %}Copyright {{ current_year }}{% endblocktranslate %}
ceisteanna ceisteLink to this heading
Aschur sreang ceisteanna formáidithe ionchódaithe URL bunaithe ar na paraiméadair a chuirtear ar fáil.
<django.http.HttpRequest.GET>Éilíonn an chlib seo a: class: ~django.http.QueryDict sampla, atá réamhshocraithe to:attr: `request.get `mura gcuirtear aon rud ar fáil.
If the QueryDict is empty and no additional parameters
are provided, an empty string is returned. Otherwise, the result includes a
leading "?".
Úsáid bunúsachLink to this heading
{% querystring %}
Aisíonn sé an teaghrán fiosrúcháin reatha focal focal. Mar sin má tá an teaghrán ceisteanna ? dath = glas ``, bheadh an t-aschur? dath = glas ``.
{% querystring size="M" %}
Aisíonn sé an teaghrán fiosrúcháin reatha leis an bparaiméadar ``méid ``a chur leis. Tar éis an sampla roimhe seo, bheadh an t-aschur ``? Dath = glas & Méid = M ``.
QueryDict SaincheapthaLink to this heading
{% querystring my_query_dict %}
Is féidir leat saincheaptha QueryDict a sholáthar le húsáid in ionad request.get. <QueryDict: {'color': ['blue']} >Mar sin má tá my_query_dict ``, aschur seo `? dath = gorm ``.
Míreanna a shocrúLink to this heading
{% querystring color="red" size="S" %}
Cuireann sé nó modhnóidh sé paraiméadair sa sreang fiosrúcháin. Cuirfear gach argóint eochairfhocal leis an sreangán fiosrúcháin, ag ionad aon luach atá ann cheana don eochair sin. Mar shampla, más é an teaghrán ceisteanna reatha? dath = glas ``, beidh an t-aschur? Dath = dearg & Méid = S ``.
Míreanna a bhaintLink to this heading
{% querystring color=None %}
Ag dul None ``mar an luach baineann an paraiméadar ón sreang fiosrúcháin. Mar shampla, más é ``an teaghrán fiosrúcháin reatha? Dath = glas & méid = M ``, beidh an t-aschur? Méid = m ``.
Liosta láimhseálaLink to this heading
{% querystring color=my_list %}
Má tá my_list ["dearg”, “gorm"], beidh an t-aschur ``? color = red&color = gorm ``, ag caomhnú struchtúr an liosta sa sreang ceisteanna.
Úsáid dinimiciúilLink to this heading
Sampla coitianta den chlib seo a úsáid is ea an sreang ceisteanna reatha a chaomhnú agus leathanach torthaí á thaispeáint, agus nasc á chur leis na chéad leathanaigh eile agus roimhe seo de na torthaí. Mar shampla, má tá an paginator ar leathanach 3 faoi láthair, agus is é an teaghrán ceisteanna reatha ? color=gorm&size = M&page = 3, aschur an cód seo a leanas ? Dath = gorm&méid = M & page = 4:
{% querystring page=page.next_page_number %}
Is féidir leat an luach a stóráil in athróg freisin. Mar shampla, má theastaíonn iliomad naisc uait leis an leathanach céanna, sainmhínigh é mar:
{% querystring page=page.next_page_number as next_page %}
athghrúpaLink to this heading
Athghrúpaíonn sé liosta de na rudaí céanna de réir tréith choiteann.
Is fearr an chlib casta seo a léiriú trí shampla: abair gur liosta cathracha é cathracha a léiríonn foclóirí ina bhfuil `"ainm", ``daonra", agus ``tír" eochracha:
cities = [
{"name": "Mumbai", "population": "19,000,000", "country": "India"},
{"name": "Calcutta", "population": "15,000,000", "country": "India"},
{"name": "New York", "population": "20,000,000", "country": "USA"},
{"name": "Chicago", "population": "7,000,000", "country": "USA"},
{"name": "Tokyo", "population": "33,000,000", "country": "Japan"},
]
... agus ba mhaith leat liosta ordlathach a ordaítear de réir tíre a thaispeáint, mar seo:
An India
Mumbai: 19,000,000
Calcutta: 15,000,000
STÁIT AONTAITHE
Nua Eabhrac: 20,000,000
Chicago: 7,000,000
An tSeapáin
Tóiceo: 33,000,000
Is féidir leat an chlib {% regroup%} a úsáid chun liosta na gcathracha a ghrúpáil de réir tíre. Chuirfeadh an snippet seo a leanas de chód teimpléid i gcrích é seo:
{% regroup cities by country as country_list %}
<ul>
{% for country in country_list %}
<li>{{ country.grouper }}
<ul>
{% for city in country.list %}
<li>{{ city.name }}: {{ city.population }}</li>
{% endfor %}
</ul>
</li>
{% endfor %}
</ul>
Siúlóimid tríd an sampla seo. {% regroup%} tógann trí argóint: an liosta is mian leat a athghrúpáil, an tréith le grúpáil leis, agus ainm an liosta mar thoradh air. Anseo, táimid ag athghrúpáil an liosta cathr de réir an tréith `country ``agus glaoimid ar an toradh ``lista_country.
Léirgeann {% regroup%} `liosta (sa chás seo, ``country_list) d'rudaí grúpa. Is cásanna iad rudaí grúpa de:py:func: ~collections.namedtuple le dhá réimse:
Grúpa- an mír a rinneadh grúpáil le (m.sh., an sreang “India” nó “An tSeapáin”).liosta- liosta de na míreanna uile sa ghrúpa seo (m.sh., liosta de na cathracha go léir le tír = 'India').
Toisc go dtáirgeann {% regroup%}: py:func: ~collections.namedtuple rudaí, is féidir leat an sampla roimhe seo a scríobh mar:
{% regroup cities by country as country_list %}
<ul>
{% for country, local_cities in country_list %}
<li>{{ country }}
<ul>
{% for city in local_cities %}
<li>{{ city.name }}: {{ city.population }}</li>
{% endfor %}
</ul>
</li>
{% endfor %}
</ul>
Tabhair faoi deara nach n-ordaíonn {% regroup%} a ionchur! Braitheann ár sampla ar an bhfíric gur ordaigh “tír” an liosta cathr sa chéad áit. Dá n-ordódh liosta na cathracha ```````````````baill ``````````````````````, ní dhéanfadh an t-athghrúpáil níos mó ná grúpa amháin go naif do thír amháin. Mar shampla, abair go raibh an liosta ``cathracha ``socraithe chuige seo (tabhair faoi deara nach bhfuil na tíortha grúpáilte le chéile):
cities = [
{"name": "Mumbai", "population": "19,000,000", "country": "India"},
{"name": "New York", "population": "20,000,000", "country": "USA"},
{"name": "Calcutta", "population": "15,000,000", "country": "India"},
{"name": "Chicago", "population": "7,000,000", "country": "USA"},
{"name": "Tokyo", "population": "33,000,000", "country": "Japan"},
]
Leis an ionchur seo do cathracha `, bheadh an t-aschur seo a leanas mar thoradh ar an gcód teimpléad`` {% athghrúpaí%} `thuas:
An India
Mumbai: 19,000,000
STÁIT AONTAITHE
Nua Eabhrac: 20,000,000
An India
Calcutta: 15,000,000
STÁIT AONTAITHE
Chicago: 7,000,000
An tSeapáin
Tóiceo: 33,000,000
Is é an réiteach is éasca ar an gotcha seo ná a chinntiú i do chód amharc go ndéantar na sonraí a ordú de réir an chaoi ar mhaith leat iad a thaispeáint.
Réiteach eile is ea na sonraí sa teimpléad a shórtáil ag baint úsáide as an scagair:tfilter: dictsort, má tá do chuid sonraí i liosta foclóirí:
{% regroup cities|dictsort:"country" by country as country_list %}
Grúpáil ar airíonna eileLink to this heading
Is tréith grúpála dlíthiúil é aon chuardach teimpléad bailí don chlib athghrúpála, lena n-áirítear modhanna, tréithe, eochracha foclóra agus míreanna liosta. Mar shampla, más eochair eachtrach é an réimse “tíre” do rang le tréith “cur síos”, d'fhéadfá úsáid a bhaint as:
{% regroup cities by country.description as country_list %}
Nó, más réimse é country ```roghanna, beidh a: meth: ~django.db.models.model.get_foo_display modh ar fáil mar thréith, rud a ligfidh duit grúpáil ar an teaghrán taispeána seachas an eochair ``roghanna ``:
{% regroup cities by get_country_display as country_list %}
Taispeánfaidh {{country.grouper}} anois na réimsí luacha ón tacar roghna seachas na heochracha.
athshocraitheachLink to this heading
Athshocraíonn sé “timthriall” roimhe seo ionas go dtosóidh sé óna chéad mhír ag an gcéad teagmháil eile. Gan argóintí, athshocróidh {% resetcycle%} `an {% timthriall%}` deireanach a shainmhínítear sa teimpléad.
Úsáid sampla:
{% for coach in coach_list %}
<h1>{{ coach.name }}</h1>
{% for athlete in coach.athlete_set.all %}
<p class="{% cycle 'odd' 'even' %}">{{ athlete.name }}</p>
{% endfor %}
{% resetcycle %}
{% endfor %}
Chuirfeadh an sampla seo ar ais an HTML seo:
<h1>Gareth</h1>
<p class="odd">Harry</p>
<p class="even">John</p>
<p class="odd">Nick</p>
<h1>John</h1>
<p class="odd">Andrea</p>
<p class="even">Melissa</p>
Tabhair faoi deara conas a chríochnaíonn an chéad bloc le class="odd" agus tosaíonn an ceann nua le class="odd". Gan an chlib {% resetcycle%}, tosódh an dara bloc le class="even".
Is féidir leat clibeanna timthriall ainmnithe a athshocrú freisin:
{% for item in list %}
<p class="{% cycle 'odd' 'even' as stripe %} {% cycle 'major' 'minor' 'minor' 'minor' 'minor' as tick %}">
{{ item.data }}
</p>
{% ifchanged item.category %}
<h1>{{ item.category }}</h1>
{% if not forloop.first %}{% resetcycle tick %}{% endif %}
{% endifchanged %}
{% endfor %}
Sa sampla seo, tá na sraitheanna neamhghair/fiú malartacha againn agus sraith “mór” gach cúigiú sraith. Ní athshocraítear ach an timthriall cúig shraith nuair a athraíonn catagóir.
``gan spás ``Link to this heading
Baineann sé spás bán idir clibeanna HTML. Cuimsíonn sé seo carachtair cluaisín agus línte nua.
Úsáid sampla:
{% spaceless %}
<p>
<a href="foo/">Foo</a>
</p>
{% endspaceless %}
Chuirfeadh an sampla seo ar ais an HTML seo:
<p><a href="foo/">Foo</a></p>
Ní bhaintear ach spás idir tags - ní spás idir clibeanna agus téacs. Sa sampla seo, ní scriosfar an spás timpeall Hello:
{% spaceless %}
<strong>
Hello
</strong>
{% endspaceless %}
Teimpléad tagLink to this heading
Aschur ceann de na carachtair chomhréireachta a úsáidtear chun clibeanna teimpléad
Níl aon choincheap ag an gcóras teimpléid maidir le carachtair aonair “éalú”. Mar sin féin, is féidir leat an chlib {% templatetag%} a úsáid chun ceann de na teaglaim carachtair clib teimpléad a thaispeáint.
Insíonn an argóint cén giotán teimpléid atá le haschur:
Argóint |
Aschuir |
|---|---|
|
|
|
``%} `` |
|
|
|
|
|
|
|
|
|
|
|
``#} `` |
Úsáid samplach:
The {% templatetag openblock %} characters open a block.
Féach freisin an clibe:ttag: verbatim le haghaidh bealach eile chun na carachtair seo a áireamh.
UrlLink to this heading
Tugann tagairt cosán iomlán ar ais (URL gan ainm fearainn) a mheaitseálann radharc ar leith agus paraiméadair roghnacha. Déanfar aon charachtair speisialta sa chosán mar thoradh air a ionchódú ag baint úsáide as: func: ~django.utils.encoding.iri_to_uri.
Is bealach é seo chun naisc a aschur gan prionsabal DRY a shárú trí URLanna a chódú crua i do theimpléid:
{% url 'some-url-name' v1 v2 %}
<naming-url-patterns>Is é an chéad argóint a:ref: `Ainm patrún URL `. Is féidir é a bheith ina athróg litriúil nó aon athróg comhthéacs eile. Tá argóintí breise roghnach agus ba cheart go mbeadh luachanna scartha ó spás iad a úsáidfear mar argóintí san URL. Taispeánann an sampla thuas ag rith argóintí seasaimh. De rogha air is féidir leat comhréir eochairfhocal a úsáid:
{% url 'some-url-name' arg1=v1 arg2=v2 %}
Ná déan comhréir seasmhach agus eochairfhocal a mheascadh i nglao amháin. Ba chóir go mbeadh gach argóint a éilíonn ag an URLConf i láthair.
Mar shampla, cuir i gcás go bhfuil amharc agat, app_views.client, a ghlacann a URLConf ID cliant (anseo, client () `modh taobh istigh den chomhad tuairimí ``app_views.py`). D'fhéadfadh cuma seo a bheith ar líne URLConf:
path("client/<int:id>/", app_views.client, name="app-views-client")
Má tá URLConf an aip seo san áireamh i URLConf an tionscadail faoi chonair mar seo:
path("clients/", include("project_name.app_name.urls"))
... ansin, i dteimpléad, is féidir leat nasc a chruthú leis an radharc seo mar seo:
{% url 'app-views-client' client.id %}
Aschróidh an chlib teimpléid an sreang /cliant/cliant/123/.
Tabhair faoi deara mura bhfuil an URL atá á aisiompú agat ann, gheobhaidh tú eisceacht: exc: ~django.urls.noReverseMatch ardaithe, rud a fhágfaidh go dtaispeánfaidh do shuíomh leathanach earráide.
Más mian leat URL a aisghabháil gan é a thaispeáint, is féidir leat glao beagán difriúil a úsáid:
{% url 'some-url-name' arg arg2 as the_url %}
<a href="{{ the_url }}">I'm linking to {{ the_url }}</a>
Is é raon feidhme an athróg a chruthaíonn an chomhréir as var` an {% block%} ina bhfuil an chlib {% url%} le feiceáil.
Ní chuirfidh an comhréir seo {% url... as var%} ** ina chúis le earráid má tá an radharc ar iarraidh. Go praiticiúil úsáidfidh tú é seo chun nasc a dhéanamh le tuairimí atá roghnach:
{% url 'some-url-name' as the_url %}
{% if the_url %}
<a href="{{ the_url }}">Link to optional stuff</a>
{% endif %}
Más mian leat URL spás ainmneacha a aisghabháil, sonraigh an t-ainm láncháilithe:
{% url 'myapp:view-name' %}
Leanfaidh sé seo an straitéis gnáth:ref: `ainmspaced URL <topics-http-reversing-url-namespaces>', lena n-áirítear aon leideanna a sholáthraíonn an comhthéacs maidir leis an bhfeidhmchlár reatha a úsáid.
VerbatimLink to this heading
Stopann inneall an teimpléid ó ábhar an chlib bloc seo a léiriú.
Úsáid choitianta ná ciseal teimpléad JavaScript a cheadú a imbhuaileann le comhréir Django. Mar shampla:
{% verbatim %}
{{if dying}}Still alive.{{/if}}
{% endverbatim %}
Is féidir leat clib deiridh sonrach a ainmniú freisin, rud a cheadaíonn úsáid {% endverbatim%} mar chuid den ábhar neamh-rindreáilte:
{% verbatim myblock %}
Avoid template rendering via the {% verbatim %}{% endverbatim %} block.
{% endverbatim myblock %}
``Leithead leithead`Link to this heading
Chun barrachairteacha agus dá leithéid a chruthú, ríomhann an clib seo cóimheas luach ar leith go luach uasta, agus ansin cuireann an cóimheas sin i bhfeidhm ar thairiseach.
Mar shampla:
<img src="bar.png" alt="Bar"
height="10" width="{% widthratio this_value max_value max_width %}">
Má tá luach_seo ``175, `luach_maxe 200, agus max_width 100, beidh an íomhá sa sampla thuas 88 picteilín ar leithead (mar 175/200 = .875; .875 * 100 = 87.5 atá cruinn suas go dtí 88).
I roinnt cásanna b'fhéidir gur mhaith leat toradh ``leithead` a ghabháil in athróg. Is féidir leis a bheith úsáideach, mar shampla, in a:ttag: blocktranslate mar seo:
{% widthratio this_value max_value max_width as width %}
{% blocktranslate %}The width is: {{ width }}{% endblocktranslate %}
Invalid section title or transition marker.Link to this heading
Cuireann sé athróg casta faoi ainm níos simplí. Tá sé seo úsáideach agus tú ag rochtain ar mhodh “daor” (m.sh., ceann a bhuaileann an bunachar sonraí) arís agus arís eile.
Mar shampla:
{% with total=business.employees.count %}
{{ total }} employee{{ total|pluralize }}
{% endwith %}
Níl an t-athróg daonra (sa sampla thuas, iomlán ``) ar fáil ach idir na clibeanna {% with%} agus {% endwith%} ``.
Is féidir leat níos mó ná athróg comhthéacs amháin a shannadh:
{% with alpha=1 beta=2 %}
...
{% endwith %}
Tagairt scagaire tógthaLink to this heading
``Cuir leis ``Link to this heading
Cuireann sé an argóint leis an luach.
Mar shampla:
{{ value|add:"2" }}
Más é `luach 4, ansin is é 6 an t-aschur.
Déanfaidh an scagaire seo iarracht an dá luach a chur i bhfeidhm go sláimhreacha ar dtús. Má theipeann sé seo, déanfaidh sé iarracht na luachanna a chur le chéile ar aon nós. Oibreoidh sé seo ar roinnt cineálacha sonraí (teaghráin, liosta, srl.) agus teipeann sé ar dhaoine eile. Má theipeann air, beidh an toradh ina shreang folamh.
Mar shampla, má tá:
{{ first|add:second }}
agus is é chéad `` [1, 2, 3] agus ``an dara is é [4, 5, 6] , ansin is é [1, 2, 3, 4, 5, 6] ``an t-aschur.
AddslashesLink to this heading
Cuireann sé slashes roimh luachana. Úsáideach chun teaghráin a éalú i CSV, mar shampla.
Mar shampla:
{{ value|addslashes }}
Más é luach `Táim ag úsáid Django", beidh an t-aschur "Táim ag úsáid Django".
capfirstLink to this heading
Caipitlíonn sé an chéad charachtar den luach. Mura litir é an chéad charachtar, níl aon éifeacht ag an scagaire seo.
Mar shampla:
{{ value|capfirst }}
Más é luach django", is é "Django" an t-aschur.
IonadLink to this heading
Díríonn an luach i réimse de leithead ar leith.
Mar shampla:
"{{ value|center:"15" }}"
Más é luach Django"`, is é ``” Django “ an t-aschur.
gearrthLink to this heading
Baineann gach luach arg as an sreang tugtha.
Mar shampla:
{{ value|cut:" " }}
Más é luach ``"Sreang le spásanna” ``, is é an t-aschur ``"Stringwithspaces"`.
``Dáta ``Link to this heading
Formálaíonn sé dáta de réir an fhormáide a thugtar.
Úsáideann sé formáid den chineál céanna le feidhm `date (`_ PHP < https://www.php.net/manual/en/function.date.php> le roinnt difríochtaí.
Teagáin formáid atá ar fáil:
Carachtar formáid |
Cur síos |
Aschur sampla |
|---|---|---|
Lae |
||
|
Lá na míosa, 2 dhigit le nialas tosaigh. |
|
|
Lá na míosa gan nialas tosaigh. |
|
|
Lá na seachtaine, téacsúil, 3 litir. |
|
|
Lá na seachtaine, téacsúil, fada. |
|
|
Iarmhír ordúil Béarla do lá na míosa, 2 charachtar. |
|
|
Lá na seachtaine, digití gan nialas tosaigh. |
|
|
Lá na bliana. |
|
Seachtain |
||
|
Líon seachtaine na bliana ISO-8601, le seachtainí ag tosú Dé Luain. |
|
Mí |
||
|
Mí, 2 dhigit le nialas tosaigh. |
|
|
Mí gan nialais tosaigh. |
|
|
Mí, téacsúil, 3 litir. |
|
|
Mí, téacsach, 3 litir, litreacha beaga. |
|
|
Mí, ionadaíocht mhalartach áitiúil a úsáidtear de ghnáth le haghaidh ionadaíocht dáta fada. |
|
|
Mí, téacsúil, fada. |
|
|
Giorrúchán míosa i stíl Associated Press. Síneadh dílseánaigh. |
|
``t `` |
Líon na laethanta sa mhí ar leith. |
|
Bliain |
||
|
Bliain, 2 dhigit le nialas tosaigh. |
|
|
Bliain, 4 dhigit le nialas tosaigh. |
|
|
Boolean maidir le cibé an bhliain léim í. |
|
|
Bliain uimhrithe seachtaine ISO-8601, a fhreagraíonn d'uimhir seachtaine ISO-8601 (W) a úsáideann seachtainí léim. Féach Y don fhormáid bliana níos coitianta. |
|
Aim |
||
|
Uair an chloig, formáid 12 uair an chloig gan nialas tosaigh. |
|
|
Uair an chloig, formáid 24 uair an chloig gan nialas tosaigh. |
|
|
Uair an chloig, formáid 12 uair an chloig. |
|
|
Uair, formáid 24 uair an chloig. |
|
``I ` |
Miontuairiscí |
|
|
Soicind, 2 dhigit le nialas tosaigh. |
|
|
Micreasoicind. |
|
|
``a.m.' nó ``p.m.' (Tabhair faoi deara go bhfuil sé seo beagán difriúil ná aschur PHP, toisc go n-áirítear tréimhsí seo chun stíl Associated Press a mheaitseáil.) |
|
|
|
|
|
Am, in uair an chloig agus nóiméad 12 uair an chloig, le nóiméid fágtha má tá siad nialas. Síneadh dílseánaigh. |
|
|
Am, i 12 uair an chloig, nóiméad agus 'a.m.' /'p.m. ', le nóiméid fágtha má tá siad nialas agus na teaghráin cásanna speisialta' meán oíche 'agus' meán lae 'más cuí. Síneadh dílseánaigh. |
|
Crios Ama |
||
|
Ainm crios ama. D'fhéadfadh sé a bheith i bhformáid ar bith, nó d'fhéadfadh sé teaghrán folamh a thabhairt ar ais, ag brath ar an dáta-am. |
|
``I ` |
Am sábhála solais an lae, cibé an bhfuil sé i bhfeidhm nó nach bhfuil. |
|
|
Difríocht le am Greenwich in uaireanta. |
|
``T `` |
Crios ama an mheaisín seo. |
|
|
Fhritháireamh crios ama i soicindí. Tá an fhritháireamh do chóin ama siar ó UTC diúltach i gcónaí, agus dóibh siúd ó thoir UTC tá sé dearfach i gcónaí. |
|
Dáta/Aim |
||
|
Formáid ISO 8601. (Nóta: murab ionann agus formáidithe eile, mar shampla “Z”, “O” nó “r”, ní chuirfidh an formáiditheoir “c” fritháireamh crios ama más dáta naif é an luach (féach:class: datetime.tzinfo). |
|
|
<5322 #section -3.3>:rfc: RFC 5322 dáta formáidithe. |
|
|
Soicind ó Eocha Unix (1 Eanáir 1970 00:00:00 UTC). |
Mar shampla:
{{ value|date:"D d M Y" }}
Más rud é: py:class: ~datetime.datetime réad value (m.sh., toradh datetime.datetime.now () ``), is é an t-aschur an teaghrán ``'Céad 09 Ean 2008'.
Is féidir leis an bhformáid a rith a bheith ar cheann de na cinn réamhshainithe: setting: DATE_FORMAT, :setting: DATETIME_FORMAT, :setting: SHORT_DATE_FORMAT nó:setting: SHORT_DATETIME_FORMAT, nó formáid saincheaptha a úsáideann na sonraitheoirí formáide a thaispeántar sa tábla thuas. Tabhair faoi deara go bhféadfadh formáidí réamhshainithe athrú ag brath ar an áitiúil reatha.
Ag glacadh leis gur:setting: LANGUAGE_CODE, mar shampla, "es", ansin le haghaidh:
{{ value|date:"SHORT_DATE_FORMAT" }}
is é an t-aschur an teaghrán "09/01/2008" ``(is é ``"D/M/Y" an sonraitheoir formáid "SHORT_DATE_FORMAT” don áitiúil ``es ``mar a sheoltar le Django).
Nuair a úsáidtear é gan teaghrán formáide, úsáidtear an sonraitheoir formáide ``DATE_FORMAT ``. Ag glacadh leis na socruithe céanna leis an sampla roimhe seo:
{{ value|date }}
aschuir 9 Eanáir 2008 (is é r'jde Fde Fde Y'` an sonraitheoir formáid DATE_FORMAT ``don `es áitiúil es). Tá “d” agus “e” araon éalaithe le cúltaca, mar ar shlí eile is teaghrán formáide é gach ceann acu a thaispeánann an lá agus ainm an crios ama, faoi seach.
Is féidir leat dáta ``a chur le chéile leis an scagair:tfilter: `time` chun léiriú iomlán a thabhairt ar luach ``datetime. M.sh.:
{{ value|date:"D d M Y" }} {{ value|time:"H:i" }}
réamhshocraitheLink to this heading
Má mheastóidh luach go False, úsáideann sé an réamhshocrú tugtha. Seachas sin, úsáideann sé an luach.
Mar shampla:
{{ value|default:"nothing" }}
Más é luach ``“” (an teaghrán folamh), beidh `rud ar bith an t-aschur.
réamhshocraithe_ife_neamhLink to this heading
Más é (agus mura bhfuil) luach None, úsáideann sé an réamhshocrú tugtha. Seachas sin, úsáideann sé an luach.
Tabhair faoi deara má thugtar sreang folamh, go n-úsáidfear an luach réamhshocraithe*. Úsáid an scagair:tfilter: default más mian leat teacht ar ais le haghaidh teaghráin folamh.
Mar shampla:
{{ value|default_if_none:"nothing" }}
dictsortLink to this heading
Tógann sé liosta de na foclóirí agus tugann sé ar ais an liosta sin a shórtáiltear de réir an eochair a thugtar san
Mar shampla:
{{ value|dictsort:"name" }}
Más é “luach”:
[
{"name": "zed", "age": 19},
{"name": "amy", "age": 22},
{"name": "joe", "age": 31},
]
ansin bheadh an t-aschur:
[
{"name": "amy", "age": 22},
{"name": "joe", "age": 31},
{"name": "zed", "age": 19},
]
Is féidir leat rudaí níos casta a dhéanamh freisin mar:
{% for book in books|dictsort:"author.age" %}
* {{ book.title }} ({{ book.author.name }})
{% endfor %}
Más é “leabhair”:
[
{"title": "1984", "author": {"name": "George", "age": 45}},
{"title": "Timequake", "author": {"name": "Kurt", "age": 75}},
{"title": "Alice", "author": {"name": "Lewis", "age": 33}},
]
ansin bheadh an t-aschur:
* Alice (Lewis)
* 1984 (George)
* Timequake (Kurt)
Is féidir le dictsort liosta liostaí a ordú freisin (nó aon rud eile a chuirtear chun feidhme ``__getitem__ () ``) de réir eilimintí ag innéacs sonraithe. Mar shampla:
{{ value|dictsort:0 }}
Más é “luach”:
[
("a", "42"),
("c", "string"),
("b", "foo"),
]
ansin bheadh an t-aschur:
[
("a", "42"),
("b", "foo"),
("c", "string"),
]
Ní mór duit an t-innéacs a rith mar shláimhir seachas sreang. Táirgeann na seo a leanas aschur folamh:
{{ values|dictsort:"0" }}
Ní thacaítear le hordú de réir eilimintí ag innéacs sonraithe ar fhoclóirí
dictsortreversedLink to this heading
Tógann sé liosta de na foclóirí agus tuairisceann an liosta sin a shórtáil in ord droim de réir an eochair a thugtar san argóint Oibríonn sé seo díreach mar an gcéanna leis an scagaire thuas, ach beidh an luach ar ais in ord droim.
roinntearLink to this heading
Tugann sé “Fíor” ar ais má tá an luach inroinnte leis an argóint.
Mar shampla:
{{ value|divisibleby:"3" }}
``éalú `Link to this heading
Éalaíonn sé HTML teaghrán. Go sonrach, déanann sé na hathsholáthairtí 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 `&`
Ní dhéanfar ach babhta amháin éalaithe mar thoradh ar “éalú” a chur i bhfeidhm ar athróg a bheadh éalú uathoibríoch i bhfeidhm ar an toradh de ghnáth. Mar sin tá sé sábháilte an fheidhm seo a úsáid fiú i dtimpeallachtaí éalaithe uathoibríoch Más mian leat go gcuirfear pasanna éalaithe iolracha i bhfeidhm, bain úsáid as an scagair:tfilter: force_escape.
Mar shampla, is féidir leat escape a chur i bhfeidhm ar réimsí nuai:ttag: autoescape as:
{% autoescape off %}
{{ title|escape }}
{% endautoescape %}
``éalaithe `Link to this heading
Éalaíonn sé carachtair le húsáid mar shreang JavaScript iomlán liteartha, laistigh de luachana aonair nó dúbailte, mar atá thíos. Ní dhéanann an scagaire seo an sreang sábháilte le húsáid in*"Litríochtaí teimpléad JavaScript"* (an comhréir backtick JavaScript). Ní thacaítear le haon úsáidí eile nach bhfuil liostaithe thuas. Moltar go ginearálta gur chóir sonraí a rith ag baint úsáide as tréithe HTML ``sonraí ``, nó an scagair:tfilter: json_script, seachas i JavaScript leabaithe.
Mar shampla:
<script>
let myValue = '{{ value|escapejs }}'
`EscapeseqLink to this heading
Cuireann an scagaire: tfilter: escape i bhfeidhm ar gach eilimint de seicheamh. Úsáideach i gcomhar le scagairí eile a oibríonn ar sheicheamh, mar shampla:tfilter: join. Mar shampla:
{% autoescape off %}
{{ my_list|escapeseq|join:", " }}
{% endautoescape %}
``formáid comhaid ``Link to this heading
Formáidigh an luach cosúil le méid comhad 'inléite ag an duine' (ie '13 KB', 4.1 MB', `102 bytes', srl.).
Mar shampla:
{{ value|filesizeformat }}
Más é “luach” 123456789, is é 117.7 MB an t-aschur.
`chéadLink to this heading
Tugann sé an chéad mhír ar liosta ar ais.
Mar shampla:
{{ value|first }}
Más é luach an liosta ['a', 'b', 'c'], is é ``a'` an t-aschur.
formáid snámhaLink to this heading
Nuair a úsáidtear é gan argóint, cruinnigh uimhir phointe snámh go háit deachúil amháin - ach amháin má tá cuid deachúil le taispeáint. Mar shampla:
|
Teimpléad |
Aschur |
|---|---|---|
|
|
|
|
|
|
|
|
|
Má úsáidtear é le hargóint slámhshláir uimhriúil, cruthaíonn formáid float uimhir go dtí an iliomad áiteanna deachúil sin. Mar shampla:
|
Teimpléad |
Aschur |
|---|---|---|
|
|
|
|
|
|
|
|
|
Is úsáideach go háirithe tá 0 (nialas) a rith mar an argóint a chuirfidh an snámhphointe go dtí an slámhshláir is gaire.
|
Teimpléad |
Aschur |
|---|---|---|
|
|
|
|
|
|
|
|
|
Má tá an argóint a chuirtear chuig “floatformat” diúltach, cuirfidh sé uimhir go dtí an iliomad áiteanna deachúil sin - ach amháin má tá cuid deachúil le taispeáint. Mar shampla:
|
Teimpléad |
Aschur |
|---|---|---|
|
|
|
|
|
|
|
|
|
Má tá an iarmhír ``ag an argóint a chuirtear chuig `floatformat, cuirfidh sé iallach ar ghrúpáil trí:setting: THOUSAND_SEPARATOR don áit ghníomhach. Mar shampla, nuair is é en` (Béarla) an áitiúil gníomhach:
|
Teimpléad |
Aschur |
|---|---|---|
|
|
|
|
|
|
|
|
|
Tá an t-aschur logánaithe i gcónaí (go neamhspleách ar an gclibe:ttag: {% localize off%}`<localize>) mura bhfuil an iarmhír ``u ``ag an argóint a chuirtear chuig `floatformat`, a chuirfidh iallach ar logánú a dhíchumasú. Mar shampla, nuair is é pl` (Polainnis) an áitiúil gníomhach:
|
Teimpléad |
Aschur |
|---|---|---|
|
|
|
|
|
|
Is cothrom le floatformat a úsáid gan aon argóint le floatform a úsáid le argóint -1.
Force_escapeLink to this heading
Cuireann éalú HTML i bhfeidhm chuig teaghrán (féach an scagair:tfilter: escape le haghaidh sonraí). Cuirtear an scagaire seo i bhfeidhme* láithreach* agus filleann sé sreang nua éalaithe ar ais. Tá sé seo úsáideach sna cásanna annamh ina dteastaíonn éalú iolracha uait nó gur mhaith leat scagairí eile a chur i bhfeidhm ar na torthaí éalaithe De ghnáth, ba mhaith leat an scagaire: tfilter: escape a úsáid.
Mar shampla, más mian leat na heilimintí <p>HTML ``a chruthaigh an scagair:tfilter: `linebreaks a ghabháil:
{% autoescape off %}
{{ body|linebreaks|force_escape }}
{% endautoescape %}
faigh_digitLink to this heading
Mar gheall ar uimhir iomlán, filleann sé an digit iarrtha, áit a bhfuil 1 an dhigit is deise, 2 an dara digiteach is mó ar dheis, srl. Tugann sé an luach bunaidh le haghaidh ionchur neamhbhailí (mura bhfuil ionchur nó argóint sláimhir, nó má tá argóint níos lú ná 1). Seachas sin, is sláimhir é aschur i gcónaí.
Mar shampla:
{{ value|get_digit:"2" }}
Más é `luach ``123456789, is é 8 an t-aschur.
iriencodeLink to this heading
Athraíonn sé IRI (Aitheantóir Acmhainní Idirnáisiúnta) go sreang atá oiriúnach lena n-áireamh i URL. Tá sé seo riachtanach má tá tú ag iarraidh teaghráin a úsáid ina bhfuil carachtair neamh-ASCII i URL.
Tá sé sábháilte an scagaire seo a úsáid ar shreang atá imithe tríd an scagaire: tfilter: urlencode cheana féin.
Mar shampla:
{{ value|iriencode }}
Más é luach ? Test = I ♥ Django “, beidh an t-aschur``”? Tástáil = I% 20% E 2% 99% A 5% 20Django “``.
`BhreastalaLink to this heading
Cuireann sé le liosta le sreang, cosúil le ``str.join (list) ``Python
Mar shampla:
{{ value|join:" // " }}
Más é luach an liosta ['a', 'b', 'c'], is é an t-aschur an teaghrán "a//b//c".
json_scriptLink to this heading
Aisíonn sé réad Python go sábháilte mar JSON, fillte i gcli <script>b ```, réidh le húsáid le JavaScript.
**Argóint: ** An “id” HTML roghnach den chlib <script>```.
Mar shampla:
{{ value|json_script:"hello-data" }}
Más é luach an foclóir {'hello': 'world'}, is é an t-aschur:
<script id="hello-data" type="application/json">{"hello": "world"}</script>
Is féidir rochtain a fháil ar na sonraí mar gheall air i JavaScript mar seo:
const value = JSON.parse(document.getElementById('hello-data').textContent);
Maolaítear ionsaithe XSS trí na carachtair “<”, “>” agus “&” a éalú. Mar shampla má tá luach {'hello': 'domhan &'}, is é an t-aschur:</script>
<script id="hello-data" type="application/json">{"hello": "world\\u003C/script\\u003E\\u0026amp;"}</script>
Tá sé seo comhoiriúnach le Polasaí Slándála Ábhar dian a chuireann cosc ar fhorghníomhú script ar an Coinníonn sé scaradh glan freisin idir sonraí éighníomhacha agus cód infheidhmithe.
deireannLink to this heading
Tugann an mír deireanach ar liosta ar ais.
Mar shampla:
{{ value|last }}
Más é luach an liosta ['a', 'b', 'c', 'd'], is é an t-aschur an teaghrán "d".
``Fad ``Link to this heading
Tugann sé ar ais fad an luacha. Oibríonn sé seo le haghaidh teaghráin agus liostaí araon.
Mar shampla:
{{ value|length }}
Más é luach ['a', 'b', 'c', 'd'] nó "abcd", is é 4 an aschur.
Filleann an scagaire 0 le haghaidh athróg neamhshainithe.
breiseanna líneLink to this heading
Cuireann HTML cuí in ionad sosanna líne i ngnáthtéacs; bíonn líne nua amháin ina bhri</p> <br>seadh líne HTML (``) agus bíonn líne nua ina bhriseadh mír ina líne bán ina dhiaidh sin (`).
Mar shampla:
{{ value|linebreaks }}
<p>Más é luach ``Joel\ n slug, is é an t-aschur Is slug é Joel.</p> <br>
linebreaksbrLink to this heading
Athraíonn sé gach líne nua i bpíosa téacs simplí go briseanna líne HTML (<br>```).
Mar shampla:
{{ value|linebreaksbr }}
<br>Más é luach `Joel\ n slug, is é an t-aschur `Joel is slug.
Uimhreacha líneLink to this heading
Taispeánann sé téacs le huimhreacha líne.
Mar shampla:
{{ value|linenumbers }}
Más é “luach”:
one
two
three
beidh an t-aschur:
1. one
2. two
3. three
`fuaimLink to this heading
Ailíníonn clé an luach i réimse de leithead ar leith.
**Argóint: ** méid réimse
Mar shampla:
"{{ value|ljust:"10" }}"
``níos ísle `Link to this heading
Athraíonn sé sreang go léir litreacha beaga.
Mar shampla:
{{ value|lower }}
Má tá luach ``GRÁ go hiomlán ag an Albam seo! `, beidh an t-aschur ``grámhar go hiomlán leis an albam seo! ``.
liosta make_list``Link to this heading
Tugann sé an luach a iompaigh ina liosta. Maidir le sreang, is liosta carachtair é. Maidir le sláimhir, caitheann an argóint chuig teaghrán sula gcruthaítear liosta.
Mar shampla:
{{ value|make_list }}
Más é luach an teaghrán "Joel", bheadh an t-aschur an liosta ['J', 'o', 'e', 'l']. Más é `luach 123`, is é an t-aschur an liosta ['1', '2', '3'].
fhóna2uimhriachLink to this heading
Athraíonn sé uimhir theileafóin (b'fhéidir ina bhfuil litreacha ann) go dtí a choibhéis
Ní gá go mbeadh an t-ionchur ina uimhir theileafóin bailí. Déanfaidh sé seo aon sreang a thiontú go sona sásta.
Mar shampla:
{{ value|phone2numeric }}
Más é luach ``800-COLLECT ``, is é `800-2655328 an t-aschur.
iolraitheLink to this heading
Tugann iarmhír iolra ar ais mura bhfuil an luach 1, 1', nó réad de fhad 1. De réir réamhshocraithe, is é an iarmhír seo s'.
Sampla:
You have {{ num_messages }} message{{ num_messages|pluralize }}.
Más é `num_messages 1, is é an aschur Tá 1 theachtaireacht agat. ``Má tá ``num_teachtaireachtaí ````2 is é an aschur ``Tá 2 theachtaireacht agat. ``
Maidir le focail a dteastaíonn iarmhír seachas `s', is féidir leat iarmhír malartach a sholáthar mar pharaiméadar don scagaire.
Sampla:
You have {{ num_walruses }} walrus{{ num_walruses|pluralize:"es" }}.
Maidir le focail nach n-iolraíonn le iarmhír simplí, is féidir leat iarmhír uaineach agus iolra a shonrú, scartha le camóg.
Sampla:
You have {{ num_cherries }} cherr{{ num_cherries|pluralize:"y,ies" }}.
pprintLink to this heading
Fillteán timpeall: func: pprint.pprint - le haghaidh dífhabhtú, i ndáiríre.
randamLink to this heading
Tugann mír randamach ar ais ón liosta a thugtar.
Mar shampla:
{{ value|random }}
Más é luach an liosta ['a', 'b', 'c', 'd'], d'fhéadfadh an t-aschur a bheith "b".
RjustLink to this heading
Ailíníonn ar dheis an luach i réimse de leithead ar leith.
**Argóint: ** méid réimse
Mar shampla:
"{{ value|rjust:"10" }}"
Más é luach Django, is é ``Django"` an t-aschur.
sábháilteLink to this heading
Marcálann sé teaghrán mar nach dteastaíonn tuilleadh HTML éalú roimh aschur. Nuair a bhíonn autoescaping as, níl aon éifeacht ag an scagaire seo.
sábháilteqLink to this heading
Cuireann an scagaire: tfilter: sábháil' i bhfeidhm ar gach eilimint de seicheamh. Úsáideach i gcomhar le scagairí eile a oibríonn ar sheicheamh, mar shampla:tfilter: `join. Mar shampla:
{{ some_list|safeseq|join:", " }}
Ní fhéadfá an scagaire: tfilter: safe a úsáid go díreach sa chás seo, mar thiontfadh sé an t-athróg i sreang ar dtús, seachas oibriú le heilimintí aonair an seicheamh.
sliseLink to this heading
Tugann sé slisnán den liosta ar ais.
Úsáideann sé an chomhréir céanna le slisnú liosta Python. < https://docs.python.org/3/tutorial/introduction.html#lists>Féach an `doiciméadú Python`_ le haghaidh réamhrá.
Sampla:
{{ some_list|slice:":2" }}
Más é some_list ['a', 'b', 'c'], is é ['a', 'b'] an aschur.
slugifyLink to this heading
Tiontaíonn sé go ASCII. Athraíonn sé spásanna go hiphens. Baineann sé carachtair nach alfaiméiricí, béim nó braithíní iad. Athraíonn sé go litreacha beaga. Chomh maith leis sin stiallacha spás bán a threoraíonn agus a leanann.
Mar shampla:
{{ value|slugify }}
Más é luach `"Is slug é Joel", is é an t-aschur "joel-is-a-slug".
Formáid teaghránaLink to this heading
Formálaíonn sé an t-athróg de réir an argóint, sonraitheoir formáidithe sreangáin. Úsáideann an sonraitheoir seo an comhréire:ref: old-string-formatting, ach amháin go dtioctar an “%” tosaigh.
Mar shampla:
{{ value|stringformat:"E" }}
Más é `luach 10, is é 1.000000E+01` an t-aschur.
``Am `Link to this heading
Formálaíonn sé am de réir an fhormáid a thugtar.
Is féidir le formáid thugtar a bheith mar an ceann réamhshainithe: setting: TIME_FORMAT, nó formáid saincheaptha, mar an scagaire: tfilter: dáta. Tabhair faoi deara go bhfuil an fhormáid réamhshainithe ag brath go háitiúil.
Mar shampla:
{{ value|time:"H:i" }}
Má tá lua comhionann le datetime.datetime.now () ``, is é an t-aschur an teaghrán” 01:23 “``.
Tabhair faoi deara gur féidir leat teaghrán formáide a éalú ar ais más mian leat an luach “amh” a úsáid. Sa sampla seo, tá “h” agus “m” araon éalaithe le cúltaca, mar ar shlí eile is teaghrán formáide é gach ceann acu a thaispeánann an uair agus an mhí, faoi seach:
{{ value|time:"H\h i\m" }}
Taispeánfaí sé seo mar “01h 23m”.
Sampla eile:
Ag glacadh leis gur:setting: LANGUAGE_CODE, mar shampla, de", ansin le haghaidh:
{{ value|time:"TIME_FORMAT" }}
is é an t-aschur an teaghrán ” 01:23 “ (Is é an sonraitheoir formáide "TIME_FORMAT” ``don áitiúil ``de mar a sheoltar le Django ná "H: i").
Ní ghlacfaidh an scagaire ``am ``ach le paraiméadair sa teaghrán formáide a bhaineann leis an am den lá, ní leis an dáta. Más gá duit luach ``dáta ``a fhormáidiú, bain úsáid as an scagair:tfilter: dáta ina ionad (nó in éineacht le:tfilter: time más gá duit luach iomlán:py:class: ~datetime.datetime a rinneadh).
<date-and-time-formatting-specifiers>Tá eisceacht amháin ann an riail thuas: Nuair a rith luach datetime le faisnéis crios ama ceangailte (a:ref: time-chrione-aware ``datetime``<naive_vs_aware_datetimes>) glacfaidh an scagaire ``time` leis an scagaire time a bhaineann leis an crios ama:ref: sonraitheoirí formáid ```, ``.
Nuair a úsáidtear é gan teaghrán formáide, úsáidtear an sonraitheoir formáide ``TIME_FORMAT ``:
{{ value|time }}
tá sé mar an gcéanna le:
{{ value|time:"TIME_FORMAT" }}
`TimeLink to this heading
Déanann dáta a fhormáidiú mar an t-am ón dáta sin (m.sh., “4 lá, 6 uair an chloig”).
Tógann sé argóint roghnach atá ina athróg ina bhfuil an dáta le húsáid mar phointe comparáide (gan an argóint, is í*anois* an pointe comparáide). Mar shampla, más cás dáta é blog_date a léiríonn meán oíche an 1 Meitheamh 2006, agus is sampla dáta é comment_date` le haghaidh 08:00 an 1 Meitheamh 2006, ansin fillfeadh an méid seo a leanas “8 n-uair an chloig” ar ais:
{{ blog_date|timesince:comment_date }}
Cuirfear sreang folamh ar ais ar ais i gcomparáid idir amanna dáta nach n-aithníonn agus na hamanna atá ar an eolas
Is é miontuairiscí an t-aonad is lú a úsáidtear, agus cuirfear “0 nóiméad” ar ais d'aon dáta atá sa todhchaí i gcoibhneas leis an bpointe comparáide.
`timéireannLink to this heading
Cosúil le timesince, ach amháin go dtomhaiseann sé an t-am ó seo go dtí an dáta nó an dáta-am ar leith. Mar shampla, más é an 1 Meitheamh 2006 inniu agus má tá conference_date` ina scála dáta a bheidh ar siúl an 29 Meitheamh 2006, ansin fillfidh ``{{conference_date|timetill}} `“4 seachtaine”.
Tógann sé argóint roghnach atá ina athróg ina bhfuil an dáta le húsáid mar phointe comparáide (in ionad* anois*). Má tá 22 Meitheamh 2006 sa from_date, ansin cuirfidh an méid seo a leanas ar ais “1 seachtain”:
{{ conference_date|timeuntil:from_date }}
Cuirfear sreang folamh ar ais ar ais i gcomparáid idir amanna dáta nach n-aithníonn agus na hamanna atá ar an eolas
Is é miontuairiscí an t-aonad is lú a úsáidtear, agus cuirfear “0 nóiméad” ar ais d'aon dáta atá san am atá thart i gcoibhneas leis an bpointe comparáide.
``teideal ``Link to this heading
Déanann teaghrán a thiontú ina theitlicase trí fhocail a thosú le carachtar uachtarchlóir agus na carachtair atá fágtha le litreacha beaga. Ní dhéanann an chlib seo aon iarracht “focail thábhachtacha” a choinneáil i litreacha beaga.
Mar shampla:
{{ value|title }}
Más é luach `mo CHÉAD phost", is é an t-aschur ``"Mo Chéad Post” ``.
truncatecharsLink to this heading
Déanann sé teaghrán a ghearradh má tá sé níos faide ná an líon sonraithe carachtair. Críochnóidh teaghráin ghearrtha le carachtar ellipsis inaistrithe (“...”).
**Argóint: ** Líon na gcarachtar le gearradh
Mar shampla:
{{ value|truncatechars:7 }}
Más é luach "Is slug é Joel", is é an t-aschur "Joel i... ".
truncatechars_htmlLink to this heading
Cosúil le:tfilter: truncatechars, ach amháin go bhfuil sé ar an eolas faoi chlibeanna HTML. Dúntar aon chlibeanna a osclaítear sa sreangán agus nach bhfuil dúnta roimh an bpointe bearrtha díreach tar éis an chruinnithe.
Mar shampla:
{{ value|truncatechars_html:7 }}
<p>Más é luach ” Is <p>slug é Joel “, is é an</p> t-aschur ” Joel i... “.</p>
Caomhnófar línte nua san ábhar HTML.
`truncatewordsLink to this heading
Cuireann sé teaghrán tar éis líon áirithe focal.
**Argóint: ** Líon na bhfocal le gearradh ina dhiaidh sin
Mar shampla:
{{ value|truncatewords:2 }}
Más é luach "Is slug é Joel", is é an t-aschur "Is é Joel... ".
Bainfear línte nua laistigh den teaghrán.
truncatewords_htmlLink to this heading
Cosúil le:tfilter: truncatewords, ach amháin go bhfuil sé ar an eolas faoi chlibeanna HTML. Dúntar aon chlibeanna a osclaítear sa sreangán agus nach bhfuil dúnta roimh an bpointe bearrtha díreach tar éis an chruinnithe.
Níl sé seo chomh héifeachtach ná: tfilter: truncatewords, mar sin níor cheart é a úsáid ach amháin nuair a bhíonn téacs HTML á rith.
Mar shampla:
{{ value|truncatewords_html:2 }}
<p>Más é luach ” Is <p>slug é Joel “, is é an</p> t-aschur ” Is é Joel... “.</p>
Caomhnófar línte nua san ábhar HTML.
liosta_neamh-ordúnaíLink to this heading
<ul>Tógann sé liosta féin-neadaithe go réasúnta agus filleann sé liosta neamh-ordaithe HTML ar ais - GAN clibeanna ``a oscailt agus a dhúnadh.
Glactar leis go bhfuil an liosta san fhormáid cheart. Mar shampla, má tá var `` ['Stáit', ['Kansas', ['Lawrence', 'Topeka'], 'Illinois']] , ansin ``{{var|unordered_list}}` ar ais:
<li>States
<ul>
<li>Kansas
<ul>
<li>Lawrence</li>
<li>Topeka</li>
</ul>
</li>
<li>Illinois</li>
</ul>
</li>
uachtarLink to this heading
Athraíonn sé teaghrán i ngach uachchlár.
Mar shampla:
{{ value|upper }}
Más é luach "Is slóg é Joel", is é an t-aschur "JOEL IS A SLUG".
``Urlencode ``Link to this heading
Éalaíonn sé luach le húsáid i URL.
Mar shampla:
{{ value|urlencode }}
Más é luach ” https://www.example.org/foo?a=b&c=d “, is é an aschur "https%3A//www.example.org/foo%3FA%3DB%26C%3DD".
Is féidir argóint roghnach ina bhfuil na carachtair nár chóir iad a éalú a sholáthar.
Mura gcuirtear ar fáil, glactar leis an carachtar '/' sábháilte. Is féidir teaghrán folamh a sholáthar nuair ba chóir carachtair uach* a éalú. Mar shampla:
{{ value|urlencode:"" }}
Más é luach ” https://www.example.org/ “, is é an t-aschur ná "https%3A%2F%2Fwww.example.org%2F".
UrlizeLink to this heading
Tiontaíonn URLanna agus seoltaí ríomhphoist sa téacs ina naisc inchliceáilte.
Oibríonn an chlib teimpléad seo ar naisc réamhshocraithe le http: //, https: //`, nó www.. Mar shampla, tiontófar https://djangocon.eu ach ní dhéanfaidh djangocon.eu.
Tacaíonn sé freisin le naisc fearainn amháin a chríochnaíonn i gceann de na fearainn barrleibhéil bunaidh (.com`, .edu`, .gov`, .int `, .mil`, .net`, agus .org). Mar shampla, déantar djangoproject.com a thiontú.
Is féidir le poncóireacht (tréimhsí, camóga, dlúththuismitheoirí) agus poncaíocht tosaigh (tuismitheoirí oscailte) a bheith ag naisc, agus déanfaidh urlize an rud ceart fós.
Tá tréith rel="nofollow" curtha leis na naisc a ghineann urlize.
Mar shampla:
{{ value|urlize }}
<a href="http://www.djangoproject.com" rel="nofollow">Más é luach "Amharc ar www.djangoproject.com", beidh an t-aschur "Amharc ar www.djangoproject.com “.</a>
Chomh maith le naisc gréasáin, athraíonn urlize seoltaí ríomhphoist ina naisc mailto: ``. <a href="mailto:foo@example.com">Más é ``luach "Seol ceisteanna chuig foo@example.com “, is é an aschur "Seol ceisteanna chuig foo@example.com “.</a>
Glacann an scagaire urlize paraiméadar roghnach autoescape freisin. Má tá autoescape True`, éalófar an téacs nasc agus URLanna ag baint úsáide as scagaire ionsuite Django: tfilter: escape. Is é an luach réamhshocraithe do autoescape True.
urlizetruncLink to this heading
Tiontaíonn sé URLanna agus seoltaí ríomhphoist ina naisc inchliceáilte díreach cosúil le urlize, ach cuireann sé URLanna níos faide ná an teorainn charachtair ar leith.
**Argóint: ** Ba chóir líon na gcarachtair a nascann téacs a ghearradh leo, lena n-áirítear an ellipsis a chuirtear leis má tá gá le gearradh.
Mar shampla:
{{ value|urlizetrunc:15 }}
<a href="http://www.djangoproject.com" rel="nofollow">Más é luach `"Seiceáil ar www.djangoproject.com", bheadh an t-aschur ná 'Amharc ar www.djangoproj... '.</a>
Mar is amhlaidh le urlize, níor cheart an scagaire seo a chur i bhfeidhm ach ar théacs simplí.
``comhaireamh focal ``Link to this heading
Tugann sé líon na bhfocal ar ais.
Mar shampla:
{{ value|wordcount }}
Más é luach `"Is slug é Joel", is é 4 an t-aschur.
``wordwrap ``Link to this heading
Fillteann sé focail ag fad líne sonraithe.
**Argóint: ** líon na gcarachtar chun an téacs a fhilleadh
Mar shampla:
{{ value|wordwrap:5 }}
Más é luach ````Sluig é Joel ``, bheadh an t-aschur:
Joel
is a
slug
YesnoLink to this heading
Léarscáil luachanna do True, False`, agus (roghnach) ``None ``, chuig na teaghráin “yes”, “níl”, “b'fhéidir”, nó mapáil saincheaptha a rith mar liosta scartha le camóg, agus filleann sé ceann de na teaghráin sin de réir an luacha:
Mar shampla:
{{ value|yesno:"yeah,no,maybe" }}