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>.
\nautoescapeLink 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:
\n{% autoescape on %}\n {{ body }}\n{% endautoescape %}\nNuair 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.
\nIs 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”.
\nLaistigh 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ú `
\n{% autoescape off %}\n {{ my_list|join:", "|escape }}\n{% endautoescape %}\nAschró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:
\n{% autoescape off %}\n {{ my_list|escapeseq|join:", " }}\n{% endautoescape %}\nSainmhí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.
\n`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:
\n<p>Rendered text with {{ pub_date|date:"c" }}</p>\n{% comment "Optional note" %}\n <p>Commented out text with {{ create_date|date:"c" }}</p>\n{% endcomment %}\nNí 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.
\nrothaLink 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
\nTá an clib seo úsáideach go háirithe i lúb:
\n{% for o in some_list %}\n <tr class="{% cycle 'row1' 'row2' %}">\n ...\n </tr>\n{% endfor %}\nTá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 %}\n <tr class="{% cycle rowvalue1 rowvalue2 %}">\n ...\n </tr>\n{% endfor %}\nÉalófar athróga atá san áireamh sa timthriall. Is féidir leat éalú uathoibríoch a dhíchumasú le
\n{% for o in some_list %}\n <tr class="{% autoescape off %}{% cycle rowvalue1 rowvalue2 %}{% endautoescape %}">\n ...\n </tr>\n{% endfor %}\nIs féidir leat athróga agus teaghráin a mheascadh:
\n{% for o in some_list %}\n <tr class="{% cycle 'row1' rowvalue2 'row3' %}">\n ...\n </tr>\n{% endfor %}\nI 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Ó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:
\n<tr>\n <td class="{% cycle 'row1' 'row2' as rowcolors %}">...</td>\n <td class="{{ rowcolors }}">...</td>\n</tr>\n<tr>\n <td class="{% cycle rowcolors %}">...</td>\n <td class="{{ rowcolors }}">...</td>\n</tr>\nbheadh aschur:
\n<tr>\n <td class="row1">...</td>\n <td class="row1">...</td>\n</tr>\n<tr>\n <td class="row2">...</td>\n <td class="row2">...</td>\n</tr>\nIs 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 %}\n {% cycle 'row1' 'row2' as rowcolors silent %}\n <tr class="{{ rowcolors }}">{% include "subtemplate.html" %}</tr>\n{% endfor %}\nAschró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 %}\n{% cycle rowcolors %}\nIs 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
\nIs féidir an chlib seo a úsáid ar dhá bhealach:
\n{% 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.
\nDe 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/\n template.html\n base2.html\n my/\n base3.html\nbase1.html\nI template.html`, bheadh na cosáin seo a leanas bailí:
\n{% extends "./base2.html" %}\n{% extends "../base1.html" %}\n{% extends "./my/base3.html" %}\nScagairLink 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é
\nTabhair faoi deara go gcuimsíonn an bloc uach an téacs idir na clibeanna filter agus endfilter.
Úsáid samplach:
\n{% filter force_escape|lower %}\n This text will be HTML-escaped, and will appear in all lowercase.\n{% endfilter %}\nFirstoffLink 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”.
\nÚsáid samplach:
\n{% firstof var1 var2 var3 %}\nTá sé seo coibhéiseach le:
\n{% if var1 %}\n {{ var1 }}\n{% elif var2 %}\n {{ var2 }}\n{% elif var3 %}\n {{ var3 }}\n{% endif %}\nIs 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:
\n{% firstof var1 var2 var3 "fallback value" %}\nÉalaíonn an chlib seo luachanna athraitheacha go huathoibr Is féidir leat éalú uathoibríoch a dhíchumasú le
\n{% autoescape off %}\n {% firstof var1 var2 var3 "<strong>fallback value</strong>" %}\n{% endautoescape %}\nNó mura chóir ach roinnt athróg a éalú, is féidir leat úsáid a bhaint as:
\n{% firstof var1 var2|safe var3 "<strong>fallback value</strong>"|safe %}\nIs 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.
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:
\n<ul>\n{% for athlete in athlete_list %}\n <li>{{ athlete.name }}</li>\n{% endfor %}\n</ul>\nIs 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:
\n{% for x, y in points %}\n There is a point at {{ x }},{{ y }}\n{% endfor %}\nIs 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:
\n{% for key, value in data.items %}\n {{ key }}: {{ value }}\n{% endfor %}\nCoinnigh 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:
\nAthraitheach | \nCur síos | \n
|---|---|
| \nAthraitheadh reatha an lúb (1-innéacsaithe) | \n
| \nAn t-athrú reatha ar an lúb (0-innéacsaithe) | \n
| \nLíon na n-athrá ó dheireadh an lúb (1-innéacsaithe) | \n
| \nLíon na n-athrá ó dheireadh an lúb (0-innéacsaithe) | \n
| \nFíor más é seo an chéad uair tríd an lúb | \n
``forloop.last `` | \nFíor más é seo an uair dheireanach tríd an lúb | \n
| \nMaidir le lúb neadaithe, is é seo an lúb timpeall leis an gceann reatha | \n
``... 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>\n{% for athlete in athlete_list %}\n <li>{{ athlete.name }}</li>\n{% empty %}\n <li>Sorry, no athletes in this list.</li>\n{% endfor %}\n</ul>\nTá 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:
\n<ul>\n {% if athlete_list %}\n {% for athlete in athlete_list %}\n <li>{{ athlete.name }}</li>\n {% endfor %}\n {% else %}\n <li>Sorry, no athletes in this list.</li>\n {% endif %}\n</ul>\nDé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 %}\n Number of athletes: {{ athlete_list|length }}\n{% elif athlete_in_locker_room_list %}\n Athletes should be out of the locker room soon!\n{% else %}\n No athletes.\n{% endif %}\nSa 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.
if tags may use and, or or not to test a number of\nvariables or to negate a given variable:
{% if athlete_list and coach_list %}\n Both athletes and coaches are available.\n{% endif %}\n\n{% if not athlete_list %}\n There are no athletes.\n{% endif %}\n\n{% if athlete_list or coach_list %}\n There are some athletes or some coaches.\n{% endif %}\n\n{% if not athlete_list or coach_list %}\n There are no athletes or there are some coaches.\n{% endif %}\n\n{% if athlete_list and not coach_list %}\n There are some athletes and absolutely no coaches.\n{% endif %}\nCeadaí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 %}\nléirmhínítear mar:
\nif (athlete_list and coach_list) or cheerleader_list:\n ...\nÚ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.
\nif tags may also use the operators ==, !=, <, >,\n<=, >=, in, not in, is, and is not which work as\nfollows:
== oibreoirLink to this heading#Comhionannas. Sampla:
\n{% if somevar == "x" %}\n This appears if variable somevar equals the string "x"\n{% endif %}\n! = oibreoirLink to this heading#Éagothroime. Sampla:
\n{% if somevar != "x" %}\n This appears if variable somevar does not equal the string "x",\n or if somevar is not found in the context\n{% endif %}\n< oibreoirLink to this heading#Níos lú ná. Sampla:
\n{% if somevar < 100 %}\n This appears if variable somevar is less than 100.\n{% endif %}\n> oibreoirLink to this heading#Níos mó ná. Sampla:
\n{% if somevar > 0 %}\n This appears if variable somevar is greater than 0.\n{% endif %}\n<= oibreoirLink to this heading#Níos lú ná nó cothrom le. Sampla:
\n{% if somevar <= 100 %}\n This appears if variable somevar is less than 100 or equal to 100.\n{% endif %}\n>= oibreoirLink to this heading#Níos mó ná nó comhionann leis. Sampla:
\n{% if somevar >= 1 %}\n This appears if variable somevar is greater than 1 or equal to 1.\n{% endif %}\ninLink 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" %}\n This appears since "bc" is a substring of "abcdef"\n{% endif %}\n\n{% if "hello" in greetings %}\n If greetings is a list or set, one element of which is the string\n "hello", this will appear.\n{% endif %}\n\n{% if user in users %}\n If users is a QuerySet, this will appear if user is an\n instance that belongs to the QuerySet.\n{% endif %}\nNíl ann laistigh. Is é seo diúltú an oibreora in.
Féiniúlacht réada. Tástálacha má tá dhá luach an réad céanna. Sampla:
\n{% if somevar is True %}\n This appears if and only if somevar is True.\n{% endif %}\n\n{% if somevar is None %}\n This appears if somevar is None, or if somevar is not found in the context.\n{% endif %}\nFé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:
\n{% if somevar is not True %}\n This appears if somevar is not True, or if somevar is not found in the\n context.\n{% endif %}\n\n{% if somevar is not None %}\n This appears if and only if somevar is not None.\n{% endif %}\nIs féidir leat scagairí a úsáid freisin sa léir:ttag: `if `. Mar shampla:
\n{% if messages|length >= 100 %}\n You have lots of messages today!\n{% endif %}\nIs 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:
\n\n(Leanann sé seo Python go díreach). Mar sin, mar shampla, an casta seo a leanas: ttag: `if `tag:
\n{% if a == b or c == d and e %}\nDéanfar... léirmhíniú mar:
\n(a == b) or ((c == d) and e)\nMá 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.
\nNí 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:
\n{% if a > b > c %} (WRONG)\nba chóir duit úsáid a bhaint as:
\n{% if a > b and b > c %}\nSeiceáil an bhfuil luach athraithe ón athrú deireanach de lúb.
\nÚ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é:
\n<h1>Archive for {{ year }}</h1>\n\n{% for date in days %}\n {% ifchanged %}<h3>{{ date|date:"F" }}</h3>{% endifchanged %}\n <a href="{{ date|date:"M/d"|lower }}/">{{ date|date:"j" }}</a>\n{% endfor %}\nMá 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:
\n{% for date in days %}\n {% ifchanged date.date %} {{ date.date }} {% endifchanged %}\n {% ifchanged date.hour date.date %}\n {{ date.hour }}\n {% endifchanged %}\n{% endfor %}\nIs féidir leis an gclib if changed clásal roghnach ``{% else%} `a thógáil freisin a thaispeánfar mura bhfuil an luach athraithe:
\n{% for match in matches %}\n <div style="background-color:\n {% ifchanged match.ballot_id %}\n {% cycle "red" "blue" %}\n {% else %}\n gray\n {% endifchanged %}\n ">{{ match }}</div>\n{% endfor %}\nLuchtaí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.
\nIs 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.
\nCuimsíonn an sampla seo ábhar an teimpléid ” foo/bar.html “:
{% include "foo/bar.html" %}\nDe 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 %}\nFé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.
\nIna 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.
\nDé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!” ``:
\nComhthéacs: tá athróg `duine ``socraithe go ``"John" agus socraítear athróg `gránt go `Hello".
Teimpléad:
\n{% include "name_snippet.html" %}\nAn teimpléad name_snippet.html:
{{ greeting }}, {{ person|default:"friend" }}!\nIs féidir leat comhthéacs breise a chur ar aghaidh chuig an teimpléad ag baint úsáide as
\n{% include "name_snippet.html" with person="Jane" greeting="Hello" %}\nMá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:
\n{% include "name_snippet.html" with greeting="Hi" only %}\n`ualachLink to this heading#Luchtaíonn sé tacar clib teimpléad saincheaptha.
\nMar 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 %}\nIs 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 %}\nFéach: doc: `Clib saincheaptha agus leabharlanna scagair' le haghaidh tuilleadh faisnéise. </howto/custom-template-tags>
\nLoremLink 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.
\nÚsáid:
\n{% lorem [count] [method] [random] %}\nIs féidir an chlib {% lorem%} a úsáid le nialas, aon, dhá nó trí argóint. Is iad na hargóintí:
Argóint | \nCur síos | \n
|---|---|
| \nUimhir (nó athróg) ina bhfuil líon na míreanna nó na bhfocal le giniúint (is é 1 réamhshocraithe). | \n
| \nCeachtar | \n
| \nAn focal | \n
Samplaí:
\n{% 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.
\nSampla:
\nIt is {% now "jS F Y H:i" %}\nTabhair 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:
\nIt is the {% now "jS \\o\\f F" %}\nTaispeánfaí sé seo mar “Is é an 4 Meán Fómhair é”.
\n\nIs 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 %}\n{% blocktranslate %}Copyright {{ current_year }}{% endblocktranslate %}\nceisteanna ceisteLink to this heading#Aschur sreang ceisteanna formáidithe ionchódaithe URL bunaithe ar na paraiméadair a chuirtear ar fáil.
\n<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.
\nIf the QueryDict is empty and no additional parameters\nare provided, an empty string is returned. Otherwise, the result includes a\nleading "?".
{% querystring %}\nAisí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" %}\nAisí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 ``.
\n{% querystring my_query_dict %}\nIs 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 ``.
{% querystring color="red" size="S" %}\nCuireann 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 ``.
{% querystring color=None %}\nAg 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 ``.
{% querystring color=my_list %}\nMá tá my_list ["dearg”, “gorm"], beidh an t-aschur ``? color = red&color = gorm ``, ag caomhnú struchtúr an liosta sa sreang ceisteanna.
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 %}\nIs 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:
\n{% querystring page=page.next_page_number as next_page %}\nathghrúpaLink to this heading#Athghrúpaíonn sé liosta de na rudaí céanna de réir tréith choiteann.
\nIs 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 = [\n {"name": "Mumbai", "population": "19,000,000", "country": "India"},\n {"name": "Calcutta", "population": "15,000,000", "country": "India"},\n {"name": "New York", "population": "20,000,000", "country": "USA"},\n {"name": "Chicago", "population": "7,000,000", "country": "USA"},\n {"name": "Tokyo", "population": "33,000,000", "country": "Japan"},\n]\n... agus ba mhaith leat liosta ordlathach a ordaítear de réir tíre a thaispeáint, mar seo:
\nAn India
\nMumbai: 19,000,000
Calcutta: 15,000,000
STÁIT AONTAITHE
\nNua Eabhrac: 20,000,000
Chicago: 7,000,000
An tSeapáin
\nTó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 %}\n\n<ul>\n{% for country in country_list %}\n <li>{{ country.grouper }}\n <ul>\n {% for city in country.list %}\n <li>{{ city.name }}: {{ city.population }}</li>\n {% endfor %}\n </ul>\n </li>\n{% endfor %}\n</ul>\nSiú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 %}\n\n<ul>\n{% for country, local_cities in country_list %}\n <li>{{ country }}\n <ul>\n {% for city in local_cities %}\n <li>{{ city.name }}: {{ city.population }}</li>\n {% endfor %}\n </ul>\n </li>\n{% endfor %}\n</ul>\nTabhair 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 = [\n {"name": "Mumbai", "population": "19,000,000", "country": "India"},\n {"name": "New York", "population": "20,000,000", "country": "USA"},\n {"name": "Calcutta", "population": "15,000,000", "country": "India"},\n {"name": "Chicago", "population": "7,000,000", "country": "USA"},\n {"name": "Tokyo", "population": "33,000,000", "country": "Japan"},\n]\nLeis an ionchur seo do cathracha `, bheadh an t-aschur seo a leanas mar thoradh ar an gcód teimpléad`` {% athghrúpaí%} `thuas:
\nAn India
\nMumbai: 19,000,000
STÁIT AONTAITHE
\nNua Eabhrac: 20,000,000
An India
\nCalcutta: 15,000,000
STÁIT AONTAITHE
\nChicago: 7,000,000
An tSeapáin
\nTó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.
\nRé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í:
\n{% regroup cities|dictsort:"country" by country as country_list %}\nIs 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:
\n{% regroup cities by country.description as country_list %}\nNó, 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 %}\nTaispeá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:
\n{% for coach in coach_list %}\n <h1>{{ coach.name }}</h1>\n {% for athlete in coach.athlete_set.all %}\n <p class="{% cycle 'odd' 'even' %}">{{ athlete.name }}</p>\n {% endfor %}\n {% resetcycle %}\n{% endfor %}\nChuirfeadh an sampla seo ar ais an HTML seo:
\n<h1>Gareth</h1>\n<p class="odd">Harry</p>\n<p class="even">John</p>\n<p class="odd">Nick</p>\n\n<h1>John</h1>\n<p class="odd">Andrea</p>\n<p class="even">Melissa</p>\nTabhair 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:
\n{% for item in list %}\n <p class="{% cycle 'odd' 'even' as stripe %} {% cycle 'major' 'minor' 'minor' 'minor' 'minor' as tick %}">\n {{ item.data }}\n </p>\n {% ifchanged item.category %}\n <h1>{{ item.category }}</h1>\n {% if not forloop.first %}{% resetcycle tick %}{% endif %}\n {% endifchanged %}\n{% endfor %}\nSa 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.
\nBaineann sé spás bán idir clibeanna HTML. Cuimsíonn sé seo carachtair cluaisín agus línte nua.
\nÚsáid sampla:
\n{% spaceless %}\n <p>\n <a href="foo/">Foo</a>\n </p>\n{% endspaceless %}\nChuirfeadh an sampla seo ar ais an HTML seo:
\n<p><a href="foo/">Foo</a></p>\nNí 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 %}\n <strong>\n Hello\n </strong>\n{% endspaceless %}\nTeimpléad tagLink to this heading#Aschur ceann de na carachtair chomhréireachta a úsáidtear chun clibeanna teimpléad
\nNí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:
\nArgóint | \nAschuir | \n
|---|---|
| \n
| \n
| \n``%} `` | \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n``#} `` | \n
Úsáid samplach:
\nThe {% templatetag openblock %} characters open a block.\nFéach freisin an clibe:ttag: verbatim le haghaidh bealach eile chun na carachtair seo a áireamh.
\nUrlLink 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.
\nIs bealach é seo chun naisc a aschur gan prionsabal DRY a shárú trí URLanna a chódú crua i do theimpléid:
\n{% url 'some-url-name' v1 v2 %}\n<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:
\n{% url 'some-url-name' arg1=v1 arg2=v2 %}\nNá 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.
\nMar 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")\nMá tá URLConf an aip seo san áireamh i URLConf an tionscadail faoi chonair mar seo:
\npath("clients/", include("project_name.app_name.urls"))\n... ansin, i dteimpléad, is féidir leat nasc a chruthú leis an radharc seo mar seo:
\n{% url 'app-views-client' client.id %}\nAschró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.
\nMás mian leat URL a aisghabháil gan é a thaispeáint, is féidir leat glao beagán difriúil a úsáid:
\n{% url 'some-url-name' arg arg2 as the_url %}\n\n<a href="{{ the_url }}">I'm linking to {{ the_url }}</a>\nIs é 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 %}\n{% if the_url %}\n <a href="{{ the_url }}">Link to optional stuff</a>\n{% endif %}\nMás mian leat URL spás ainmneacha a aisghabháil, sonraigh an t-ainm láncháilithe:
\n{% url 'myapp:view-name' %}\nLeanfaidh 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.
\n\nVerbatimLink to this heading#Stopann inneall an teimpléid ó ábhar an chlib bloc seo a léiriú.
\nÚsáid choitianta ná ciseal teimpléad JavaScript a cheadú a imbhuaileann le comhréir Django. Mar shampla:
\n{% verbatim %}\n {{if dying}}Still alive.{{/if}}\n{% endverbatim %}\nIs 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 %}\n Avoid template rendering via the {% verbatim %}{% endverbatim %} block.\n{% endverbatim myblock %}\nChun 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.
\nMar shampla:
\n<img src="bar.png" alt="Bar"\n height="10" width="{% widthratio this_value max_value max_width %}">\nMá 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:
\n{% widthratio this_value max_value max_width as width %}\n{% blocktranslate %}The width is: {{ width }}{% endblocktranslate %}\nCuireann 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.
\nMar shampla:
\n{% with total=business.employees.count %}\n {{ total }} employee{{ total|pluralize }}\n{% endwith %}\nNí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:
\n{% with alpha=1 beta=2 %}\n ...\n{% endwith %}\nCuireann sé an argóint leis an luach.
\nMar shampla:
\n{{ value|add:"2" }}\nMá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.
\nMar shampla, má tá:
\n{{ first|add:second }}\nagus 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.
\nMar shampla:
\n{{ value|addslashes }}\nMá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.
\nMar shampla:
\n{{ value|capfirst }}\nMás é luach django", is é "Django" an t-aschur.
IonadLink to this heading#Díríonn an luach i réimse de leithead ar leith.
\nMar shampla:
\n"{{ value|center:"15" }}"\nMás é luach Django"`, is é ``” Django “ an t-aschur.
gearrthLink to this heading#Baineann gach luach arg as an sreang tugtha.
\nMar shampla:
\n{{ value|cut:" " }}\nMás é luach ``"Sreang le spásanna” ``, is é an t-aschur ``"Stringwithspaces"`.
Formálaíonn sé dáta de réir an fhormáide a thugtar.
\nÚ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í.
\n\nTeagáin formáid atá ar fáil:
\nCarachtar formáid | \nCur síos | \nAschur sampla | \n
|---|---|---|
Lae | \n\n | \n |
| \nLá na míosa, 2 dhigit le nialas tosaigh. | \n
| \n
| \nLá na míosa gan nialas tosaigh. | \n
| \n
| \nLá na seachtaine, téacsúil, 3 litir. | \n
| \n
| \nLá na seachtaine, téacsúil, fada. | \n
| \n
| \nIarmhír ordúil Béarla do lá na míosa, 2 charachtar. | \n
| \n
| \nLá na seachtaine, digití gan nialas tosaigh. | \n
| \n
| \nLá na bliana. | \n
| \n
Seachtain | \n\n | \n |
| \nLíon seachtaine na bliana ISO-8601, le seachtainí ag tosú Dé Luain. | \n
| \n
Mí | \n\n | \n |
| \nMí, 2 dhigit le nialas tosaigh. | \n
| \n
| \nMí gan nialais tosaigh. | \n
| \n
| \nMí, téacsúil, 3 litir. | \n
| \n
| \nMí, téacsach, 3 litir, litreacha beaga. | \n
| \n
| \nMí, ionadaíocht mhalartach áitiúil a úsáidtear de ghnáth le haghaidh ionadaíocht dáta fada. | \n
| \n
| \nMí, téacsúil, fada. | \n
| \n
| \nGiorrúchán míosa i stíl Associated Press. Síneadh dílseánaigh. | \n
| \n
``t `` | \nLíon na laethanta sa mhí ar leith. | \n
| \n
Bliain | \n\n | \n |
| \nBliain, 2 dhigit le nialas tosaigh. | \n
| \n
| \nBliain, 4 dhigit le nialas tosaigh. | \n
| \n
| \nBoolean maidir le cibé an bhliain léim í. | \n
| \n
| \nBliain 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. | \n
| \n
Aim | \n\n | \n |
| \nUair an chloig, formáid 12 uair an chloig gan nialas tosaigh. | \n
| \n
| \nUair an chloig, formáid 24 uair an chloig gan nialas tosaigh. | \n
| \n
| \nUair an chloig, formáid 12 uair an chloig. | \n
| \n
| \nUair, formáid 24 uair an chloig. | \n
| \n
``I ` | \nMiontuairiscí | \n
| \n
| \nSoicind, 2 dhigit le nialas tosaigh. | \n
| \n
| \nMicreasoicind. | \n
| \n
| \n``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.) | \n
| \n
| \n
| \n
| \n
| \nAm, 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. | \n
| \n
| \nAm, 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. | \n
| \n
Crios Ama | \n\n | \n |
| \nAinm 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. | \n
| \n
``I ` | \nAm sábhála solais an lae, cibé an bhfuil sé i bhfeidhm nó nach bhfuil. | \n
| \n
| \nDifríocht le am Greenwich in uaireanta. | \n
| \n
``T `` | \nCrios ama an mheaisín seo. | \n
| \n
| \nFhrithá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í. | \n
| \n
Dáta/Aim | \n\n | \n |
| \nFormá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). | \n
| \n
| \n<5322 #section -3.3>:rfc: RFC 5322 dáta formáidithe. | \n
| \n
| \nSoicind ó Eocha Unix (1 Eanáir 1970 00:00:00 UTC). | \n\n |
Mar shampla:
\n{{ value|date:"D d M Y" }}\nMá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.
\nAg glacadh leis gur:setting: LANGUAGE_CODE, mar shampla, "es", ansin le haghaidh:
{{ value|date:"SHORT_DATE_FORMAT" }}\nis é 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:
\n{{ value|date }}\naschuir 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" }}\nré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:
\n{{ value|default:"nothing" }}\nMá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.
\nMar shampla:
\n{{ value|default_if_none:"nothing" }}\ndictsortLink 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
\nMar shampla:
\n{{ value|dictsort:"name" }}\nMás é “luach”:
\n[\n {"name": "zed", "age": 19},\n {"name": "amy", "age": 22},\n {"name": "joe", "age": 31},\n]\nansin bheadh an t-aschur:
\n[\n {"name": "amy", "age": 22},\n {"name": "joe", "age": 31},\n {"name": "zed", "age": 19},\n]\nIs féidir leat rudaí níos casta a dhéanamh freisin mar:
\n{% for book in books|dictsort:"author.age" %}\n * {{ book.title }} ({{ book.author.name }})\n{% endfor %}\nMás é “leabhair”:
\n[\n {"title": "1984", "author": {"name": "George", "age": 45}},\n {"title": "Timequake", "author": {"name": "Kurt", "age": 75}},\n {"title": "Alice", "author": {"name": "Lewis", "age": 33}},\n]\nansin bheadh an t-aschur:
\n* Alice (Lewis)\n* 1984 (George)\n* Timequake (Kurt)\nIs 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 }}\nMás é “luach”:
\n[\n ("a", "42"),\n ("c", "string"),\n ("b", "foo"),\n]\nansin bheadh an t-aschur:
\n[\n ("a", "42"),\n ("b", "foo"),\n ("c", "string"),\n]\nNí mór duit an t-innéacs a rith mar shláimhir seachas sreang. Táirgeann na seo a leanas aschur folamh:
\n{{ values|dictsort:"0" }}\nNí thacaítear le hordú de réir eilimintí ag innéacs sonraithe ar fhoclóirí
\ndictsortreversedLink 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.
\nroinntearLink to this heading#Tugann sé “Fíor” ar ais má tá an luach inroinnte leis an argóint.
\nMar shampla:
\n{{ value|divisibleby:"3" }}\nÉalaíonn sé HTML teaghrán. Go sonrach, déanann sé na hathsholáthairtí seo:
\nDé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.
\nMar shampla, is féidir leat escape a chur i bhfeidhm ar réimsí nuai:ttag: autoescape as:
{% autoescape off %}\n {{ title|escape }}\n{% endautoescape %}\nÉ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.
\nMar shampla:
\n<script>\nlet myValue = '{{ value|escapejs }}'\n`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:
\n{% autoescape off %}\n {{ my_list|escapeseq|join:", " }}\n{% endautoescape %}\nFormá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:
\n{{ value|filesizeformat }}\nMá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.
\nMar shampla:
\n{{ value|first }}\nMá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:
\n
| \nTeimpléad | \nAschur | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
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:
| \nTeimpléad | \nAschur | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
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.
\n
| \nTeimpléad | \nAschur | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
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:
\n
| \nTeimpléad | \nAschur | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
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:
| \nTeimpléad | \nAschur | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
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:
\n
| \nTeimpléad | \nAschur | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
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.
\nMar shampla, más mian leat na heilimintí <p>HTML ``a chruthaigh an scagair:tfilter: `linebreaks a ghabháil:
\n{% autoescape off %}\n {{ body|linebreaks|force_escape }}\n{% endautoescape %}\nfaigh_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í.
\nMar shampla:
\n{{ value|get_digit:"2" }}\nMá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.
\nTá sé sábháilte an scagaire seo a úsáid ar shreang atá imithe tríd an scagaire: tfilter: urlencode cheana féin.
\nMar shampla:
\n{{ value|iriencode }}\nMá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
\nMar shampla:
\n{{ value|join:" // " }}\nMá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.
\n**Argóint: ** An “id” HTML roghnach den chlib <script>```.
\nMar shampla:
\n{{ value|json_script:"hello-data" }}\nMás é luach an foclóir {'hello': 'world'}, is é an t-aschur:
<script id="hello-data" type="application/json">{"hello": "world"}</script>\nIs féidir rochtain a fháil ar na sonraí mar gheall air i JavaScript mar seo:
\nconst value = JSON.parse(document.getElementById('hello-data').textContent);\nMaolaí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>\nTá 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.
\ndeireannLink to this heading#Tugann an mír deireanach ar liosta ar ais.
\nMar shampla:
\n{{ value|last }}\nMás é luach an liosta ['a', 'b', 'c', 'd'], is é an t-aschur an teaghrán "d".
Tugann sé ar ais fad an luacha. Oibríonn sé seo le haghaidh teaghráin agus liostaí araon.
\nMar shampla:
\n{{ value|length }}\nMá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:
\n{{ value|linebreaks }}\n<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>```).
\nMar shampla:
\n{{ value|linebreaksbr }}\n<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.
\nMar shampla:
\n{{ value|linenumbers }}\nMás é “luach”:
\none\ntwo\nthree\nbeidh an t-aschur:
\n1. one\n2. two\n3. three\n`fuaimLink to this heading#Ailíníonn clé an luach i réimse de leithead ar leith.
\n**Argóint: ** méid réimse
\nMar shampla:
\n"{{ value|ljust:"10" }}"\nAthraíonn sé sreang go léir litreacha beaga.
\nMar shampla:
\n{{ value|lower }}\nMá 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.
\nMar shampla:
\n{{ value|make_list }}\nMá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
\nNí gá go mbeadh an t-ionchur ina uimhir theileafóin bailí. Déanfaidh sé seo aon sreang a thiontú go sona sásta.
\nMar shampla:
\n{{ value|phone2numeric }}\nMá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:
\nYou have {{ num_messages }} message{{ num_messages|pluralize }}.\nMá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:
\nYou have {{ num_walruses }} walrus{{ num_walruses|pluralize:"es" }}.\nMaidir 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.
\nSampla:
\nYou have {{ num_cherries }} cherr{{ num_cherries|pluralize:"y,ies" }}.\npprintLink to this heading#Fillteán timpeall: func: pprint.pprint - le haghaidh dífhabhtú, i ndáiríre.
\nrandamLink to this heading#Tugann mír randamach ar ais ón liosta a thugtar.
\nMar shampla:
\n{{ value|random }}\nMá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.
\n**Argóint: ** méid réimse
\nMar shampla:
\n"{{ value|rjust:"10" }}"\nMá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.
\n\nsá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:
\n{{ some_list|safeseq|join:", " }}\nNí 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.
\nsliseLink to this heading#Tugann sé slisnán den liosta ar ais.
\nÚ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á.
\nSampla:
\n{{ some_list|slice:":2" }}\nMá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.
\nMar shampla:
\n{{ value|slugify }}\nMá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.
\nMar shampla:
\n{{ value|stringformat:"E" }}\nMás é `luach 10, is é 1.000000E+01` an t-aschur.
Formálaíonn sé am de réir an fhormáid a thugtar.
\nIs 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.
\nMar shampla:
\n{{ value|time:"H:i" }}\nMá 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:
\n{{ value|time:"H\\h i\\m" }}\nTaispeánfaí sé seo mar “01h 23m”.
\nSampla eile:
\nAg glacadh leis gur:setting: LANGUAGE_CODE, mar shampla, de", ansin le haghaidh:
{{ value|time:"TIME_FORMAT" }}\nis é 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).
\n<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 ``:
\n{{ value|time }}\ntá sé mar an gcéanna le:
\n{{ value|time:"TIME_FORMAT" }}\n`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”).
\nTó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 }}\nCuirfear sreang folamh ar ais ar ais i gcomparáid idir amanna dáta nach n-aithníonn agus na hamanna atá ar an eolas
\nIs é 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.
\n`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 }}\nCuirfear sreang folamh ar ais ar ais i gcomparáid idir amanna dáta nach n-aithníonn agus na hamanna atá ar an eolas
\nIs é 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.
\nDé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.
\nMar shampla:
\n{{ value|title }}\nMá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 (“...”).
\n**Argóint: ** Líon na gcarachtar le gearradh
\nMar shampla:
\n{{ value|truncatechars:7 }}\nMá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.
\nMar shampla:
\n{{ value|truncatechars_html:7 }}\n<p>Más é luach ” Is <p>slug é Joel “, is é an</p> t-aschur ” Joel i... “.</p>
Caomhnófar línte nua san ábhar HTML.
\n\n\n`truncatewordsLink to this heading#Cuireann sé teaghrán tar éis líon áirithe focal.
\n**Argóint: ** Líon na bhfocal le gearradh ina dhiaidh sin
\nMar shampla:
\n{{ value|truncatewords:2 }}\nMás é luach "Is slug é Joel", is é an t-aschur "Is é Joel... ".
Bainfear línte nua laistigh den teaghrán.
\ntruncatewords_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.
\nNí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.
\nMar shampla:
\n{{ value|truncatewords_html:2 }}\n<p>Más é luach ” Is <p>slug é Joel “, is é an</p> t-aschur ” Is é Joel... “.</p>
Caomhnófar línte nua san ábhar HTML.
\n\n\nliosta_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.
\nGlactar 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\n<ul>\n <li>Kansas\n <ul>\n <li>Lawrence</li>\n <li>Topeka</li>\n </ul>\n </li>\n <li>Illinois</li>\n</ul>\n</li>\nuachtarLink to this heading#Athraíonn sé teaghrán i ngach uachchlár.
\nMar shampla:
\n{{ value|upper }}\nMás é luach "Is slóg é Joel", is é an t-aschur "JOEL IS A SLUG".
Éalaíonn sé luach le húsáid i URL.
\nMar shampla:
\n{{ value|urlencode }}\nMá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.
\nMura 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:
\n{{ value|urlencode:"" }}\nMá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.
\nOibrí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.
\nTá tréith rel="nofollow" curtha leis na naisc a ghineann urlize.
Mar shampla:
\n{{ value|urlize }}\n<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.
\n**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.
\nMar shampla:
\n{{ value|urlizetrunc:15 }}\n<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í.
\nTugann sé líon na bhfocal ar ais.
\nMar shampla:
\n{{ value|wordcount }}\nMás é luach `"Is slug é Joel", is é 4 an t-aschur.
Fillteann sé focail ag fad líne sonraithe.
\n**Argóint: ** líon na gcarachtar chun an téacs a fhilleadh
\nMar shampla:
\n{{ value|wordwrap:5 }}\nMás é luach ````Sluig é Joel ``, bheadh an t-aschur:
Joel\nis a\nslug\nYesnoLink 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:
\n{{ value|yesno:"yeah,no,maybe" }}\n