Element Formats
slouží k definici vlastních formátů, na které se pak lze odkazovat z controlů <je:item>
. Jednotlivé formáty se definují pomocí elementů Format
vložených do obalujícího elementu Formats
.
<Formats> <Format name="dateTimeLong" format="ddd d.M.yyyy, H:mm" /> <Format name="dateTimeShort" format="d.M.yyyy, H:mm" /> <Format name="date" format="d.M.yyyy" /> </Formats>
V .aspx pak definovaný formát použijeme takto:
<je:item runat="server" field=".published" format="dateTimeShort" />
Atributy vnitřního elementu Format
culture nepovinný [cultureName]
Tento atribut umožňuje vynutit formátování hodnot bez ohledu na aktuální jazykovou mutaci. U vícejazyčných webů totiž JellyPot při formátování respektuje zvyklosti aktuálního jazyka. Například pro
format="d. MMMM yyyy"
se v české jazykové mutaci vypíše 1. listopadu 2015, v anglické 1. November 2015. U čísel se může lišit použití desetinné čárky vs. desetinné tečky a podobně. Do atributu se tedy zapisuje tzv. Culture name v prostření .NET, např. en-GB pro britskou angličtinu (seznam nejběžnějších je např. zde). V tomto jazykovém prostředí jsou pak formátovány všechny údaje bez ohledu na aktuální jazykovou mutaci. V uvedených příkladech tak bude ve všechy jazykových mutacích vždy vypsáno 1. November 2015 a číslo s desetinnou tečkou.format povinný [formátovací řetězec]
Formátovací řetězec založený na syntaxi v ASP.NET. JellyPot rozšiřuje tuto synaxi o některé další formáty, viz článek Formátování výstupu. Podrobný popis formátů v prostředí .NET je uveden například zde. Konkrétní formáty pro datum a čas pak dělí na standardní a uživatelské. Podobně pro čísla existují standardní (méně časté) a uživatelské formáty.
name povinný [string]
Jméno formátu, skládající se pouze z písmen bez diakritiky a číslic. Pomocí tohoto jména je formát přístupný v atributu
format
controlu<je:item>
.