Operation Manual

Nach oben
Nach oben
Mit Vorlagenparametern können Werte angegeben werden, die den Inhalt von Dokumenten steuern, welche auf einer Vorlage basieren.
Verwenden Sie Vorlagenparameter für optionale Bereiche oder bearbeitbare Tag-Attribute oder legen Sie die Werte fest, die an ein angefügtes
Dokument übergeben werden sollen. Für jeden Parameter definieren Sie einen Namen, einen Datentyp und einen Standardwert. Jeder Parameter
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:
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
1 <samp class="codeph">@@(firstName+lastName)@@</samp>
596