Operation Manual

Nach oben
Nach oben
muss einen eindeutigen Namen haben, wobei zwischen Groß- und Kleinschreibung unterschieden wird. Sie müssen einen der folgenden fünf
erlaubten Datentypen besitzen: Text, Boolean, Farbe, URL oder Zahl.
Vorlagenparameter werden an das Dokument als Instanzparameter übergeben. In den meisten Fällen kann der Benutzer der Vorlage den
Standardwert des Parameters bearbeiten und somit das Dokument, das auf der Vorlage basiert, anpassen. In anderen Fällen kann der Autor der
Vorlage deren Inhalt basierend auf dem Wert eines Vorlagenausdrucks festlegen.
Vorlagenausdrücke
Vorlagenausdrücke sind Anweisungen, die einen Wert berechnen oder auswerten.
Sie können einen Ausdruck verwenden, um einen Wert zu speichern und in einem Dokument anzuzeigen. Ausdrücke können einfach oder
komplex sein: Sie können den einfachen Wert eines Parameters enthalten, wie beispielsweise @@(Param)@@, jedoch auch eine Berechnung
von Werten, mit denen beispielsweise die Hintergrundfarbe von Tabellenzeilen geändert wird, wie @@((_index & 1) ? red : blue)@@.
Sie können auch Vorlagenausdrücke mit einer oder mehreren If-Bedingung(en) definieren. Ein Ausdruck in einer bedingten Anweisung wird von
Dreamweaver entweder als true (wahr) oder false (falsch) ausgewertet. Wenn die Bedingung wahr ist, wird der optionale Bereich im auf der
Vorlage basierten Dokument angezeigt; wenn sie unwahr ist, wird der Bereich nicht angezeigt.
Sie können Ausdrücke in der Codeansicht oder im Dialogfeld „Optionaler Bereich“ definieren, wenn Sie einen optionalen Bereich einfügen.
In der Codeansicht können Vorlagenausdrücke auf zwei Arten definiert werden. Verwenden Sie den Kommentar <!-- TemplateExpr expr="Ihr
Ausdruck"--> oder @@(Ihr Ausdruck)@@. Wenn Sie den Ausdruck in den Vorlagencode einfügen, wird in der Entwurfsansicht eine
Ausdrucksmarkierung angezeigt. Beim Anwenden der Vorlage wertet Dreamweaver den Ausdruck aus und zeigt den Wert im Dokument an, das
auf der Vorlage basiert.
Verwendete Sprache für Vorlagenausdrücke
Die für Vorlagenausdrücke verwendete Sprache ist ein kleiner Teilsatz von JavaScript. Sie verwendet dieselbe Syntax und dieselben Regeln für
Rangfolgen wie JavaScript. Verwenden Sie JavaScript-Operatoren, um Ausdrücke wie den folgenden zu erstellen:
@@(firstName+lastName)@@
Folgende Funktionen und Operatoren werden unterstützt:
Numerische Literale, String-Literale (Anführungszeichen in der Syntax erforderlich), Boolesche Literale (true und false)
Variable Bezüge (siehe die Liste definierter Variablen weiter unten in diesem Abschnitt)
Feldbezüge (der „Punkt-Operator“)
Unäre Operatoren: +, -, ~, !
Binäre Operatoren: +, -, *, /, %, &, |, ^, &&, ||, <, <=, >, >=, ==, !=, <<, >>
Bedingungsoperatoren: ?:
Klammern: ()
Folgende Datentypen werden unterstützt: Boolean, 64-Bit-Fließkomma (IEEE), String und Object. In Dreamweaver-Vorlagen werden die
JavaScript-Datentypen „null“ und „undefined“ nicht unterstützt. Darüber hinaus ist es in Vorlagen nicht möglich, Skalar-Datentypen implizit in
Objekte zu konvertieren; daher würde der Ausdruck "abc".length zu einem Fehler führen und nicht den Wert 3 zurückgeben.
Die einzigen verfügbaren Objekte sind die durch das Ausdrucksobjektmodell definierten. Folgende Variablen sind definiert:
_document Enthält die Vorlagendaten der Dokumentebene und für jeden Parameter in der Vorlage ein Feld.
_repeat Ist nur für Ausdrücke definiert, die sich innerhalb eines wiederholenden Bereichs befinden. Zeigt integrierte Informationen über den
Bereich an.
_index Numerischer Index des aktuellen Eintrags (der Index beginnt bei 0).
_numRows Gesamtzahl der Einträge in diesem wiederholenden Bereich.
_isFirst Wahr, wenn der aktuelle Eintrag der erste Eintrag in seinem wiederholenden Bereich ist.
_isLast Wahr, wenn der aktuelle Eintrag der letzte Eintrag in seinem wiederholenden Bereich ist.
_prevRecord Das _repeat-Objekt des vorherigen Eintrags. Der Zugriff auf diese Eigenschaft im ersten Eintrag des Bereichs führt zu einem
Fehler.
_nextRecord Das _repeat-Objekt des nächsten Eintrags. Der Zugriff auf diese Eigenschaft im letzten Eintrag des Bereichs führt zu einem
Fehler.
_parent In einem verschachtelten wiederholenden Bereich wird hierdurch das _repeat-Objekt für den umschließenden (äußeren)
wiederholenden Bereich angegeben. Der Aufruf dieser Eigenschaft außerhalb eines verschachtelten wiederholenden Bereichs führt zu einem
Fehler.
416