Thewebframeworkforperfectionistswithdeadlines.
Contrlelecomportementactueldel’échappementautomatique.Cettebaliseaccepteonouoffcommeparamètreetceladéterminesil’échappementautomatiqueestactifdansleblocconcerné.Leblocdoitêtreferméparlabalisefermanteendautoescape.
Exempled’utilisation:
Ignoretoutcequisetrouveentre{%comment%}et{%endcomment%}.Unenotefacultativepeutêtreinséréedanslapremièrebalise.Parexemple,celapeutêtreutilepourdonnerlesraisonsd’unboutdecodequel’onplaceencommentaire.
Renderedtextwith{{pub_date|date:"c"}}
{%comment"Optionalnote"%}Commentedouttextwith{{create_date|date:"c"}}
{%endcomment%}Lesbalisescommentnepeuventpasêtreimbriquées.Affichel’undesesparamètresàchaqueapparitiondelabalise.Lepremierparamètreestaffichélorsdelapremièreapparition,lesecondparamètrelorsdelasecondeapparition,etainsidesuite.Unefoisquetouslesparamètresontétéutilisés,labaliserecommenceaveclepremierparamètreetl’affichedenouveau.
Cettebaliseestparticulièrementutiledansuneboucle:
Vouspouvezaussiutiliserdesvariables.Parexemple,sivousavezdeuxvariablesdegabarit,rowvalue1etrowvalue2,vouspouvezalternerentreleursvaleurscommececi:
{%foroinsome_list%}
{%foroinsome_list%}
Pardéfaut,lorsquevousutilisezlemot-cléasaveclabalisecycle,l’utilisationde{%cycle%}quidémarrelecycleproduiraelle-mêmelapremièrevaleurducycle.Celapeutposerproblèmesivoussouhaitezexploiterlavaleurdansuneboucleimbriquéeouungabaritinclus.Sivousnevoulezquedéclarerlecyclemaissansproduirelapremièrevaleur,vouspouvezajouterunmot-clésilentcommederniermot-clédelabalise.Parexemple:
Lorsquelemot-clésilentestutilisédansunedéfinitiondecycle,celas’appliqueautomatiquementàtouteslesutilisationsultérieuresdecettebalisecyclespécifique.Legabaritsuivantn’afficherien,mêmesilesecondappelà{%cycle%}neprécisepassilent:
Affichetoutunlotd’informationsdedébogage,ycomprislecontexteactueletlesmodulesimportés.
Indiquequecegabaritétendungabaritparent.
Cettebalisepeutêtreutiliséededeuxfaons:
Enprincipe,lenomdugabaritestrelatifaurépertoireracineduchargeurdegabarits.Unparamètretextuelpeutaussiêtreuncheminrelatifcommenantpar./ou../.Parexemple,enadmettantlastructurederépertoiressuivante:
dir1/template.htmlbase2.htmlmy/base3.htmlbase1.htmlDanstemplate.html,lescheminssuivantsseraientvalides:
Notezqueleblocinclustoutletexteentrelesbalisesfilteretendfilter.
{%filterforce_escape|lower%}ThistextwillbeHTML-escaped,andwillappearinalllowercase.{%endfilter%}Note
AffichelepremierparamètrequinevautpasFalse.N’afficheriensitouteslesvaleurstransmisesvalentFalse.
{%firstofvar1var2var3%}C’estl’équivalentde:
{%ifvar1%}{{var1}}{%elifvar2%}{{var2}}{%elifvar3%}{{var3}}{%endif%}VouspouvezaussiutiliserunechanelittéralecommevaleurdereplidanslecasoùtouteslesvariablesspécifiéesvalentFalse:
{%firstofvar1var2var3"fallbackvalue"%}Cettebaliseéchappeautomatiquementlesvaleursdesvariables.Vouspouvezdésactiverl’échappementautomatiqueavec:
{%autoescapeoff%}{%firstofvar1var2var3"fallbackvalue"%}{%endautoescape%}Ousiseulementcertainesvariablesdoiventêtreéchappées,vouspouvezemployer:
{%firstofvar1var2|safevar3"fallbackvalue"|safe%}Vouspouvezutiliserlasyntaxe{%firstofvar1var2var3asvalue%}pourstockerlerésultatdansunevariable.
Effectueunebouclesurchaqueélémentd’uneliste,rendantdisponiblelavaleurdansunevariabledecontexte.Parexemple,pourafficherunelistedesathlètescontenusdansathlete_list:
- {%forathleteinathlete_list%}
- {{athlete.name}} {%endfor%}
Sivousdevezeffectuerunebouclesurunelistedelistes,vouspouvezisolerlesvaleursdechaquesous-listedansdesvariablesindividuelles.Parexemple,sivotrecontextecontientunelistedecoordonnées(x,y)appeléepoints,voicicommentvouspouvezafficherlalistedespoints:
{%forx,yinpoints%}Thereisapointat{{x}},{{y}}{%endfor%}Celapeutaussiêtreutilesivousavezbesoind’accéderauxélémentsd’undictionnaire.Parexemple,sivotrecontextecontientundictionnairedata,lecodesuivantaffichelesclésetlesvaleursdecedictionnaire:
Labouclefordéfinituncertainnombredevariablesdisponiblesàl’intérieurdelaboucle:
Labaliseforaccepteuneclausefacultative{%empty%}dontlecontenuestaffichésilalisteenparamètreestvideouestintrouvable:
- {%forathleteinathlete_list%}
- {{athlete.name}} {%empty%}
- Sorry,noathletesinthislist. {%endfor%}
{%ifathlete_list%}Numberofathletes:{{athlete_list|length}}{%elifathlete_in_locker_room_list%}Athletesshouldbeoutofthelockerroomsoon!{%else%}Noathletes.{%endif%}Dansl’exempleci-dessus,siathlete_listn’estpasvide,lenombred’athlètesestaffichéparlavariable{{athlete_list|length}}.
Commevouspouvezlevoir,labaliseifaccepteuneouplusieursclauses{%elif%}ouuneclause{%else%}dontlecontenuestaffichésitouteslesconditionsprécédentesontéchoué.Cesclausessontfacultatives.
{%ifathlete_listandcoach_list%}Bothathletesandcoachesareavailable.{%endif%}{%ifnotathlete_list%}Therearenoathletes.{%endif%}{%ifathlete_listorcoach_list%}Therearesomeathletesorsomecoaches.{%endif%}{%ifnotathlete_listorcoach_list%}Therearenoathletesortherearesomecoaches.{%endif%}{%ifathlete_listandnotcoach_list%}Therearesomeathletesandabsolutelynocoaches.{%endif%}L’utilisationàlafoisdeandetdeordanslamêmebaliseestpermise,tenantcomptequeandauneplusgrandeprioritéqueor.Parexemple:
{%ifathlete_listandcoach_listorcheerleader_list%}serainterprétécomme:
égalité.Exemple:
Identitéd’objet.Testesideuxvaleurssontlemêmeobjet.Exemple:
{%ifa==borc==dande%}…serainterprétéecomme:
LesopérateursdecomparaisonnepeuventpasêtreenchanéscommeenPythonouennotationmathématique.Parexemple,aulieud’écrire:
{%ifa>b>c%}(WRONG)vousdevezécrire:
Vérifiesiunevaleurachangédepuisl’itérationprécédented’uneboucle.
Labalisedebloc{%ifchanged%}estemployéedansuneboucle.Elleprésentedeuxutilisationspossibles.
Vérifiesonproprecontenuàaffichercomparéàsonétatprécédentetn’affichelecontenuques’ilachangé.Parexemple,lecodesuivantafficheunelistedejours,n’affichantlemoisquelorsqu’ilchange:
{%fordateindays%}{%ifchangeddate.date%}{{date.date}}{%endifchanged%}{%ifchangeddate.hourdate.date%}{{date.hour}}{%endifchanged%}{%endfor%}Labaliseifchangedaccepteaussiuneclausefacultative{%else%}quiaffichesoncontenusilavaleurn’apaschangé:
Lenomdugabaritpeutêtresoitunevariable,soitunechanefixeentreguillemets,simplesoudoubles.
Cetexempleinclutlecontenudugabarit"foo/bar.html":
Cetexempleinclutlecontenudugabaritdontlenomestcontenudanslavariabletemplate_name:
{%includetemplate_name%}Lavariablepeutaussiêtretoutobjetpossédantuneméthoderender()acceptantuncontexte.CelapermetderéférencerunobjetTemplatecompilédansvotrecontexte.
Ungabaritinclusestaffichédanslecontextedugabaritquil’inclut.Cetexempleproduitlerésultat"Hello,John!":
Contexte:lavariablepersoncontient"John"etlavariablegreetingcontient"Hello".
Gabarit:
{%include"name_snippet.html"%}Legabaritname_snippet.html:
{{greeting}},{{person|default:"friend"}}!Vouspouveztransmettreducontextesupplémentaireaugabaritenutilisantdesparamètresnommés:
{%include"name_snippet.html"withperson="Jane"greeting="Hello"%}Sivoussouhaitezrendrelecontexteavecseulementlesvariablesindiquées(oumêmesansvariabledutout),utilisezl’optiononly.Aucuneautrevariablen’estalorsdisponibledanslegabaritinclus:
{%include"name_snippet.html"withgreeting="Hi"only%}Note
Lesblocssontévaluésavantd’êtreinclus.Celasignifiequ’ungabaritquiinclutdesblocsd’unautrecontiendradesblocsquiontdéjàétéévaluésetproduits,etnonpasdesblocsquipeuventêtresurchargés,parexempleparungabaritd’extension.
Chargeunlotdebalisesdegabaritpersonnalisées.
Parexemple,legabaritsuivantchargetouteslesbalisesettouslesfiltresenregistrésdanssomelibraryetdansotherlibrarysetrouvantdanslepaquetpackage:
{%loadsomelibrarypackage.otherlibrary%}Vouspouvezaussichargerdemanièresélectivedesfiltresoudesbalisesàpartird’unebibliothèqueavecleparamètrefrom.Danscetexemple,lesbalises/filtresdegabaritfooetbarsontchargésàpartirdesomelibrary:
Affichedutextelatinaléatoireloremipsum.C’estpratiquepourproduiredesdonnéesd’exempledanslesgabarits.
Utilisation:
{%lorem[count][method][random]%}Labalise{%lorem%}peutêtreutiliséeaveczéro,un,deuxoutroisparamètres.Cesparamètressont:
Exemples:
Exemple:
Itis{%now"jSFYH:i"%}Notezquevouspouvezéchapperparbarreobliqueinverseunechanedeformatsivoussouhaitezutiliserlavaleurbrute.Danscetexemple,fetosonttousdeuxéchappésparbarreobliqueinverse,sinonilsseraientchacuninterprétéscommeunechanedeformatpourafficherrespectivementl’annéeetl’heure:
Itisthe{%now"jS\o\fF"%}LerésultataffichéestItisthe4thofSeptember.
Note
Lameilleurefaond’illustrercettebalisecomplexeestdedonnerunexemple:disonsquecitiescontientunelistedevillesreprésentéespardesdictionnairescontenantlesclés"name","population"et"country":
Vouspouvezutiliserlabalise{%regroup%}pourgrouperlalistedesvillesparpays.L’extraitdecodedegabaritsuivanteffectuecela:
{%regroupcitiesbycountryascountry_list%}
- {%forcountryincountry_list%}
- {{country.grouper}}
- {%forcityincountry.list%}
- {{city.name}}:{{city.population}} {%endfor%}
{%endfor%}
{%regroupcitiesbycountryascountry_list%}
- {%forcountry,local_citiesincountry_list%}
- {{country}}
- {%forcityinlocal_cities%}
- {{city.name}}:{{city.population}} {%endfor%}
{%endfor%}
Lasolutionlaplussimpleàceproblèmeestdes’assurerauniveaudelavuequelesdonnéessonttriéesd’aprèslecritèrequevousvoulezutiliserpourl’affichage.
{%regroupcitiesbyget_country_displayascountry_list%}{{country.grouper}}contientmaintenantlapartievaleurdeschoixchoicespluttqueleurclé.
JoséMourinho
CarloAncelotti
Ilestaussipossiblederéinitialiserlesbalisescyclenommées:
SupprimelesespacesentrelesbalisesHTML.Lescaractèresdetabulationetlessautsdelignesontaussiconsidéréscommedesespaces.
Commelesystèmedesgabaritsn’apasdeconceptd”échappement,sivoussouhaitezafficherdespartiesdesyntaxeutiliséesdanslesbalisesdegabarit,vousdevezutiliserlabalise{%templatetag%}.
Leparamètreindiquequelleséquencedegabaritvousvoulezafficher:
C’estunemanièred’afficherdeslienssanstrahirleprincipeDRY(nepasserépéter),évitantdedevoirfigerlesURLdanslesgabarits:
Parexemple,supposonsquevousavezunevue,app_views.client,dontlaconfigurationd’URLaccepteunidentifiantdeclient(ici,client()estuneméthodedanslefichierdevuesapp_views.py).Lalignedeconfigurationd’URLpourraitressembleràceci:
SivousaimeriezrécupéreruneURLsansl’afficher,vouspouvezeffectuerunappelunpeudifférent:
Cettesyntaxe{%url...asvar%}neproduirapasd’erreursilavueestmanquante.Enpratique,vousallezutilisercelapourdesliensversdesvuesquisontfacultatives:
Avertissement
N’oubliezpasd’entourerlemotifd’URLnamepardesguillemets,sinonlavaleurserainterprétéecommeunevariabledecontexte!
Empêchelemoteurdegabaritsd’effectuerlerenduducontenudecettebalisedebloc.
C’estsouventemployépourpermettreunecouchedegabaritJavaScriptquientreenconflitaveclasyntaxeDjango.Parexemple:
{%verbatim%}{{ifdying}}Stillalive.{{/if}}{%endverbatim%}Vouspouvezaussidésignerunebalisedefermeturespécifique,permettantl’utilisationde{%endverbatim%}commefaisantpartieducontenunonrendu:
Parexemple:
{%withtotal=business.employees.count%}{{total}}employee{{total|pluralize}}{%endwith%}Lavariablecréée(dansl’exempleci-dessus,total)estuniquementdisponibleentrelesbalises{%with%}et{%endwith%}.
Vouspouvezcréerplusd’unevariabledecontexte:
{%withalpha=1beta=2%}...{%endwith%}Note
L’ancienformatplusverbeuxesttoujoursprisencharge:{%withbusiness.employees.countastotal%}
Ajouteleparamètreàlavaleur.
{{value|add:"2"}}Sivaluevaut4,lerésultatsera6.
Cefiltreessaied’aborddeforcerlesdeuxvaleursàdesnombresentiers.Sicelaéchoue,ilessaietoutdemêmed’additionnerlesdeuxvaleurs.Celafonctionneaveccertainstypesdedonnées(chanes,listes,etc.)etéchoueavecd’autres.Sicettedeuxièmetentativeéchoue,lerésultatseraunechanevide.
Parexemple,sinousavons:
{{first|add:second}}etquefirstvaut[1,2,3]etsecondvaut[4,5,6],lerésultatsera[1,2,3,4,5,6].
Leschanespouvantêtreforcéesennombreentierserontadditionnéesetnonpasconcaténées,commedanslepremierexempleci-dessus.
Ajoutedesbarresobliquesinversesavantlesguillemets.UtilepouréchapperdeschanesenCSV,parexemple.
{{value|addslashes}}Sivaluecontient"J'utiliseDjango",lerésultatsera"J\'utiliseDjango".
Metenmajusculelepremiercaractèredelavaleur.Silepremiercaractèren’estpasunelettre,cefiltren’aaucuneffet.
{{value|capfirst}}Sivaluecontient"django",lerésultatsera"Django".
Centrelavaleurdansunchampdelargeurdonnée.
Enlèvetouteslesvaleursenparamètredelachaneàfiltrer.
{{value|cut:""}}Sivaluecontient"Chaneavecdesespaces",lerésultatsera"Chaneavecdesespaces".
Metenformeunedateselonleformatindiqué.
CescaractèresdeformatnesontpasutilisésdansDjangoendehorsdesgabarits.IlsontétéconuspourêtrecompatiblesavecPHPafindefaciliterlatransitionauxrédacteurshabituésàcelangage.
Chanesdeformatdisponibles:
{{value|date:"SHORT_DATE_FORMAT"}}lerésultatseraletexte"09/01/2008"(leformat"SHORT_DATE_FORMAT"delalocaleesfourniavecDjangoest"d/m/Y").
Lorsqu’aucunechanedeformatn’estindiquée,c’estleformatDATE_FORMATquiestutilisé.Avecdesréglagessemblablesàl’exempleprécédent:
{{value|date}}produit9deEnerode2008(lachanedeformatDATE_FORMATdelalocaleesétantr'j\d\eF\d\eY').
{{value|default:"nothing"}}Sivaluecontient""(lachanevide),lerésultatseranothing.
Si(etseulementsi)valuevautNone,leparamètrededefaultestaffiché.Sinon,c’estlavaleurvaluequiestaffichée.
{{value|default_if_none:"nothing"}}SivaluevautNone,lerésultatseranothing.
Accepteunelistededictionnairesetrenvoiecettelistetriéeparlaclédonnéeenparamètre.
{{value|dictsort:"name"}}Sivaluecontient:
{%forbookinbooks|dictsort:"author.age"%}*{{book.title}}({{book.author.name}}){%endfor%}Sibooksest:
*Alice(Lewis)*1984(George)*Timequake(Kurt)dictsortpeutaussitrierunelistedelistes(outoutautreobjetimplémentant__getitem__())pardesélémentsàunindicedonné.Parexemple:
{{value|dictsort:0}}Sivaluecontient:
RenvoieTruesilavaleurestdivisibleparleparamètre.
{{value|divisibleby:"3"}}Sivaluecontient21,lerésultatsera
échappeducodeHTML.Plusparticulièrement,ileffectuelesremplacementssuivants:
{{value|escapejs}}Sivaluecontient"testing\r\njavascript\'string"escaping",lerésultatsera"testing\\u000D\\u000Ajavascript\\u0027string\\u0022\\u003Cb\\u003Eescaping\\u003C/b\\u003E".
Metenformelavaleursousformedetailledefichierhumainementlisible(parex.'13Kio','4.1Mio','102octets',etc).
{{value|filesizeformat}}SIvaluecontient123456789,lerésultatsera117.7Mio.
TaillesdefichiersetunitésSI
Strictementparlant,filesizeformatneseconformepasauSystèmeinternationald’unitésquirecommandel’usagedeKiB,MiB,GiB,etc.lorsquelatailled’octetestcalculéeenpuissancesde1024(cequiestlecasici).Djangoutilisepluttlesnomsd’unitéstraditionnelles(KB,MB,GB,etc.)correspondantauxnomsquisontutiliséspluscouramment(NdT:latraductionenfranaisutiliselespréfixesSIKio,Mio,etc.).
Renvoielepremierélémentdelaliste.
{{value|first}}Sivaluecontientlaliste['a','b','c'],lerésultatsera'a'.
Quandleparamètreestabsent,cefiltrearronditunnombreàvirguleflottanteàunchiffreaprèslavirgule,maisseulements’ilyaunepartiedécimaleàafficher.Parexemple:
Quandunparamètrenombreentieresttransmis,floatformatarronditlenombreaunombredechiffresaprèslavirguleindiquéparleparamètre.Parexemple:
Ilpeutêtreparticulièrementutiledetransmettreleparamètre0(zéro)cequiarronditlenombreàvirguleaunombreentierleplusproche.
Sileparamètrepasséàfloatformatestnégatif,lenombreseraarrondiaunombredechiffresaprèslavirguleindiqué,maisseulements’ilyaunepartiedécimaleàafficher.Parexemple:
L’utilisationdefloatformatsansparamètreestéquivalentàl’utilisationdefloatformatavecleparamètre-1.
{{value|get_digit:"2"}}SIvaluecontient123456789,lerésultatsera8.
ConvertitunIRI(InternationalizedResourceIdentifier)enunechanepouvantêtreinclusedansuneURL.C’estnécessairequandvousessayezd’insérerdeschanescontenantdescaractèresnonASCIIdansdesURL.
{{value|iriencode}}Sivaluecontient"test=1&moi=2",lerésultatsera"test=1&moi=2".
Concatènelesélémentsd’unelisteavecunechanedeliaison,commePythonlefaitavecstr.join(list).
{{value|join:"//"}}Sivaluecontientlaliste['a','b','c'],lerésultatsera"a//b//c".
TransformeunobjetPythonenJSONdemanièresre,enveloppédansunebaliseOnpeutaccéderauxdonnéesrésultantesenJavaScriptcommececi:
Renvoieledernierélémentdelaliste.
{{value|last}}Sivaluecontientlaliste['a','b','c','d'],lerésultatsera'd'.
Renvoielalongueurdelavaleur.Celafonctionneaussibienpourdutextequedeslistes.
{{value|length}}Sivaluevaut['a','b','c','d']ou"abcd",lerésultatsera4.
Lefiltrerenvoie0pourunevariablenondéfinie.
RenvoieTruesilalongueurdelavaleurcorrespondauparamètre,sinonFalse.
{{value|length_is:"4"}}Sivaluecontient['a','b','c','d']ou"abcd",lerésultatseraTrue.
RemplacelessautsdelignedansdutextebrutparlecodeHTMLapproprié;unsautdelignesimpledevientunsautdeligneHTML(
)etunsautdelignesuivid’unelignevidedevientunsautdeparagraphe(
{{value|linebreaks}}Sivaluecontient"Jol\nestunelimace",lerésultatsera
Jol
estunelimace
Convertittouslessautsdeligned’uncontenudetextebrutensautsdeligneHTML(
).
{{value|linebreaksbr}}Sivaluecontient"Jol\nestunelimace",lerésultatseraJol
estunelimace.
Afficheuntexteennumérotantseslignes.
{{value|linenumbers}}Sivaluecontient:
onetwothreelerésultatsera:
Paramètre:tailledechamp
Convertitunechanetoutenminuscules.
{{value|lower}}SivaluecontientJ'aimeFOLLEMENTcetalbum!,lerésultatseraj'aimefollementcetalbum!.
Renvoielavaleurtransforméeenliste.Pourunechane,ceseraunelistedecaractères.Pourunnombreentier,leparamètreestd’abordforcéenchaneavantd’enfaireuneliste.
{{value|make_list}}Sivaluecontientlachane"Jol",lerésultatseralaliste['J','o','','l'].Sivaluecontient123,lerésultatseralaliste['1','2','3'].
Convertitunnumérodetéléphone(pouvantcontenirdeslettres)ensonéquivalentnumérique.
Lavaleurdedépartnedoitpasforcémentêtreunnumérodetéléphonevalable.Toutechanedecaractèresseratransforméesansrenacler.
{{value|phone2numeric}}Sivaluevaut800-COLLECT,lerésultatsera800-2655328.
Renvoieunsuffixedeplurielsilavaleurestdifférentede1,'1'oud’unobjetdelongueur1.Pardéfaut,lesuffixeest's'.
Youhave{{num_messages}}message{{num_messages|pluralize}}.Sinum_messagescontient1,lerésultatseraYouhave1message.Sinum_messagescontient2,lerésultatseraYouhave2messages.
Pourlesmotsexigeantunsuffixeautreque's',vouspouvezindiquerunsuffixealternatifenparamètredufiltre.
Youhave{{num_walruses}}walrus{{num_walruses|pluralize:"es"}}.Pourlesmotsdontleplurieln’estpasunsimplesuffixe,vouspouvezindiqueràlafoisunsuffixesingulieretunsuffixepluriel,séparésparunevirgule.
Youhave{{num_cherries}}cherr{{num_cherries|pluralize:"y,ies"}}.Note
Renvoieunélémentaléatoiredanslalisteindiquée.
{{value|random}}Sivaluecontientlaliste['a','b','c','d'],lerésultatpourraitêtre"b".
Aligneàdroitelavaleurdansunchampdelargeurdonnée.
Marqueunechanecommen’ayantplusbesoind’êtreéchappéeavantd’êtreaffichéedansducodeHTML.Lorsquel’échappementautomatiqueestdésactivé,cefiltren’aaucuneffet.
Sivousenchanezdesfiltres,unfiltreappliquéaprèssafepeutdenouveaurendrelecontenunonfiable.Parexemple,lecodesuivantaffichelavariabletellequelle,nonéchappée:
Renvoieunsegmentdelaliste.
{{some_list|slice:":2"}}Sisome_listcontient['a','b','c'],lerésultatsera['a','b'].
ConvertitenASCII.Convertitlesespacesentirets.Enlèvelescaractèresquinesontnialphanumériques,nisoulignements,nitirets.Convertitenminuscules.Lesespacesendébutetfindechanesontaussienlevés.
{{value|slugify}}Sivaluecontient"Jolestunelimace",lerésultatserajoel-est-une-limace.
{{value|stringformat:"E"}}SIvaluecontient10,lerésultatsera1.000000E+01.
Faittoutsonpossiblepoursupprimertouteslesbalises[X]HTML.
{{value|striptags}}Sivaluecontient"Jolunelimace",lerésultatsera"Jolestunelimace".
Aucunegarantiedesécurité
Metenformeuneheureselonleformatindiqué.
{{value|time:"H:i"}}Sivalueestéquivalentàdatetime.datetime.now(),lerésultatsera"01:23".
Unautreexemple:
{{value|time:"TIME_FORMAT"}}lerésultatsera"01:23"(lespécificateurdeformat"TIME_FORMAT"delalocaledefournieparDjangocontient"H:i").
Lorsqu’aucunechanedeformatn’estindiquée,c’estleformatTIME_FORMATquiestutilisé:
{{value|time}}estidentiqueà:
Accepteunparamètrefacultatifsousformedevariablecontenantladateàutilisercommepointdecomparaison(sansparamètre,lepointdecomparaisonestmaintenant).Parexemple,siblog_dateestuneinstancededatereprésentantminuitle1juin2006etquecomment_dateestuneinstancededatereprésentantle1juin2006à08:00,lecodesuivantrenverra8heures:
{{blog_date|timesince:comment_date}}Lacomparaisonentredesdates/heuresnavesetconscientes(enrapportaufuseauhoraire)renvoieunechanevide.
Lesminutessontlapluspetiteunitéutilisée,et0minuteestrenvoyépourtoutedatedanslefuturenfonctiondupointdecomparaison.
Semblableàtimesince,saufqu’ilmesureletempsdepuismaintenantjusqu’àladateoudate/heureindiquée.Parexemple,sinoussommesle1erjuin2006etqueconference_dateestuneinstancededatecontenantle29juin2006,{{conference_date|timeuntil}}renverra4semaines.
Accepteunparamètrefacultatifsousformedevariablecontenantladateàutilisercommepointdecomparaison(aulieudemaintenant).Sifrom_datecontientle22juin2006,lecodesuivantrenverra1semaine:
{{conference_date|timeuntil:from_date}}Lacomparaisonentredesdates/heuresnavesetconscientes(enrapportaufuseauhoraire)renvoieunechanevide.
Lesminutessontlapluspetiteunitéutilisée,et0minuteestrenvoyépourtoutedatedanslepasséenfonctiondupointdecomparaison.
Convertitunechaneencassedetitredetypeanglophoneenmettantenmajusculelapremièrelettredechaquemotetenminusculeslesautreslettres.Cettebalisenefaitaucuneffortpourconserverenminusculeslesmotsutilitaires.
{{value|title}}Sivaluecontient"monPREMIERarticle",lerésultatsera"MonPremierArticle".
Tronqueunechanesielleestpluslonguequelenombredecaractèresindiqué.Leschanestronquéesseterminentparuncaractèrepointsdesuspension(…).
Paramètre:lenombremaximumdecaractèresdurésultat
{{value|truncatechars:7}}Sivaluecontient"Jolestunelimace",lerésultatsera"Jole…".
{{value|truncatechars_html:7}}Sivaluecontient"
Jolestunelimace
",lerésultatsera"Jole…
".LessautsdelignedanslecontenuHTMLsontpréservés.
Tronqueunechaneaprèsuncertainnombredemots.
Paramètre:lenombremaximumdemotsdurésultat
{{value|truncatewords:2}}Sivaluecontient"Jolestunelimace",lerésultatsera"Jolest…".
Lessautsdeligneàl’intérieurdelavaleurserontenlevés.
{{value|truncatewords_html:2}}Sivaluecontient"
Jolestunelimace
",lerésultatsera"Jolest…
".AcceptedeslistesimbriquéesetlestraiterécursivementpourobtenirunelisteHTMLnonordonnée,sanslesbalises
- ouvrantesetfermantes.
Ilestnécessairequelalistesoitdanslebonformat.Parexemple,sivarcontient['States',['Kansas',['Lawrence','Topeka'],'Illinois']],lerésultatde{{var|unordered_list}}sera:
{{value|upper}}Sivaluevaut"Jolestunelimace",lerésultatsera"JOLESTUNELIMACE".
échappeunevaleurpourêtreinclusedansuneURL.
Ilestpossibledefournirunparamètrefacultatifcontenantlescaractèresquinedoiventpasêtreéchappés.
Sansceparamètre,lecaractère/estconsidérécommesr.Ilestpossibledefournirunechanevidepourindiquerquetouslescaractèresdoiventêtreéchappés.Parexemple:
ConvertitlesURLetlesadressesélectroniquesdansletexteenhyperliens.
Ilconvertitégalementlesliensnomsdedomaines’ilsseterminentparl’undesdomainesdepremierniveaudebase(.com,.edu,.gov,.int,.mil,.netet.org).Parexemple,djangoproject.comseraconverti.
Leslienspeuventseterminerpardelaponctuation(points,virgules,parenthèsefermante)etpeuventcommencerpardelaponctuation(parenthèseouvrante);urlizen’enserapasperturbépourautant.
Lesliensgénérésparurlizereoiventl’attributrel="nofollow".
SiurlizeestappliquéàdutextequicontientdéjàdesbalisesHTMLouàdesadressesélectroniquescontenantdesguillemetssimples('),leschosesnesepasserontpascommeprévu.N’appliquezcefiltrequ’àdutextepur.
Paramètre:lenombremaximumdecaractèresqueletexteduliencontiendraaprèsavoirététronquésinécessaire,ycomprisl’ellipseajoutéeparlatroncature,lecaséchéant.
Renvoielenombredemots.
{{value|wordcount}}Sivaluevaut"Jolestunelimace",lerésultatsera4.
Ajoutedessautsdeligned’aprèsunelongueurdelignemaximale.
Paramètre:lenombredecaractèresaprèslequelunsautdeligneestrajoutédansletexte.
{{value|wordwrap:5}}SivaluevautJoelisaslug,lerésultatsera:
{%loadstatic%}
{%loadstatic%}{%static"images/hi.jpg"asmyphoto%}
{%loadstatic%}
{%loadstatic%}