Register Formular

Anders als andere Formatvorlagen verfügen Stilvorlagen über ein Register „Formular“. Innerhalb des Formularbereichs einer Stilvorlage können Eingabekomponenten zur Pflege von Layout-Attributen angelegt werden.

Über das Icon rechts oben können Zeilennummern ein- und ausgeschaltet werden.

Vorgabewerte bearbeiten: Über dieses Icon wird der Dialog zur Bearbeitung der Vorgabewerte geöffnet.

Suche in Vorlagen

Die folgenden Icons dienen der Suche in den Vorlagen:

Suchen (Strg+F): Öffnet ein Fenster zur Textsuche.

Ersetzen (Strg+R): Öffnet ein Fenster zum Suchen und Ersetzen von Text.

Nächstes Vorkommen (F3): Springt zum nächsten Suchergebnis.

Vorheriges Vorkommen (Umschalt+F3): Springt zum letzten Suchergebnis.

Rückgängig (Strg+Z): Macht die letzte Änderung rückgängig.

Wiederherstellen (Strg+Y): Stellt rückgängig gemachte Änderungen wieder her.

Layout-Attribute

Einige vorgegebene Layout-Attribute (mit reservierten Bezeichnern) wirken sich direkt auf die Darstellung der Tabelle innerhalb des DOM-Editors aus:

• bgcolor: legt die Hintergrundfarbe einer Tabellenzelle fest (Beispiel für Hintergrundfarbe)
• color: legt die Schriftfarbe eines Textes innerhalb der Tabellenzelle fest (Beispiel Schriftfarbe)
• align: legt die Ausrichtung eines Textes in der Tabellenzelle fest (Beispiel Ausrichtung)

Die vorgegebenen Bezeichner dürfen nicht geändert werden. Die Attribute müssen in der Eingabekomponente immer mit name=„Bezeichner“ angegeben werden, z. B. <CMS_INPUT_TEXT name=„bgcolor“ .../>

Natürlich können neben diesen Standard-Attributen noch weitere frei definierte Attribute über Eingabekomponenten des Formularbereichs gepflegt werden, z. B. CSS-Attribute.

Unterstützte Eingabekomponenten zur Pflege der Layout-Attribute:

• CMS_INPUT_TEXT / CMS_INPUT_TEXTAREA: Textfeld für die Angabe eines Wertes, z. B. für die Hintergrundfarbe.
• CMS_INPUT_COMBOBOX: Auswahl aus einer vorgegebenen Menge von Werten, z. B. für die Angabe einer Hintergrundfarbe oder einer Ausrichtung.
• CMS_INPUT_RADIOBUTTON: Auswahl aus einer vorgegebenen Menge von Werten, z. B. für die Angabe einer Hintergrundfarbe oder einer Ausrichtung.
• CMS_INPUT_NUMBER: Angabe eines Zahlenwerts, z. B. Wert für die Hintergrundfarbe einer Zelle.
• FS_BUTTON: Schaltfläche zur Aktivierung eines Skriptes oder zur Ausführung einer Klasse

Das Hinzufügen von Eingabekomponenten im Register „Formular“ ist durch die Code-Vervollständigung vereinfacht worden.

Für alle Eingabekomponente, die im Formularbereich einer Stilvorlage verwendet werden, gilt: die Komponenten sollten sprachunabhängig definiert werden (useLanguages=„no“, z. B. für CMS_INPUT_TEXT). Die Sprachabhängigkeit der Komponente wird in diesem Fall durch die Sprachauswahl innerhalb der DOM-Editor-Instanz abgedeckt, die vom Redakteur bearbeitet wird.

Weitere Eingabekomponenten zur Pflege von Layout-Attributen (in Stilvorlagen) werden nicht unterstützt.

Bearbeitung des Layouts für Redakteure unterbinden

