imported>M2k~dewiki: /* Einleitung */ -

2023-08-19T08:47:39Z

Einleitung: -

Neue Seite

Die '''Template Attribute Language Expression Syntax''' ('''TALES''') beschreibt die Syntax für die Auswertung der von der [[Template Attribute Language]] (TAL) und [[Macro Expansion Template Attribute Language]] (METAL) für Attributwerte verwendeten Ausdrücke. Die Möglichkeit, hierfür eine andere Syntax als TALES zu verwenden, ist ausdrücklich vorgesehen; in der Regel wird TALES jedoch nicht ersetzt, sondern erweitert.

Der ''[[Zope (Webanwendungsserver)|Webanwendungsserver Zope]]'' erweitert die TALES-Spezifikation im Rahmen der [[Zope Page Templates]].

== Überblick ==
TALES stellt mehrere Methoden zur Verfügung, Ausdrücke zu formulieren, die in TAL- und METAL-Attributen verwendet werden können und durch ein (optionales) Präfix unterschieden werden:

=== Ausdrucksarten ===
; Pfadausdruck
: Präfix <code>path:</code> (optional, und deshalb fast immer fortgelassen): zum Zugriff auf strukturierte Variablen, Dateisystemobjekte, Makros (METAL) usw.
; Stringausdruck
: Präfix <code>string:</code>; erlaubt Pfadausdrücke in <code>${...}</code>
; Logische Negation
: Präfix <code>not:</code>; wertet den restlichen Ausdruck aus und gibt seine logische Negation zurück
; Python-Ausdruck
: Präfix <code>python:</code>; wenn implementiert, gibt den Wert des folgenden [[Python (Programmiersprache)|Python]]-Ausdrucks zurück. Dies findet üblicherweise nur Anwendung, wenn Pfadausdrücke nicht ausreichen, z. B. wenn eine Funktion mit bestimmten Argumenten aufgerufen werden muss.
; Unterdrückung des Quotings
: Das vorangestellte Schlüsselwort <code>structure</code> (''ohne'' Doppelpunkt) unterdrückt das sonst automatisch angewendete HTML-Quoting, um beispielsweise ein komplettes HTML-Element zu erzeugen.

=== Eingebaute Namen ===
; nothing
: ein „Nicht-Wert“, der keine [[Zeichenkette]] sein darf, z. B. ''None'' ([[Programmiersprache]] Python), ''void'', ''Nil'', oder ''NULL''.
; options
: die (benannten) Argumente, die dem Template übergeben wurden
; repeat
: zum Zugriff auf Schleifenvariablen wie ''index'', ''number'' usw.

Diese Namen werden üblicherweise noch um weitere ergänzt, siehe [[Zope Page Templates]].

== Beispiele ==
=== Einfacher Pfadausdruck zum Zugriff auf ein Makro ===
<[[METAL|metal]]:form use-macro="location/page/MACROS/myform"/>

Hier sei beispielsweise <code>location</code> das Verzeichnis, das eine Vorlagendatei <code>page</code> enthält, in der wiederum das Makro <code>myform</code> definiert wurde. In [[Zope Page Templates]] würde hier anstelle von <code>location</code> z. B. <code>here</code> (als Ausgangspunkt der [[Zope (Webanwendungsserver)#Akquisition|Akquisition]] zur Suche nach <code>page</code>) oder <code>container</code> stehen.

=== Schleife mit Pfad-, Python- und Stringausdrücken ===
<tr [[Template Attribute Language|tal]]:repeat="item python:({'key': 'eins'}, {'key': 'zwei'})">
<td [[Template Attribute Language|tal]]:content="repeat/item/number">99</td>
<td [[Template Attribute Language|tal]]:content="string:Zeile ${item/key}">Zeile 99</td>
</tr>

''Ausgabe:''

<tr>
<td>1</td>
<td>Zeile eins</td>
</tr>
<tr>
<td>2</td>
<td>Zeile zwei</td>
</tr>
''Erläuterungen:''
* das <code>tal:repeat</code>-Attribut erzeugt eine Variable <code>item</code> und, mit Hilfe des Python-Ausdrucks, eine Sequenz von [[Assoziatives Array|Dictionarys]], die verwendet wird, um mehrere HTML-Tabellenzeilen zu erzeugen
* die speziellen Schleifenvariablen (z. B. number) für <code>item</code> werden über die spezielle, vom TALES-Standard geforderte Variable <code>repeat</code> zur Verfügung gestellt
* Pfadausdrücke können auch innerhalb von String-Ausdrücken verwendet werden

=== Logische Negation und TAL-Elemente ===

<div tal:define="view_ok context/is_view_ok">
<tal:if condition="view_ok">
...
</tal:if>
<tal:else condition="not:view_ok">
...
</tal:else>
</div>

''is_view_ok'' könnte hier eine Methode sein, die aus dem ''context'' aufgerufen wird und die Leseberechtigung des [[Benutzer]]s überprüft. Im „Else-Zweig“ (der syntaktisch nichts anderes ist als der „If-Zweig“; <code>if</code> und <code>else</code> sind hier frei gewählte Namen, die sogar hätten gleich sein dürfen) wird die logische Bedingung des If-Zweigs umgekehrt, sodass nur einer der beiden ausgeführt wird.

== Siehe auch ==
* [[i18n TAL]]
* [[Template Engine]]

== Weblinks ==
* [https://zpt.readthedocs.io/en/latest/history/TALESSpecification13.html TALES-Spezifikation, Version 1.3]
* {{Webarchiv | url=http://wiki.zope.org/ZPT/RepeatVariable | wayback=20120909105154 | text=Schleifenvariablen }}
* [https://zope.readthedocs.io/en/latest/zope2book/AppendixC.html#tales-overview TALES Overview (im Zope-Book)]
* {{Webarchiv | url=http://zope3.mpg.de/cgi-bin/twiki/view/Zope/TaLes | wayback=20110914055131 | text=TALES-Seite im Zope-3-Wiki }}

[[Kategorie:Templatesprache]]
[[Kategorie:Python (Programmiersprache)]]

[[en:Template Attribute Language Expression Syntax]]

Template Attribute Language Expression Syntax - Versionsgeschichte

imported>M2k~dewiki: /* Einleitung */ -