Detta dokument beskriver Djangos inbyggda malltaggar och filter. Det rekommenderas att du använder automatisk dokumentation, om tillgängligt, eftersom detta också kommer att innehålla dokumentation för eventuella anpassade taggar eller filter som installerats.
\nautoescapeLink to this heading#Styr det aktuella auto-escaping-beteendet. Denna tagg tar antingen on eller off som argument och avgör om auto-escaping är i kraft inuti blocket. Blocket stängs med en endautoescape sluttagg.
Exempel på användning:
\n{% autoescape on %}\n {{ body }}\n{% endautoescape %}\nNär automatisk eskapning används, tillämpas HTML-eskapning på allt innehåll som härrör från variabler innan resultatet placeras i utdata (men efter att eventuella filter har tillämpats). Detta motsvarar att manuellt tillämpa filtret escape på varje variabel.
De enda undantagen är variabler som redan markerats som ”säkra” från escaping. Variabler kan vara markerade som ”säkra” av koden som fyllde i variabeln, genom att tillämpa filtren safe eller escape, eller för att det är resultatet av ett tidigare filter som markerade strängen som ”säker”.
Inom ramen för inaktiverad automatisk eskapning kan kedjning av filter, inklusive escape, orsaka oväntade (men dokumenterade) resultat som följande:
{% autoescape off %}\n {{ my_list|join:", "|escape }}\n{% endautoescape %}\nOvanstående kod kommer att mata ut de sammanfogade elementen i my_list utan escaping. Detta beror på att filterkedjans sekvens först kör join på my_list (utan att tillämpa escaping på varje element eftersom autoescape är off), vilket markerar resultatet som säkert. Därefter kommer detta säkra resultat att matas till escape-filter, som inte tillämpar en andra omgång av escaping.
För att på rätt sätt undkomma varje element i en sekvens, använd filtret escapeseq:
{% autoescape off %}\n {{ my_list|escapeseq|join:", " }}\n{% endautoescape %}\nblockLink to this heading#Definierar ett block som kan åsidosättas av underordnade mallar. Se Mallarv för mer information.
\nkommentarLink to this heading#Ignorerar allt mellan {% comment %} och {% endcomment %}. En valfri kommentar kan infogas i den första taggen. Detta är t.ex. användbart när du kommenterar kod för att dokumentera varför koden inaktiverades.
Exempel på användning:
\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 %}\ncomment-taggar kan inte nästlas.
csrf_tokenLink to this heading#Den här taggen används för CSRF-skydd, enligt beskrivningen i dokumentationen för Cross Site Request Forgeries.
\ncykelLink to this heading#Producerar ett av sina argument varje gång denna tagg påträffas. Det första argumentet produceras vid det första mötet, det andra argumentet vid det andra mötet och så vidare. När alla argument är uttömda går taggen tillbaka till det första argumentet och producerar det igen.
\nDenna tagg är särskilt användbar i en loop:
\n{% for o in some_list %}\n <tr class="{% cycle 'row1' 'row2' %}">\n ...\n </tr>\n{% endfor %}\nDen första iterationen producerar HTML som hänvisar till klass row1, den andra till row2, den tredje till row1 igen, och så vidare för varje iteration av loopen.
Du kan också använda variabler. Om du till exempel har två mallvariabler, rowvalue1 och rowvalue2, kan du växla mellan deras värden så här:
{% for o in some_list %}\n <tr class="{% cycle rowvalue1 rowvalue2 %}">\n ...\n </tr>\n{% endfor %}\nVariabler som ingår i cykeln kommer att escapas. Du kan inaktivera automatisk escaping med :
\n{% for o in some_list %}\n <tr class="{% autoescape off %}{% cycle rowvalue1 rowvalue2 %}{% endautoescape %}">\n ...\n </tr>\n{% endfor %}\nDu kan blanda variabler och strängar:
\n{% for o in some_list %}\n <tr class="{% cycle 'row1' rowvalue2 'row3' %}">\n ...\n </tr>\n{% endfor %}\nI vissa fall kanske du vill hänvisa till det aktuella värdet i en cykel utan att gå vidare till nästa värde. För att göra detta ger du taggen {% cycle %} ett namn med hjälp av ”as”, så här:
{% cycle 'row1' 'row2' as rowcolors %}\nFrån och med nu kan du infoga cykelns aktuella värde var du vill i din mall genom att referera till cykelns namn som en kontextvariabel. Om du vill flytta cykeln till nästa värde oberoende av den ursprungliga cycle-taggen, kan du använda en annan cycle-tagg och ange namnet på variabeln. Så, följande mall:
<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>\nskulle mata ut:
\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>\nDu kan använda valfritt antal värden i en cycle-tagg, åtskilda med mellanslag. Värden inom enkla citattecken (') eller dubbla citattecken (") behandlas som stränglitteraler, medan värden utan citattecken behandlas som mallvariabler.
Som standard, när du använder nyckelordet as med cykeltaggen, kommer användningen av {% cycle %} som initierar cykeln själv att producera det första värdet i cykeln. Detta kan vara ett problem om du vill använda värdet i en nästlad loop eller i en inkluderad mall. Om du bara vill deklarera cykeln men inte producera det första värdet kan du lägga till nyckelordet silent som det sista nyckelordet i taggen. Till exempel:
{% for obj in some_list %}\n {% cycle 'row1' 'row2' as rowcolors silent %}\n <tr class="{{ rowcolors }}">{% include "subtemplate.html" %}</tr>\n{% endfor %}\nDetta ger en lista med <tr> element med class alternerande mellan row1 och row2. Undermallen kommer att ha tillgång till rowcolors i sitt sammanhang och värdet kommer att matcha klassen på <tr> som omsluter den. Om nyckelordet silent skulle utelämnas, skulle row1 och row2 skickas ut som vanlig text, utanför elementet <tr>.
När nyckelordet silent används för en cykeldefinition, gäller tystnaden automatiskt för alla efterföljande användningar av den specifika cykeltaggen. Följande mall skulle ge ut ingenting, även om det andra anropet till {% cycle %} inte specificerar silent:
{% cycle 'row1' 'row2' as rowcolors silent %}\n{% cycle rowcolors %}\nDu kan använda resetcycle-taggen för att få en {% cycle %}-tagg att starta om från sitt första värde nästa gång den påträffas.
debugLink to this heading#Skriver ut en hel del felsökningsinformation, inklusive aktuell kontext och importerade moduler. {% debug %} skriver inte ut någonting när inställningen DEBUG är False.
förlängerLink to this heading#Signalerar att denna mall utvidgar en överordnad mall.
\nDenna tagg kan användas på två sätt:
\n{% extends "base.html" %} (med citationstecken) använder det bokstavliga värdet "base.html" som namn på den överordnade mall som ska utökas.
{% extends variable %} använder värdet av variable. Om variabeln utvärderas till en sträng, kommer Django att använda den strängen som namn på den överordnade mallen. Om variabeln utvärderas till ett Template-objekt, kommer Django att använda det objektet som den överordnade mallen.
Se Arv av mall för mer information.
\nNormalt är mallnamnet relativt till mallinläsningsprogrammets rotkatalog. Ett strängargument kan också vara en relativ sökväg som börjar med ./ eller ../. Anta t.ex. följande katalogstruktur:
dir1/\n template.html\n base2.html\n my/\n base3.html\nbase1.html\nI template.html skulle följande sökvägar vara giltiga:
{% extends "./base2.html" %}\n{% extends "../base1.html" %}\n{% extends "./my/base3.html" %}\nfilterLink to this heading#Filtrerar innehållet i blocket genom ett eller flera filter. Flera filter kan anges med pipes och filter kan ha argument, precis som i variabelsyntaxen.
\nObservera att blocket innehåller all text mellan taggarna filter och endfilter.
Exempel på användning:
\n{% filter force_escape|lower %}\n This text will be HTML-escaped, and will appear in all lowercase.\n{% endfilter %}\nförstLink to this heading#Den första argumentvariabeln som inte är ”false” (dvs. existerar, inte är tom, inte är ett falskt booleskt värde och inte är ett numeriskt nollvärde) matas ut. Ger ingenting om alla variabler som skickas är ”false”.
\nExempel på användning:
\n{% firstof var1 var2 var3 %}\nDetta är likvärdigt med:
\n{% if var1 %}\n {{ var1 }}\n{% elif var2 %}\n {{ var2 }}\n{% elif var3 %}\n {{ var3 }}\n{% endif %}\nDu kan också använda en bokstavlig sträng som ett reservvärde om alla variabler som skickas är False:
\n{% firstof var1 var2 var3 "fallback value" %}\nDenna tagg skriver automatiskt ut variabelvärden. Du kan inaktivera auto-escaping med:
\n{% autoescape off %}\n {% firstof var1 var2 var3 "<strong>fallback value</strong>" %}\n{% endautoescape %}\nEller om bara vissa variabler ska escapas kan du använda:
\n{% firstof var1 var2|safe var3 "<strong>fallback value</strong>"|safe %}\nDu kan använda syntaxen {% firstof var1 var2 var3 as value %} för att lagra utdata i en variabel.
förLink to this heading#Loopar över varje objekt i en array och gör objektet tillgängligt i en kontextvariabel. Till exempel: för att visa en lista över idrottare som finns i athlete_list:
<ul>\n{% for athlete in athlete_list %}\n <li>{{ athlete.name }}</li>\n{% endfor %}\n</ul>\nDu kan loopa över en lista i omvänd ordning genom att använda {% for obj in list reversed %}.
Om du behöver loopa över en lista med listor kan du packa upp värdena i varje dellista till enskilda variabler. Om ditt sammanhang till exempel innehåller en lista med (x,y)-koordinater som kallas points, kan du använda följande för att mata ut listan med punkter:
{% for x, y in points %}\n There is a point at {{ x }},{{ y }}\n{% endfor %}\nDetta kan också vara användbart om du behöver komma åt objekten i en ordbok. Om ditt sammanhang till exempel innehåller en ordbok data, skulle följande visa nycklarna och värdena i ordboken:
{% for key, value in data.items %}\n {{ key }}: {{ value }}\n{% endfor %}\nTänk på att för dot-operatorn har nyckeluppslagning i en ordbok företräde framför metoduppslagning. Om ordboken data innehåller en nyckel med namnet 'items' kommer därför data.items att returnera data['items'] istället för data.items(). Undvik att lägga till nycklar som är namngivna som dictionary-metoder om du vill använda dessa metoder i en mall (items, values, keys, etc.). Läs mer om uppslagsordningen för dot-operatorn i documentation of template variables.
For-slingan ställer in ett antal variabler som är tillgängliga inom slingan:
\nVariabel | \nBeskrivning | \n
|---|---|
| \nDen aktuella iterationen av slingan (1-indexerad) | \n
| \nDen aktuella iterationen av loopen (0-indexerad) | \n
| \nAntalet iterationer från slutet av slingan (1-indexerad) | \n
| \nAntalet iterationer från slutet av slingan (0-indexerad) | \n
| \nTrue om detta är första gången genom slingan | \n
| \nTrue om detta är sista gången genom slingan | \n
| \nFör nästlade loopar är detta den loop som omger den aktuella loopen | \n
för … tomtLink to this heading#Taggen for kan innehålla en valfri klausul {% empty %} vars text visas om den angivna matrisen är tom eller inte kunde hittas:
<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>\nOvanstående är likvärdigt med - men kortare, renare och möjligen snabbare än - följande:
\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>\nomLink to this heading#Taggen {% if %} utvärderar en variabel och om variabeln är ”sann” (dvs. existerar, inte är tom och inte är ett falskt booleskt värde) matas innehållet i blocket ut:
{% 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 %}\nOm athlete_list inte är tom visas antalet deltagare i variabeln {{ athlete_list|length }} i ovanstående exempel.
Som du ser kan taggen if innehålla en eller flera klausuler av typen {% elif %}, samt en klausul av typen {% else %} som visas om alla tidigare villkor misslyckas. Dessa klausuler är valfria.
if-taggar kan använda och, eller eller inte för att testa ett antal variabler eller för att negera en viss variabel:
{% 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 %}\nAnvändning av både och och eller klausuler inom samma tagg är tillåtet, där och har högre prioritet än eller t.ex:
{% if athlete_list and coach_list or cheerleader_list %}\nkommer att tolkas som:
\nif (athlete_list and coach_list) or cheerleader_list:\n ...\nAnvändning av faktiska parenteser i if-taggen är ogiltig syntax. Om du behöver dem för att ange företräde, bör du använda nästlade if-taggar.
if-taggar kan också använda operatorerna ==, !=, <, >, <=, >=, in, not in, is och is not som fungerar på följande sätt:
==Link to this heading#Jämlikhet. Ett exempel:
\n{% if somevar == "x" %}\n This appears if variable somevar equals the string "x"\n{% endif %}\n!=Link to this heading#Ojämlikhet. Ett exempel:
\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< operatörLink to this heading#Mindre än. Ett exempel:
\n{% if somevar < 100 %}\n This appears if variable somevar is less than 100.\n{% endif %}\n> operatörLink to this heading#Större än. Exempel:
\n{% if somevar > 0 %}\n This appears if variable somevar is greater than 0.\n{% endif %}\n<=Link to this heading#Mindre än eller lika med. Exempel:
\n{% if somevar <= 100 %}\n This appears if variable somevar is less than 100 or equal to 100.\n{% endif %}\n>=Link to this heading#Större än eller lika med. Exempel:
\n{% if somevar >= 1 %}\n This appears if variable somevar is greater than 1 or equal to 1.\n{% endif %}\nin operatörLink to this heading#Innehåller inom. Denna operator stöds av många Python-containrar för att testa om det givna värdet finns i containern. Följande är några exempel på hur x i y kommer att tolkas:
{% 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 %}\ninte i operatörLink to this heading#Inte innesluten i. Detta är negationen av operatorn in.
Objektets identitet. Testar om två värden är samma objekt. Exempel på detta:
\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 %}\när inte operatörLink to this heading#Negerad identitet för objekt. Testar om två värden inte är samma objekt. Detta är negationen av operatorn is. Exempel på detta:
{% 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 %}\nDu kan också använda filter i if-uttrycket. Ett exempel:
{% if messages|length >= 100 %}\n You have lots of messages today!\n{% endif %}\nAlla ovanstående kan kombineras för att bilda komplexa uttryck. För sådana uttryck kan det vara viktigt att veta hur operatorerna grupperas när uttrycket utvärderas - det vill säga prioritetsreglerna. Operatorernas rangordning, från lägsta till högsta, är följande:
\neller
och
inte
in
==, !=, <, >, <=, >=
(Detta följer Python exakt). Så, till exempel, följande komplexa if tagg:
{% if a == b or c == d and e %}\n…kommer att tolkas som:
\n(a == b) or ((c == d) and e)\nOm du behöver olika företräde måste du använda nästlade if-taggar. Ibland är det ändå bättre för tydlighetens skull, för dem som inte känner till företrädesreglerna.
Jämförelseoperatorerna kan inte ”kedjas” som i Python eller i matematisk notation. Till exempel:, istället för att använda:
\n{% if a > b > c %} (WRONG)\ndu bör använda:
\n{% if a > b and b > c %}\nifchangedLink to this heading#Kontrollera om ett värde har ändrats sedan den senaste iterationen av en loop.
\nBlocktaggen {% ifchanged %} används inom en loop. Den har två möjliga användningsområden.
Kontrollerar sitt eget återgivna innehåll mot dess tidigare tillstånd och visar bara innehållet om det har ändrats. Detta visar t.ex. en lista med dagar och visar bara månaden om den har ändrats:
\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 %}\nOm du får en eller flera variabler, kontrollera om någon variabel har ändrats. I följande exempel visas till exempel datumet varje gång det ändras, medan timmen visas om antingen timmen eller datumet har ändrats:
\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 %}\nTaggen ifchanged kan också innehålla en valfri klausul {% else %} som visas om värdet inte har ändrats:
{% 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 %}\ninkluderaLink to this heading#Läser in en mall och renderar den i det aktuella sammanhanget. Detta är ett sätt att ”inkludera” andra mallar i en mall.
\nMallnamnet kan antingen vara en variabel eller en hårdkodad (citerad) sträng, inom antingen enkla eller dubbla citattecken.
\nI detta exempel inkluderas innehållet i mallen "foo/bar.html":
{% include "foo/bar.html" %}\nNormalt är mallnamnet relativt till mallinläsningsprogrammets rotkatalog. Ett strängargument kan också vara en relativ sökväg som börjar med ./ eller ../ enligt beskrivningen i taggen extends.
I det här exemplet inkluderas innehållet i den mall vars namn finns i variabeln template_name:
{% include template_name %}\nVariabeln kan också vara vilket objekt som helst med en render()-metod som accepterar en kontext. Detta gör att du kan referera till en kompilerad Template i din kontext.
Dessutom kan variabeln vara en iterabel av mallnamn, i vilket fall den första som kan laddas kommer att användas, enligt select_template().
En inkluderad mall återges i kontexten för den mall som inkluderar den. Detta exempel ger utdata "Hello, John!":
Kontext: variabeln person är satt till "John" och variabeln greeting är satt till "Hello".
Mall:
\n{% include "name_snippet.html" %}\nMallen namn_snippet.html:
{{ greeting }}, {{ person|default:"friend" }}!\nDu kan skicka ytterligare kontext till mallen med hjälp av nyckelordsargument:
\n{% include "name_snippet.html" with person="Jane" greeting="Hello" %}\nOm du vill att kontexten endast ska återges med de angivna variablerna (eller inga variabler alls) använder du alternativet only. Inga andra variabler är tillgängliga för den inkluderade mallen:
{% include "name_snippet.html" with greeting="Hi" only %}\nLaddaLink to this heading#Läser in en uppsättning anpassade malltaggar.
\nExempelvis skulle följande mall ladda alla taggar och filter som är registrerade i somelibrary och otherlibrary som finns i paketet package:
{% load somelibrary package.otherlibrary %}\nDu kan också selektivt ladda enskilda filter eller taggar från ett bibliotek med hjälp av argumentet from. I det här exemplet laddas malltaggarna/-filtren med namnen foo och bar från somelibrary:
{% load foo bar from somelibrary %}\nSe Anpassade tagg- och filterbibliotek för mer information.
\nloremLink to this heading#Visar slumpmässig latinsk text av typen ”lorem ipsum”. Detta är användbart för att tillhandahålla exempeldata i mallar.
\nAnvändning:
\n{% lorem [count] [method] [random] %}\nTaggen {% lorem %} kan användas med noll, ett, två eller tre argument. Argumenten är:
Argument | \nBeskrivning | \n
|---|---|
| \nEtt tal (eller en variabel) som innehåller antalet stycken eller ord som ska genereras (standard är 1). | \n
| \nAntingen | \n
| \nOrdet | \n
Exempel:
\n{% lorem %} ger ett vanligt ”lorem ipsum”-stycke.
{% lorem 3 p %} ger ut det vanliga ”lorem ipsum”-stycket och två slumpmässiga stycken, vart och ett inslaget i HTML-taggen <p>.
{% lorem 2 w random %} kommer att mata ut två slumpmässiga latinska ord.
nuLink to this heading#Visar aktuellt datum och/eller aktuell tid i ett format som överensstämmer med den angivna strängen. En sådan sträng kan innehålla formatspecificerande tecken enligt beskrivningen i filteravsnittet date.
Exempel:
\nIt is {% now "jS F Y H:i" %}\nObservera att du kan backslash-escape en formatsträng om du vill använda det ”råa” värdet. I det här exemplet är både ”o” och ”f” backslash-escaped, eftersom de annars är formatsträngar som visar år respektive tid:
\nIt is the {% now "jS \\o\\f F" %}\nDetta skulle visas som ”Det är den 4 september”.
\n\nDu kan också använda syntaxen {% now "Y" as current_year %} för att lagra utdata (som en sträng) i en variabel. Detta är användbart om du vill använda {% now %} inuti en malltagg som till exempel blocktranslate:
{% now "Y" as current_year %}\n{% blocktranslate %}Copyright {{ current_year }}{% endblocktranslate %}\nfrågeställningLink to this heading#Skickar ut en URL-kodad formaterad frågesträng baserat på de angivna parametrarna.
\nDenna tagg kräver en QueryDict-instans, som som standard är request.GET om ingen anges.
Om QueryDict är tom och inga ytterligare parametrar har angetts, returneras en tom sträng. Annars innehåller resultatet en ledande "?".
{% querystring %}\nSkriver ut den aktuella frågesträngen ordagrant. Så om frågesträngen är ?color=green, skulle utdata vara ?color=green.
{% querystring size="M" %}\nSkriver ut den aktuella frågesträngen med tillägg av parametern size. I enlighet med föregående exempel skulle utdata vara ?color=green&size=M.
{% querystring my_query_dict %}\nDu kan tillhandahålla en anpassad QueryDict som ska användas istället för request.GET. Så om my_query_dict är <QueryDict: {'color': ['blue']}>, ger detta ut ?color=blue.
{% querystring color="red" size="S" %}\nLägger till eller ändrar parametrar i frågesträngen. Varje nyckelordsargument läggs till i frågesträngen och ersätter alla befintliga värden för den nyckeln. Om den aktuella frågesträngen till exempel är ?color=green, blir resultatet ?color=red&size=S.
{% querystring color=None %}\nOm du anger None som värde tas parametern bort från frågesträngen. Om den aktuella frågesträngen till exempel är ?color=green&size=M, blir utdata ?size=M.
{% querystring color=my_list %}\nOm my_list är ["red", "blue"] blir utdata ?color=red&color=blue, vilket bevarar liststrukturen i frågesträngen.
Ett vanligt exempel på användning av denna tagg är att bevara den aktuella frågesträngen när en resultatsida visas, samtidigt som en länk till nästa och föregående resultatsida läggs till. Om paginatorn till exempel befinner sig på sidan 3 och den aktuella frågesträngen är ?color=blue&size=M&page=3, skulle följande kod ge ?color=blue&size=M&page=4:
{% querystring page=page.next_page_number %}\nDu kan också lagra värdet i en variabel. Om du t.ex. behöver flera länkar till samma sida kan du definiera den som:
\n{% querystring page=page.next_page_number as next_page %}\nomgrupperingLink to this heading#Omgrupperar en lista med likadana objekt efter ett gemensamt attribut.
\nDenna komplexa tagg illustreras bäst med hjälp av ett exempel: säg att cities är en lista över städer som representeras av ordböcker som innehåller nycklarna "name", "population" och "country":
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…och du vill visa en hierarkisk lista som är sorterad efter land, så här:
\nIndien
\nMumbai: 19.000.000
Calcutta: 15,000,000
USA
\nNew York: 20.000.000
Chicago: 7.000.000
Japan
\nTokyo: 33,000,000
Du kan använda taggen {% regroup %} för att gruppera listan över städer efter land. Följande utdrag av mallkod skulle åstadkomma detta:
{% 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>\nLåt oss gå igenom det här exemplet. {% regroup %} tar tre argument: listan du vill omgruppera, attributet som ska grupperas efter och namnet på den resulterande listan. Här omgrupperar vi listan cities med attributet country och kallar resultatet country_list.
{% regroup %} producerar en lista (i det här fallet country_list) med gruppobjekt. Gruppobjekt är instanser av namedtuple() med två fält:
grouper – objektet som grupperades av (t.ex. strängen ”India” eller ”Japan”).
list – en lista över alla objekt i denna grupp (t.ex. en lista över alla städer med country=’India’).
Eftersom {% regroup %} producerar namedtuple()-objekt kan du också skriva det föregående exemplet som:
{% 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>\nObservera att {% regroup %} inte ordnar sina indata! Vårt exempel bygger på det faktum att listan cities från början var ordnad efter country. Om listan cities inte ordnade sina medlemmar efter country skulle omgrupperingen naivt nog visa mer än en grupp för ett enda land. Säg till exempel att listan cities var inställd på detta (notera att länderna inte är grupperade tillsammans):
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]\nMed denna indata för cities skulle exemplet {% regroup %} mallkod ovan resultera i följande utdata:
Indien
\nMumbai: 19.000.000
USA
\nNew York: 20.000.000
Indien
\nCalcutta: 15,000,000
USA
\nChicago: 7.000.000
Japan
\nTokyo: 33,000,000
Den enklaste lösningen på detta problem är att i visningskoden se till att data är ordnade enligt hur du vill visa dem.
\nEn annan lösning är att sortera data i mallen med hjälp av filtret dictsort, om data finns i en lista med ordböcker:
{% regroup cities|dictsort:"country" by country as country_list %}\nAlla giltiga malluppslagningar är ett lagligt grupperingsattribut för regroup-taggen, inklusive metoder, attribut, ordboksnycklar och listobjekt. Om t.ex. fältet ”country” är en främmande nyckel till en klass med attributet ”description”, kan du använda:
\n{% regroup cities by country.description as country_list %}\nEller, om country är ett fält med choices, kommer det att ha en get_FOO_display()-metod tillgänglig som ett attribut, så att du kan gruppera på visningssträngen snarare än choices-nyckeln:
{% regroup cities by get_country_display as country_list %}\n{{ country.grouper }} kommer nu att visa värdefälten från uppsättningen choices i stället för nycklarna.
återställ cykelLink to this heading#Återställer en tidigare cycle så att den börjar om från sitt första objekt vid nästa möte. Utan argument kommer {% resetcycle %} att återställa den sista {% cycle %} som definierats i mallen.
Exempel på användning:
\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 %}\nDetta exempel skulle returnera denna HTML:
\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>\nLägg märke till hur det första blocket slutar med class="odd" och det nya börjar med class="odd". Utan taggen {% resetcycle %} skulle det andra blocket börja med class="even".
Du kan också återställa namngivna cykeltaggar:
\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 %}\nI det här exemplet har vi både de omväxlande udda/jämna raderna och en ”stor” rad var femte rad. Endast cykeln med fem rader återställs när en kategori ändras.
\nTar bort blanksteg mellan HTML-taggar. Detta inkluderar tabbtecken och nya linjer.
\nExempel på användning:
\n{% spaceless %}\n <p>\n <a href="foo/">Foo</a>\n </p>\n{% endspaceless %}\nDetta exempel skulle returnera denna HTML:
\n<p><a href="foo/">Foo</a></p>\nEndast mellanrum mellan taggar tas bort - inte mellanrum mellan taggar och text. I det här exemplet kommer inte utrymmet runt Hello att tas bort:
{% spaceless %}\n <strong>\n Hello\n </strong>\n{% endspaceless %}\ntemplatetagLink to this heading#Skriver ut ett av de syntaxtecken som används för att komponera malltaggar.
\nMallsystemet har inget koncept för att ”undkomma” enskilda tecken. Du kan dock använda taggen {% templatetag %} för att visa en av malltaggens teckenkombinationer.
Argumentet talar om vilken mallbit som ska matas ut:
\nArgument | \nUtgångar | \n
|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
”Stäng variabeln | \n
| \n
| \n
| \n
”Stäng skenan | \n
| \n
| \n
| \n
”Stäng kommentaren | \n
| \n
Exempel på användning:
\nThe {% templatetag openblock %} characters open a block.\nSe även taggen verbatim för ett annat sätt att inkludera dessa tecken.
urlLink to this heading#Returnerar en absolut sökvägsreferens (en URL utan domännamn) som matchar en given vy och valfria parametrar. Eventuella specialtecken i den resulterande sökvägen kommer att kodas med iri_to_uri().
Detta är ett sätt att mata ut länkar utan att bryta mot DRY-principen genom att behöva hårdkoda webbadresser i dina mallar:
\n{% url 'some-url-name' v1 v2 %}\nDet första argumentet är en URL-mönsternamn. Det kan vara en citerad bokstav eller någon annan kontextvariabel. Ytterligare argument är valfria och bör vara mellanslagsseparerade värden som kommer att användas som argument i URL:en. Exemplet ovan visar hur man skickar positionella argument. Alternativt kan du använda nyckelordssyntax:
\n{% url 'some-url-name' arg1=v1 arg2=v2 %}\nBlanda inte både positionell syntax och nyckelordssyntax i ett och samma anrop. Alla argument som krävs av URLconf ska finnas med.
\nAnta till exempel att du har en vy, app_views.client, vars URLconf tar ett klient-ID (här är client() en metod i vyfilen app_views.py). URLconf-raden kan se ut så här:
path("client/<int:id>/", app_views.client, name="app-views-client")\nOm den här appens URLconf inkluderas i projektets URLconf under en sökväg som denna:
\npath("clients/", include("project_name.app_name.urls"))\n…sedan, i en mall, kan du skapa en länk till den här vyn så här:
\n{% url 'app-views-client' client.id %}\nMalltaggen kommer att mata ut strängen /clients/client/123/.
Observera att om URL:en som du vänder inte finns, kommer du att få ett NoReverseMatch undantag, vilket kommer att leda till att din webbplats visar en felsida.
Om du vill hämta en URL utan att visa den kan du använda ett lite annorlunda anrop:
\n{% url 'some-url-name' arg arg2 as the_url %}\n\n<a href="{{ the_url }}">I'm linking to {{ the_url }}</a>\nOmfattningen av den variabel som skapas med syntaxen as var är det {% block %} i vilket taggen {% url %} förekommer.
Denna syntax {% url ... as var %} kommer inte att orsaka ett fel om vyn saknas. I praktiken kommer du att använda detta för att länka till vyer som är valfria:
{% url 'some-url-name' as the_url %}\n{% if the_url %}\n <a href="{{ the_url }}">Link to optional stuff</a>\n{% endif %}\nOm du vill hämta en URL med namnområde anger du det fullständigt kvalificerade namnet:
\n{% url 'myapp:view-name' %}\nDetta kommer att följa den normala namespaced URL resolution strategy, inklusive att använda eventuella ledtrådar som tillhandahålls av sammanhanget om den aktuella applikationen.
\n\nverbatimLink to this heading#Stoppar mallmotorn från att rendera innehållet i denna blocktagg.
\nEn vanlig användning är att tillåta ett JavaScript-mallskikt som kolliderar med Djangos syntax. Ett exempel:
\n{% verbatim %}\n {{if dying}}Still alive.{{/if}}\n{% endverbatim %}\nDu kan också ange en specifik avslutande tagg, vilket gör det möjligt att använda {% endverbatim %} som en del av det orenderade innehållet:
{% verbatim myblock %}\n Avoid template rendering via the {% verbatim %}{% endverbatim %} block.\n{% endverbatim myblock %}\nbreddförhållandeLink to this heading#För att skapa stapeldiagram och liknande beräknar den här taggen förhållandet mellan ett givet värde och ett maxvärde och tillämpar sedan förhållandet på en konstant.
\nTill exempel:
\n<img src="bar.png" alt="Bar"\n height="10" width="{% widthratio this_value max_value max_width %}">\nOm this_value är 175, max_value är 200 och max_width är 100 kommer bilden i exemplet ovan att vara 88 pixlar bred (eftersom 175/200 = 0,875; 0,875 * 100 = 87,5 som avrundas uppåt till 88).
I vissa fall kanske du vill fånga resultatet av widthratio i en variabel. Det kan till exempel vara användbart i en blocktranslate som denna:
{% widthratio this_value max_value max_width as width %}\n{% blocktranslate %}The width is: {{ width }}{% endblocktranslate %}\nCachelagrar en komplex variabel under ett enklare namn. Detta är användbart när man använder en ”dyr” metod (t.ex. en metod som slår i databasen) flera gånger.
\nTill exempel:
\n{% with total=business.employees.count %}\n {{ total }} employee{{ total|pluralize }}\n{% endwith %}\nDen ifyllda variabeln (i exemplet ovan total) är endast tillgänglig mellan taggarna {% with %} och {% endwith %}.
Du kan tilldela mer än en kontextvariabel:
\n{% with alpha=1 beta=2 %}\n ...\n{% endwith %}\naddLink to this heading#Lägger till argumentet till värdet.
\nTill exempel:
\n{{ value|add:"2" }}\nOm värde är 4, blir utdata 6.
Detta filter kommer först att försöka tvinga båda värdena till heltal. Om detta misslyckas försöker det ändå lägga ihop värdena. Detta kommer att fungera på vissa datatyper (strängar, listor etc.) och misslyckas på andra. Om det misslyckas blir resultatet en tom sträng.
\nTill exempel:, om vi har:
\n{{ first|add:second }}\noch först är [1, 2, 3] och andra är [4, 5, 6], så blir utdata [1, 2, 3, 4, 5, 6].
addslashesLink to this heading#Lägger till snedstreck före citattecken. Användbart för att undkomma strängar i CSV, till exempel.
\nTill exempel:
\n{{ value|addslashes }}\nOm värde är "Jag använder Django", kommer utdata att vara "Jag använder Django".
capfirstLink to this heading#Gör det första tecknet i värdet till en stor bokstav. Om det första tecknet inte är en bokstav har detta filter ingen effekt.
\nTill exempel:
\n{{ value|capfirst }}\nOm värde är "django", kommer utdata att vara "Django".
centerLink to this heading#Centrerar värdet i ett fält med en given bredd.
\nTill exempel:
\n"{{ value|center:"15" }}"\nOm värde är "Django", kommer utdata att vara " Django".
klippLink to this heading#Tar bort alla värden av arg från den angivna strängen.
\nTill exempel:
\n{{ value|cut:" " }}\nOm värde är "Sträng med mellanslag", kommer utdata att vara "Strängmed mellanslag".
datumLink to this heading#Formaterar ett datum enligt det angivna formatet.
\nAnvänder ett liknande format som PHP:s date()-funktion med några skillnader.
\n\nTillgängliga formatsträngar:
\nFormat tecken | \nBeskrivning | \nExempel utdata | \n
|---|---|---|
Dag | \n\n | \n |
| \nMånadsdag, 2 siffror med inledande nollor. | \n
| \n
| \nDag i månaden utan inledande nollor. | \n1 januari till 31 december | \n
| \nVeckodag, textuell, 3 bokstäver. | \n
| \n
| \nVeckodag, textuell, lång. | \n”Fredag | \n
| \nEngelskt ordinalsuffix för dag i månaden, 2 tecken. | \n
| \n
| \nVeckodag, siffror utan inledande nollor. | \n
| \n
| \nDag på året. | \n
| \n
Vecka | \n\n | \n |
| \nISO-8601 veckonummer för året, med veckor som börjar på måndag. | \n
| \n
Månad | \n\n | \n |
| \nMånad, 2 siffror med inledande nollor. | \n
| \n
| \nMånad utan inledande nollor. | \n”1” till ”12 | \n
| \nMånad, textuell, 3 bokstäver. | \n”Jan | \n
| \nMånad, text, 3 bokstäver, gemener. | \n
| \n
| \nMånad, lokalspecifik alternativ representation som vanligtvis används för lång datumrepresentation. | \n
| \n
| \nMånad, textuell, lång. | \n
| \n
| \nMånadsförkortning i Associated Press-stil. Proprietär förlängning. | \n”januari”, ”februari”, ”mars”, ”maj | \n
| \nAntal dagar i den angivna månaden. | \n
| \n
År | \n\n | \n |
| \nÅr, 2 siffror med inledande nollor. | \n
| \n
| \nÅr, 4 siffror med inledande nollor. | \n
| \n
| \nBoolean för om det är ett skottår. | \n
| \n
| \nISO-8601 veckonumrerat år, motsvarande ISO-8601 veckonummer (W) som använder skottveckor. Se Y för det mer vanliga årsformatet. | \n
| \n
Tid | \n\n | \n |
| \nTimme, 12-timmarsformat utan inledande nollor. | \n”1” till ”12 | \n
| \nTimme, 24-timmarsformat utan inledande nollor. | \n”0” till ”23 | \n
| \nTimme, 12-timmarsformat. | \n
| \n
| \nTimme, 24 timmars format. | \n
| \n
| \nProtokoll. | \n
| \n
| \nSekunder, 2 siffror med inledande nollor. | \n
| \n
| \nMikrosekunder. | \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \nTid, i 12-timmars timmar och minuter, med minuter utelämnade om de är noll. Proprietär förlängning. | \n
| \n
| \nTid, i 12-timmarstimmar, minuter och ”a.m.”/”p.m.”, med minuter utelämnade om de är noll och specialfallsträngarna ”midnight” och ”noon” i förekommande fall. Proprietär förlängning. | \n
| \n
Timezon | \n\n | \n |
| \nNamn på tidszon. Kan vara i vilket format som helst eller returnera en tom sträng, beroende på datatiden. | \n
| \n
| \nSommartid, oavsett om den är i kraft eller inte. | \n
| \n
| \nSkillnad mot Greenwich-tid i timmar. | \n
| \n
| \nTidszon för denna maskin. | \n
| \n
| \nTidszonsförskjutning i sekunder. Förskjutningen för tidszoner väster om UTC är alltid negativ och för tidszoner öster om UTC är den alltid positiv. | \n
| \n
Datum/Tid | \n\n | \n |
| \nISO 8601-format. (Obs: till skillnad från andra formaterare, t.ex. ”Z”, ”O” eller ”r”, kommer formateraren ”c” inte att lägga till tidszonsförskjutning om värdet är en naiv datetime (se | \n
| \n
| \nRFC 5322\nformatted date. | \n
| \n
| \nSekunder sedan Unix-epoken (1 januari 1970 00:00:00 UTC). | \n\n |
Till exempel:
\n{{ value|date:"D d M Y" }}\nOm value är ett datetime-objekt (t.ex. resultatet av datetime.datetime.now()), kommer utdata att vara strängen 'Wed 09 Jan 2008'.
Det format som skickas kan vara ett av de fördefinierade DATE_FORMAT, DATETIME_FORMAT, SHORT_DATE_FORMAT eller SHORT_DATETIME_FORMAT, eller ett eget format som använder formatspecifikationerna i tabellen ovan. Observera att fördefinierade format kan variera beroende på aktuell lokal.
Om man antar att LANGUAGE_CODE till exempel är "es", då för:
{{ value|date:"SHORT_DATE_FORMAT" }}\nskulle utdata vara strängen "09/01/2008" (formatspecifikationen "SHORT_DATE_FORMAT" för es locale som levereras med Django är "d/m/Y").
När den används utan en formatsträng används formatspecifikationen DATE_FORMAT. Med samma inställningar som i föregående exempel:
{{ value|date }}\nger ut 9 de Enero de 2008 (formatspecifikationen DATE_FORMAT för es-land är r'j \\d\\e F \\d\\e Y'). Både ”d” och ”e” är förslutna med backslash, eftersom de annars är formatsträngar som visar dagen respektive tidszonens namn.
Du kan kombinera date med filtret time för att återge en fullständig representation av ett datetime-värde. T.ex:
{{ value|date:"D d M Y" }} {{ value|time:"H:i" }}\nstandardLink to this heading#Om värdet utvärderas till False används det angivna standardvärdet. I annat fall används värdet.
Till exempel:
\n{{ value|default:"nothing" }}\nOm value är "" (den tomma strängen) blir utdata nothing.
standard_if_noneLink to this heading#Om (och endast om) värdet är None, används det angivna standardvärdet. I annat fall används värdet.
Observera att om en tom sträng anges kommer standardvärdet inte att användas. Använd filtret default om du vill använda en reservfunktion för tomma strängar.
Till exempel:
\n{{ value|default_if_none:"nothing" }}\nOm värde är None blir utdata ingenting.
DikteringsortLink to this heading#Tar en lista med lexikon och returnerar listan sorterad efter den nyckel som anges i argumentet.
\nTill exempel:
\n{{ value|dictsort:"name" }}\nOm värde är:
[\n {"name": "zed", "age": 19},\n {"name": "amy", "age": 22},\n {"name": "joe", "age": 31},\n]\nså skulle utmatningen vara:
\n[\n {"name": "amy", "age": 22},\n {"name": "joe", "age": 31},\n {"name": "zed", "age": 19},\n]\nDu kan också göra mer komplicerade saker som:
\n{% for book in books|dictsort:"author.age" %}\n * {{ book.title }} ({{ book.author.name }})\n{% endfor %}\nOm böcker är:
[\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]\nså skulle utmatningen vara:
\n* Alice (Lewis)\n* 1984 (George)\n* Timequake (Kurt)\ndictsort kan också ordna en lista med listor (eller något annat objekt som implementerar __getitem__())) efter element vid angivet index. Till exempel:
{{ value|dictsort:0 }}\nOm värde är:
[\n ("a", "42"),\n ("c", "string"),\n ("b", "foo"),\n]\nså skulle utmatningen vara:
\n[\n ("a", "42"),\n ("b", "foo"),\n ("c", "string"),\n]\nDu måste skicka indexet som ett heltal i stället för en sträng. Följande ger tom utdata:
\n{{ values|dictsort:"0" }}\nOrdning efter element vid angivet index stöds inte för lexikon.
\nDomslut omvändaLink to this heading#Tar en lista med lexikon och returnerar listan sorterad i omvänd ordning efter den nyckel som anges i argumentet. Detta fungerar på exakt samma sätt som ovanstående filter, men det returnerade värdet kommer att vara i omvänd ordning.
\ndelbar genomLink to this heading#Returnerar True om värdet är delbart med argumentet.
Till exempel:
\n{{ value|divisibleby:"3" }}\nOm värde är 21 blir utdata True.
flyktLink to this heading#Escapar en strängs HTML. Specifikt gör den dessa utbyten:
\n< konverteras till <
> konverteras till >
' (enkelt citattecken) konverteras till '
" (dubbelcitat) konverteras till "
& konverteras till &
Om du använder escape på en variabel som normalt skulle ha automatisk escaping på resultatet kommer det bara att resultera i en omgång av escaping. Så det är säkert att använda den här funktionen även i miljöer med automatisk escaping. Om du vill att flera escapingpass ska tillämpas, använd filtret force_escape.
Du kan t.ex. använda escape på fält när autoescape` är avstängt:
{% autoescape off %}\n {{ title|escape }}\n{% endautoescape %}\nescapejsLink to this heading#Escapar tecken för användning som en hel JavaScript-sträng, inom enkla eller dubbla citattecken, enligt nedan. Detta filter gör inte strängen säker för användning i ”JavaScript template literals” (JavaScript backtick syntax). Alla andra användningsområden som inte anges ovan stöds inte. Det rekommenderas generellt att data skickas med hjälp av HTML-attributen data- eller filtret json_script, snarare än i inbäddad JavaScript.
Till exempel:
\n<script>\nlet myValue = '{{ value|escapejs }}'\nescapeseqLink to this heading#Tillämpar filtret escape på varje element i en sekvens. Används tillsammans med andra filter som arbetar med sekvenser, t.ex. join. Till exempel:
{% autoescape off %}\n {{ my_list|escapeseq|join:", " }}\n{% endautoescape %}\nfilstorleksformatLink to this heading#Formaterar värdet som en ”mänskligt läsbar” filstorlek (t.ex. '13 KB', '4,1 MB', '102 bytes', etc.).
Till exempel:
\n{{ value|filesizeformat }}\nOm värde är 123456789, skulle utdata vara 117.7 MB.
förstLink to this heading#Returnerar det första objektet i en lista.
\nTill exempel:
\n{{ value|first }}\nOm värde är listan ['a', 'b', 'c'], blir utdata 'a'.
flatformatLink to this heading#När det används utan argument avrundas ett flyttal till en decimal - men bara om det finns en decimaldel som ska visas. Till exempel:
\n
| \nMall | \nUtmatning | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
Om floatformat används med ett numeriskt heltalsargument avrundas ett tal till så många decimaler. Till exempel:
| \nMall | \nUtmatning | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
Särskilt användbart är att ange 0 (noll) som argument, vilket gör att floaten avrundas till närmaste heltal.
\n
| \nMall | \nUtmatning | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
Om argumentet som skickas till floatformat är negativt, kommer det att avrunda ett tal till så många decimaler - men bara om det finns en decimaldel som ska visas. Till exempel:
| \nMall | \nUtmatning | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
Om argumentet som skickas till floatformat har suffixet g, kommer det att tvinga fram gruppering med THOUSAND_SEPARATOR för den aktiva locale. Till exempel:, när den aktiva locale är en (engelska):
| \nMall | \nUtmatning | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
| \n
Utdata lokaliseras alltid (oberoende av taggen {% localize off %}) såvida inte argumentet som skickas till floatformat har suffixet u, vilket tvingar fram en inaktivering av lokaliseringen. Till exempel: när det aktiva språket är pl (polska):
| \nMall | \nUtmatning | \n
|---|---|---|
| \n
| \n
| \n
| \n
| \n
| \n
Att använda floatformat utan argument är likvärdigt med att använda floatformat med argumentet -1.
forcera_utgångLink to this heading#Tillämpar HTML-escape på en sträng (se filtret escape för mer information). Det här filtret tillämpas omedelbart och returnerar en ny, escapad sträng. Detta är användbart i de sällsynta fall där du behöver flera eskapader eller vill tillämpa andra filter på de eskapade resultaten. Normalt sett bör du använda filtret escape.
Om du t.ex. vill fånga upp HTML-elementen <p> som skapats av filtret linebreaks:
{% autoescape off %}\n {{ body|linebreaks|force_escape }}\n{% endautoescape %}\nget_digitLink to this heading#Med ett heltal returneras den begärda siffran, där 1 är siffran längst till höger, 2 är den näst längst till höger osv. Returnerar det ursprungliga värdet för ogiltig indata (om indata eller argument inte är ett heltal, eller om argumentet är mindre än 1). I annat fall är utdata alltid ett heltal.
\nTill exempel:
\n{{ value|get_digit:"2" }}\nOm värde är 123456789, kommer utdata att vara 8.
irienkodLink to this heading#Konverterar en IRI (Internationalized Resource Identifier) till en sträng som är lämplig att inkludera i en URL. Detta är nödvändigt om du försöker använda strängar som innehåller icke-ASCII-tecken i en URL.
\nDet är säkert att använda detta filter på en sträng som redan har gått igenom filtret urlencode.
Till exempel:
\n{{ value|iriencode }}\nOm värde är "?test=I ♥ Django", kommer utdata att vara "?test=I%20%E2%99%A5%20Django".
Sammanfogar en lista med en sträng, som Pythons str.join(list)
Till exempel:
\n{{ value|join:" // " }}\nOm value är listan ['a', 'b', 'c'], blir utdata strängen "a // b // c".
json_scriptLink to this heading#Skickar ut ett Python-objekt på ett säkert sätt som JSON, inslaget i en tagg <script>, redo att användas med JavaScript.
Argument: Det valfria HTML-”id” för taggen <script>.
Till exempel:
\n{{ value|json_script:"hello-data" }}\nOm värde är ordlistan {'hello': 'world'}, blir utdata följande:
<script id="hello-data" type="application/json">{"hello": "world"}</script>\nDen resulterande datan kan nås i JavaScript på följande sätt:
\nconst value = JSON.parse(document.getElementById('hello-data').textContent);\nXSS-attacker motverkas genom att tecknen ”<”, ”>” och ”&” escapas. Till exempel: om värde är {'hello': 'world</script>&'}, är utdata:
<script id="hello-data" type="application/json">{"hello": "world\\\\u003C/script\\\\u003E\\\\u0026amp;"}</script>\nDetta är förenligt med en strikt policy för innehållssäkerhet som förbjuder exekvering av skript på sidan. Det upprätthåller också en ren separation mellan passiva data och körbar kod.
\nSistaLink to this heading#Returnerar det sista objektet i en lista.
\nTill exempel:
\n{{ value|last }}\nOm värde är listan ['a', 'b', 'c', 'd'], blir utdata strängen "d".
längdLink to this heading#Returnerar längden på värdet. Detta fungerar för både strängar och listor.
\nTill exempel:
\n{{ value|length }}\nOm värde är ['a', 'b', 'c', 'd'] eller "abcd", blir utdata 4.
Filtret returnerar 0 för en odefinierad variabel.
linebreaksLink to this heading#Ersätter radbrytningar i vanlig text med lämplig HTML; en enda ny rad blir en HTML-radbrytning (<br>) och en ny rad följd av en blankrad blir en styckebrytning (</p>).
Till exempel:
\n{{ value|linebreaks }}\nOm värde är Joel\\nis en snigel, kommer utdata att vara ``Joel<p><br>är en snigel``</p>.
linebreaksbrLink to this heading#Konverterar alla nya linjer i ett stycke vanlig text till HTML-radbrytningar (<br>).
Till exempel:
\n{{ value|linebreaksbr }}\nOm värde är Joel\\nis en snigel, kommer utdata att vara Joel<br>är en snigel.
linenummerLink to this heading#Visar text med radnummer.
\nTill exempel:
\n{{ value|linenumbers }}\nOm värde är:
one\ntwo\nthree\nutmatningen kommer att vara:
\n1. one\n2. two\n3. three\nVänsterjusterar värdet i ett fält med en given bredd.
\nArgument: fältstorlek
\nTill exempel:
\n"{{ value|ljust:"10" }}"\nOm värde är Django, kommer utdata att vara "Django".
lägreLink to this heading#Konverterar en sträng till gemener.
\nTill exempel:
\n{{ value|lower }}\nOm value är Totally LOVING this Album!, kommer utdata att vara totally loving this album!.
make_listLink to this heading#Returnerar värdet omvandlat till en lista. För en sträng är det en lista med tecken. För ett heltal omvandlas argumentet till en sträng innan en lista skapas.
\nTill exempel:
\n{{ value|make_list }}\nOm värde är strängen "Joel", kommer utdata att vara listan ['J', 'o', 'e', 'l']. Om värde är 123, kommer utdata att vara listan ['1', '2', '3'].
telefon2numeriskLink to this heading#Konverterar ett telefonnummer (som kan innehålla bokstäver) till dess numeriska motsvarighet.
\nInmatningen behöver inte vara ett giltigt telefonnummer. Detta konverterar glatt vilken sträng som helst.
\nTill exempel:
\n{{ value|phone2numeric }}\nOm värde är 800-COLLECT kommer utdata att vara 800-2655328.
pluralizeLink to this heading#Returnerar ett pluralsuffix om värdet inte är 1, '1' eller ett objekt med längd 1. Som standard är detta suffix 's'.
Exempel:
\nYou have {{ num_messages }} message{{ num_messages|pluralize }}.\nOm num_messages är 1, kommer utdata att vara Du har 1 meddelande. Om num_messages är 2 kommer utdata att vara Du har 2 meddelanden.
För ord som kräver ett annat suffix än 's' kan du ange ett alternativt suffix som en parameter till filtret.
Exempel:
\nYou have {{ num_walruses }} walrus{{ num_walruses|pluralize:"es" }}.\nFör ord som inte pluraliseras med ett enkelt suffix kan du ange både ett singular- och ett pluralsuffix, åtskilda med ett kommatecken.
\nExempel:
\nYou have {{ num_cherries }} cherr{{ num_cherries|pluralize:"y,ies" }}.\navtryckLink to this heading#Ett omslag runt pprint.pprint() – för felsökning, egentligen.
slumpmässigLink to this heading#Returnerar ett slumpmässigt objekt från den angivna listan.
\nTill exempel:
\n{{ value|random }}\nOm värde är listan ['a', 'b', 'c', 'd'], kan utdata vara "b".
Högerjusterar värdet i ett fält med en given bredd.
\nArgument: fältstorlek
\nTill exempel:
\n"{{ value|rjust:"10" }}"\nOm värde är Django, kommer utdata att vara " Django".
säkerLink to this heading#Markerar en sträng som inte kräver ytterligare HTML-escaping före utmatning. När autoescaping är avstängd har detta filter ingen effekt.
\n\nsafeseqLink to this heading#Tillämpar filtret safe på varje element i en sekvens. Används tillsammans med andra filter som arbetar med sekvenser, t.ex. join. Till exempel:
{{ some_list|safeseq|join:", " }}\nDu kan inte använda filtret safe direkt i det här fallet, eftersom det först skulle konvertera variabeln till en sträng i stället för att arbeta med de enskilda elementen i sekvensen.
skivaLink to this heading#Returnerar en del av listan.
\nAnvänder samma syntax som Pythons list slicing. Se Python-dokumentationen för en introduktion.
\nExempel:
\n{{ some_list|slice:":2" }}\nOm some_list är ['a', 'b', 'c'], blir utdata ['a', 'b'].
slugifyLink to this heading#Konverterar till ASCII. Omvandlar mellanslag till bindestreck. Tar bort tecken som inte är alfanumeriska, understrykningstecken eller bindestreck. Konverterar till gemener. Tar även bort inledande och avslutande blanksteg.
\nTill exempel:
\n{{ value|slugify }}\nOm värde är "Joel är en slug", kommer utdata att vara "joel-is-a-slug".
strängformatLink to this heading#Formaterar variabeln enligt argumentet, en specifikator för strängformatering. Denna specifikator använder printf-style String Formatting-syntaxen, med undantaget att det inledande ”%” utelämnas.
\nTill exempel:
\n{{ value|stringformat:"E" }}\nOm värde är 10, blir utmatningen 1.000000E+01.
tidLink to this heading#Formaterar en tid enligt det angivna formatet.
\nDet angivna formatet kan vara det fördefinierade TIME_FORMAT, eller ett eget format, samma som för filtret date. Observera att det fördefinierade formatet är lokalberoende.
Till exempel:
\n{{ value|time:"H:i" }}\nOm value är likvärdigt med datetime.datetime.now(), kommer utdata att vara strängen "01:23".
Observera att du kan använda backslash-escape för en formatsträng om du vill använda det ”råa” värdet. I det här exemplet är både ”h” och ”m” backslash-escaped, eftersom de annars är formatsträngar som visar timmen respektive månaden:
\n{{ value|time:"H\\h i\\m" }}\nDetta skulle visas som ”01h 23m”.
\nEtt annat exempel:
\nOm man antar att LANGUAGE_CODE till exempel är "de", så för:
{{ value|time:"TIME_FORMAT" }}\nkommer utdata att vara strängen "01:23" (Formatspecifikationen "TIME_FORMAT" för de locale som levereras med Django är "H:i").
Filtret time accepterar endast parametrar i formatsträngen som relaterar till tiden på dagen, inte datumet. Om du behöver formatera ett date-värde använder du istället filtret date (eller tillsammans med time om du behöver rendera ett fullständigt datetime-värde).
Det finns ett undantag från ovanstående regel: När ett datetime-värde med tillhörande tidszonsinformation skickas (en time-zone-aware datetime-instans) kommer time-filtret att acceptera de tidszonsrelaterade formatspecifikationerna 'e', 'O' , 'T' och 'Z'.
När den används utan en formatsträng används formatspecifikationen TIME_FORMAT:
{{ value|time }}\när samma sak som:
\n{{ value|time:"TIME_FORMAT" }}\ntid sedanLink to this heading#Formaterar ett datum som tiden sedan det datumet (t.ex. ”4 dagar, 6 timmar”).
\nTar emot ett valfritt argument som är en variabel som innehåller det datum som ska användas som jämförelsepunkt (utan argumentet är jämförelsepunkten nu). Om till exempel blog_date är en datuminstans som representerar midnatt den 1 juni 2006 och comment_date är en datuminstans för 08:00 den 1 juni 2006, så skulle följande returnera ”8 timmar”:
{{ blog_date|timesince:comment_date }}\nJämförelse av offset-naiva och offset-medvetna datatider kommer att ge en tom sträng.
\nMinuter är den minsta enhet som används, och ”0 minuter” kommer att returneras för alla datum som ligger i framtiden i förhållande till jämförelsepunkten.
\ntidtillLink to this heading#Liknar timesince, förutom att det mäter tiden från nu till det angivna datumet eller datatiden. Om det till exempel är den 1 juni 2006 idag och conference_date är en datuminstans som innehåller den 29 juni 2006, kommer {{ conference_date|timeuntil }} att returnera ”4 veckor”.
Tar ett valfritt argument som är en variabel som innehåller det datum som ska användas som jämförelsepunkt (i stället för now). Om from_date innehåller 22 juni 2006, kommer följande att returnera ”1 vecka”:
{{ conference_date|timeuntil:from_date }}\nJämförelse av offset-naiva och offset-medvetna datatider kommer att ge en tom sträng.
\nMinuter är den minsta enhet som används och ”0 minuter” kommer att returneras för varje datum som ligger i det förflutna i förhållande till jämförelsepunkten.
\ntitleLink to this heading#Konverterar en sträng till titlecase genom att låta orden börja med en versal och de återstående tecknen bli gemener. Denna tagg gör inga ansträngningar för att hålla ”triviala ord” i gemener.
\nTill exempel:
\n{{ value|title }}\nOm värde är "mitt FÖRSTA inlägg", blir utdata "mitt första inlägg".
avkorta teckenLink to this heading#Trunkerar en sträng om den är längre än det angivna antalet tecken. Trunkerade strängar avslutas med ett översättningsbart ellips-tecken (”…”).
\nArgument: Antal tecken att trunkera till
\nTill exempel:
\n{{ value|truncatechars:7 }}\nOm värde är "Joel är en slug", kommer utdata att vara "Joel i...".
trunkatechars_htmlLink to this heading#Liknar truncatechars, förutom att den är medveten om HTML-taggar. Alla taggar som öppnas i strängen och inte stängs före avkortningspunkten stängs omedelbart efter avkortningen.
Till exempel:
\n{{ value|truncatechars_html:7 }}\nOm värde är <p>"Joel är en slug</p>", kommer utdata att vara "<p>Joel i..."</p>.
Nya streck i HTML-innehållet kommer att bevaras.
\n\n\ntruncatewordsLink to this heading#Avkortar en sträng efter ett visst antal ord.
\nArgument: Antal ord att avkorta efter
\nTill exempel:
\n{{ value|truncatewords:2 }}\nOm värde är "Joel är en slug", kommer utdata att vara "Joel är ...".
Nya streck i strängen tas bort.
\ntruncatewords_htmlLink to this heading#Liknar truncatewords, förutom att den är medveten om HTML-taggar. Alla taggar som öppnas i strängen och inte stängs före avkortningspunkten stängs omedelbart efter avkortningen.
Detta är mindre effektivt än truncatewords, så det bör endast användas när det får HTML-text.
Till exempel:
\n{{ value|truncatewords_html:2 }}\nOm värde är <p>"Joel är en slug</p>", kommer utdata att vara "<p>Joel är ..."</p>.
Nya streck i HTML-innehållet kommer att bevaras.
\n\n\nTar rekursivt en självbäddad lista och returnerar en oordnad HTML-lista – UTAN att öppna och stänga <ul> taggar.
Listan förutsätts vara i rätt format. Om till exempel var innehåller ['States', ['Kansas', ['Lawrence', 'Topeka'], 'Illinois']], så kommer {{ var|unordered_list }} att returneras:
<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>\növreLink to this heading#Konverterar en sträng till versaler.
\nTill exempel:
\n{{ value|upper }}\nOm värde är "Joel är en slug", kommer utdata att vara "JOEL ÄR EN SLUG".
urlencodeLink to this heading#Escapar ett värde för användning i en URL.
\nTill exempel:
\n{{ value|urlencode }}\nOm värde är "https://www.example.org/foo?a=b&c=d" blir utdata "https%3A//www.example.org/foo%3Fa%3Db%26c%3Dd".
Ett valfritt argument som innehåller de tecken som inte ska escapas kan anges.
\nOm inget anges antas tecknet ”/” vara säkert. En tom sträng kan anges om alla tecken ska escapas. Till exempel:
\n{{ value|urlencode:"" }}\nOm värde är "https://www.example.org/", kommer utdata att vara "https%3A%2F%2Fwww.example.org%2F".
urlizeLink to this heading#Omvandlar webbadresser och e-postadresser i text till klickbara länkar.
\nDenna malltagg fungerar på länkar med prefixet http://, https:// eller www.. Till exempel: kommer https://djangocon.eu att konverteras men djangocon.eu kommer inte att göra det.
Den stöder också länkar som endast innehåller domäner och som slutar på en av de ursprungliga toppdomänerna (.com, .edu, .gov, .int, .mil, .net och .org). Till exempel: konverteras djangoproject.com.
Länkar kan ha efterföljande skiljetecken (punkter, kommatecken, slutparenteser) och inledande skiljetecken (öppningsparenteser), och urlize kommer fortfarande att göra det rätta.
Länkar som genereras av urlize har ett rel="nofollow"-attribut tillagt till sig.
Till exempel:
\n{{ value|urlize }}\nOm värde är "Kolla in www.djangoproject.com", kommer utdata att vara "Kolla in <a href="http://www.djangoproject.com" rel="nofollow">www.djangoproject.com"</a>.
Förutom webblänkar omvandlar urlize även e-postadresser till mailto:-länkar. Om värde är "Skicka frågor till foo@example.com", kommer utdata att vara "Skicka frågor till <a href="mailto:foo@example.com">foo@example.com"</a>.
Filtret urlize tar också en valfri parameter autoescape. Om autoescape är True, kommer länktexten och webbadresserna att escapas med Djangos inbyggda escape-filter. Standardvärdet för autoescape är True.
urlizetruncLink to this heading#Omvandlar webbadresser och e-postadresser till klickbara länkar precis som urlize, men trunkerar webbadresser som är längre än den angivna teckengränsen.
\nArgument: Antal tecken som länktexten ska trunkeras till, inklusive den ellips som läggs till om trunkering är nödvändig.
\nTill exempel:
\n{{ value|urlizetrunc:15 }}\nOm värde är "Kolla in www.djangoproject.com", skulle utdata vara "Kolla in <a href="http://www.djangoproject.com" rel="nofollow">www.djangoproj</a>...".
Precis som med urlize bör detta filter endast användas på vanlig text.
\nordantalLink to this heading#Returnerar antalet ord.
\nTill exempel:
\n{{ value|wordcount }}\nOm värde är "Joel är en slug", blir utdata 4.
wordwrapLink to this heading#Ombryter ord med angiven radlängd.
\nArgument: antal tecken vid vilka texten ska brytas
\nTill exempel:
\n{{ value|wordwrap:5 }}\nOm värde är Joel är en slug, skulle utdata vara:
Joel\nis a\nslug\nMappar värden för True, False och (valfritt) None till strängarna ”yes”, ”no”, ”maybe” eller en anpassad mappning som skickas som en kommaseparerad lista och returnerar en av dessa strängar i enlighet med värdet:
Till exempel:
\n{{ value|yesno:"yeah,no,maybe" }}\nVärde | \nArgument | \nUtgångar | \n
|---|---|---|
| \n\n |
| \n
| \n”Ja, nej, kanske.” | \n
| \n
| \n”Ja, nej, kanske.” | \n
| \n
| \n”Ja, nej, kanske.” | \n
| \n
| \n”Ja, nej.” | \n
| \n