Die Pflege der Layout-Attribute kann für Redakteure unterbunden werden. Dazu muss innerhalb der Eingabekomponente das Attribut hidden=„yes“ (z. B. für CMS_INPUT_TEXT) oder eine entsprechende Regel definiert werden (z. B. Eigenschaft VISIBLE). Das Attribut hidden=„yes“ bewirkt, dass die Eingabekomponente nur innerhalb der Vorlagen-Verwaltung sichtbar ist, nicht aber bei der Pflege der Tabelle in der Inhalte-Verwaltung. Über das Attribut kann der Vorlagen-Entwickler also eine Bearbeitung des Layouts durch den Redakteur unterbinden und stattdessen definierte Werte für das Layout vorgeben, beispielsweise für die Hintergrundfarbe der Zellen (siehe Vorgabewerte).

Ist das Attribut hidden=„yes“ (für alle Eingabekomponenten der Stilvorlage) definiert, besteht für den Redakteur keine Möglichkeit, die Layout-Eigenschaften einer Tabellenzelle in der Inhalte-Verwaltung zu verändern. Die entsprechende Schaltfläche Eigenschaften Zelle ist in diesem Fall inaktiv.

Wurde die Pflege der Layout-Eigenschaften durch die Verwendung von Validatoren unterbunden, wird die Schaltfläche niemals inaktiv. Auch dann nicht, wenn alle Eingabekomponenten ausgeblendet werden. In beiden Clients erscheint daraufhin ein leerer Dialog. Dieses Verhalten gilt ebenfalls für den Dialog zur Vorbelegung von Layout-Attributen.

Sind dagegen einzelne Komponenten „sichtbar“ (hidden=„no“) und andere „versteckt“ (hidden=„yes“), so ist die Schaltfläche Eigenschaften Zelle innerhalb des DOM-Editors (in der Inhalte-Verwaltung) aktiv, im dem Dialog werden dem Redakteur aber nur die „sichtbaren“ Komponenten angezeigt.

Alle Komponenten der Stilvorlage werden nur dann angezeigt, wenn keine Einschränkungen durch den Vorlagen-Entwickler definiert wurden.

Verknüpfung mit Standard-Tabellen-Formatvorlagen

Über das Systemobjekt #style können die Werte der Stilvorlage mit den Standard-Formatvorlagen für die Generierung (und Vorschau) von Tabellen im Projekt verknüpft werden. Die von FirstSpirit zur Verfügung gestellten Standard-Formatvorlagen für Tabellen sind:

• Table (Kürzel: table): Formatierung für Tabellen
• Table-Cell (Kürzel: td): Formatierung für Tabellenzellen
• Table-Row (Kürzel: tr): Formatierung für Tabellenreihen

Wird z. B. innerhalb der Standard-Formatvorlage td das Systemobjekt #style verwendet, werden die Werte, die innerhalb des Dialogs „Eigenschaften Zelle“ vom Redakteur definiert wurden bzw. die Vorgabewerte für die Stilvorlage, bei der Generierung der Tabelle berücksichtigt.

Beispiel für die Ausgabe im HTML-Kanal der Standard-Formatvorlage td:

<td$CMS_VALUE(#style)$
$CMS_VALUE(if(#cell.rowspan != 0, " rowspan='" + #cell.rowspan + "'"))$
$CMS_VALUE(if(#cell.colspan != 0, " colspan='" + #cell.colspan + "'"))$>
$CMS_VALUE(if(#content.isEmpty, "&nbsp;", #content))$
</td>

Weiterführende Informationen darüber, wie auf Eigenschaften und Informationen von Tabellen und ihren Inhalten zugegriffen werden kann, siehe Systemobjekte #cell, #content, #table und #tr.

Die Werte der Layout-Attribute, die durch den Redakteur (bzw. den Vorlagen-Entwickler) im Dialog "Eigenschaften Zelle" definiert wurden, werden nun bei der Generierung der Tabelle berücksichtigt.

Der Quelltext der Tabellenzelle wird nun beispielsweise folgendermaßen generiert:

<table>
<tr>
<td bgcolor="#ff00ff" align="center" color="#00ddee" rowspan='1' colspan='1'>Dies ist ein Text.</td>
..
</tr>
</table>