Riferimento rapido

Cheat Sheet Template Mako

Guida rapida per Mako: sintassi di templating in Python, espressioni, strutture di controllo, blocchi di codice Python, macro def ed ereditarietà.

· Pubblicato

Mako è una libreria di template Python ad alte prestazioni che unisce esecuzione veloce con la familiare sintassi Python e l'ereditarietà dei template.

Sintassi di Base ed Espressioni

Variable x: ${x}
Expression arithmetic: ${x + 1}
HTML-escaped filter: ${x | h}
URL-encoded filter: ${x | u}
Trimmed whitespace: ${x | trim}

Strutture di Controllo

Le istruzioni di controllo iniziano con % e devono terminare con % endif, % endfor, ecc.:

% for user in users:
  % if user.is_active:
    <li>${user.name} (Active)</li>
  % else:
    <li>${user.name} (Inactive)</li>
  % endif
% endfor

Codice Python Incorporato

Blocchi Python a Tempo di Rendering

<%
    greeting = "Hello, " + user.name.upper()
    total_score = sum(user.scores)
%>
<p>${greeting}: ${total_score}</p>

Blocchi Python a Livello di Modulo

Il tag <%! ... %> viene eseguito una sola volta a livello di modulo quando il template viene compilato:

<%!
    import datetime

    def format_date(dt):
        return dt.strftime("%Y-%m-%d")
%>
<p>Today: ${format_date(datetime.date.today())}</p>

Defs (Macro) e Blocchi Raw

<%def name="render_card(title, body)">
  <div class="card">
    <h3>${title}</h3>
    <p>${body}</p>
  </div>
</%def>

${render_card("Feature", "Card body text")}

<%text filter="h">
  This is a raw block where ${expressions are not evaluated}.
</%text>

<%doc>
  Multi-line template comment
</%doc>

Ereditarietà dei Template

Template Base (base.html)

<!doctype html>
<html>
  <head>
    <title><%block name="title">Default Title</%block></title>
  </head>
  <body>
    <header><h1><%block name="header" /></h1></header>
    <main>${self.body()}</main>
  </body>
</html>

Template Figlio (child.html)

<%inherit file="base.html" />

<%block name="title">Page Title</%block>
<%block name="header">Welcome to my site</%block>

<p>Questo è il contenuto principale iniettato in self.body().</p>

Utilizzo dell'API Python

from mako.template import Template

template = Template("Hello, ${name}!")
print(template.render(name="World"))

Riferimenti

Argomenti correlati