Referință rapidă

Cheat Sheet Șabloane Mako

Ghid de referință rapidă pentru Mako: sintaxa șabloanelor Python, expresii, structuri de control, blocuri de cod Python, macrocomenzi def și moștenire.

· Publicat

Mako este o bibliotecă de șabloane Python de înaltă performanță, care combină execuția rapidă cu sintaxa familiară Python și moștenirea șabloanelor.

Sintaxă de Bază și Expresii

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

Structuri de Control

Instrucțiunile de control încep cu % și trebuie încheiate cu % endif, % endfor, etc.:

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

Cod Python Încorporat

Blocuri Python la Randare

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

Blocuri Python la Nivel de Modul

Eticheta <%! ... %> se execută o singură dată la nivel de modul când șablonul este compilat:

<%!
    import datetime

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

Defs (Macrocomenzi) și Blocuri Brute

<%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>

Moștenirea Șabloanelor

Șablon de Bază (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>

Șablon Copil (child.html)

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

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

<p>Acesta este conținutul principal injectat în self.body().</p>

Utilizarea API-ului Python

from mako.template import Template

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

Referințe

Subiecte conexe