CMS_GROUP
Diese Komponente ist ein Sonderfall, da sie nicht der Aufnahme von redaktionellen Inhalten dient, sondern der graphischen Gruppierung weiterer Eingabekomponenten. Die gewünschten Eingabekomponenten können zu einer Gruppe zusammengefasst werden.
Hierbei gibt es zwei Arten, die Eingabekomponenten zu gruppieren:
- Die Eingabekomponenten werden (wie alle anderen Komponenten auch) untereinander dargestellt und durch einen umgebenden Rahmen als Gruppe gekennzeichnet.
- Jede Eingabekomponente wird in einem eigenen Register dargestellt.
Inhaltsverzeichnis |
zum Beispiel |
Optionaler Parameter
Optionaler Parameter
Optionaler Parameter
Optionaler Parameter
Pflichtparameter
Optionaler Parameter
Optionaler Parameter
Parameter
Die Komponente CMS_GROUP verfügt über drei optionale Parameter:
- name: technischer Bezeichner einer Gruppierung, z.B. für die Benutzung in einem BeanShell-Skript
- scrollable: definiert, ob eine Grupperierung Scollleisten hat oder nicht
- tab: Darstellung von Eingabekomponenten als Reiter
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
height | Nein | 4.0.28 | PositiveInteger | Keiner |
name | Nein | 4.2 | Designator | Keiner |
scrollable | Nein | 4.0 | GroupScrollMode | Keiner |
tabs | Nein | 4.0 | TabMode | NONE |
height
Mit dem Parameter height wird die Anzeigehöhe der Gruppierung in Pixeln festgelegt.
Als Wert erwartet der Parameter eine Ganzzahl, die größer als 200 ist. Wird der Parameter nicht angegeben, orientiert sich die Höhe an den enthaltenen Eingabekomponenten.
Sind mehrere Register definiert (Parameter tabs), richtet sich die Höhe nach den auf dem betreffenden Register enthaltenen Eingabekomponenten.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
height | Nein | 4.0.28 | PositiveInteger | Keiner |
name
MIt dem optionalen Parameter name kann einer Gruppierung ein Bezeichner zugewiesen werden.
Mit diesem Bezeichner ist der programmiertechnischer Zugriff auf eine Gruppierung, z.B. in einem BeanShell-Skript, möglich.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
name | Nein | 4.2 | Designator | Keiner |
scrollable
Mit dem optionalen Parameter scrollable kann man festlegen, ob eine Gruppierung zur Darstellung von Scollleisten fähig sein soll oder nicht.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
scrollable | Nein | 4.0 | GroupScrollMode | Keiner |
tabs
Mit dem optionalen Parameter tabs können in einer Gruppierung Eingabekomponenten als Reiter dargestellt werden.
Die Orientierung der Reiter kann vorgegeben werden.
Für die Ausrichtung der Reiter im JAVAclient kann links, rechts, aber auch oben und unten gewählt werden.
Wird der Parameter nicht angegeben, so werden keine Reiter angezeigt.
Hinweis: WEBedit kann Reiter nur oben darstellen!
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
tabs | Nein | 4.0 | TabMode | NONE |
LANGINFOS
Über das Tag LANGINFOS können für jede Eingabekomponente sprachabhängige Angaben definiert werden, z. B. wie die Eingabekomponente in den unterschiedlichen Projektsprachen betitelt sein soll (Parameter label), welcher Tooltip angezeigt werden soll (Parameter description) usw. Aus Gründen der Übersichtlichkeit werden dabei Definitionen, die in mehreren Sprachen identisch sind, zusammengefasst. So wird z. B. aus
<LANGINFOS>
<LANGINFO lang="*" label="Date" format="dd.MM.yy"/>
<LANGINFO lang="DE" label="Date" format="dd.MM.yy"/>
<LANGINFO lang="EN" label="Date" format="MM/dd/yy"/>
</LANGINFOS>
beim Speichern
<LANGINFOS>
<LANGINFO lang="*" label="Date" format="dd.MM.yy"/>
<LANGINFO lang="EN" label="Date" format="MM/dd/yy"/>
</LANGINFOS>
Die Definition für den Rückfallwert (*) bleibt dabei immer erhalten, von Definitionen für Sprachen mit gleichen Werten bleibt immer die oberste erhalten.
Ab FirstSpirit-Version 4.2R4 kann der Rückfallwert weggelassen werden. Dann wird beim Speichern automatisch die zuerst definierte Sprache als Rückfallwert verwendet, z. B. wird aus
<LANGINFOS>
<LANGINFO lang="EN" label="Date"/>
<LANGINFO lang="DE" label="Datum"/>
</LANGINFOS>
beim Speichern
<LANGINFOS>
<LANGINFO lang="*" label="Date"/>
<LANGINFO lang="DE" label="Datum"/>
</LANGINFOS>
LANGINFO
Mit dem Tag LANGINFO werden Werte oder Attribute für eine Sprache oder aber für die Verwendung als Rückfallwerte angegeben.
Um Werte bzw. Attribute für eine Sprache anzugeben ist im Parameter lang die Abkürzung der Projektsprache anzugeben:
...
<LANGINFO lang="DE".../>
...
Rückfallwerte werden mit dem speziellen Sprachkürzel * ("für alle Sprachen") angegeben:
...
<LANGINFO lang="*".../>
...
Bei dem Parameter lang handelt es sich um einen Pflichtparameter.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
lang* | Ja | 3.1 | LanguageAbbreviation | Keiner |
description | Nein | 3.1 | String | Keiner |
label | Nein | 3.1 | String | Keiner |
lang
Mit dem Parameter lang wird das Sprachkürzel, das in den Servereigenschaften im Feld Abkürzung eingetragen ist (siehe FirstSpirit Handbuch für Administratoren, Kapitel "Sprach-Vorlagen"), angegeben, um festzulegen für welche Projektsprachen die Definitionen gelten sollen, z.B. DE für Deutsch, EN für Englisch, FR für Französisch usw. Folgende Zeichen können dabei beliebig oft angegeben werden: -, _, 0-9 und A-Z. Kleinbuchstaben werden nach dem Speichern der Vorlage automatisch in Großbuchstaben umgewandelt. Alternativ kann * für Rückfallwerte verwendet werden.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
lang* | Ja | 3.1 | LanguageAbbreviation | Keiner |
description
Mit dem Parameter description kann eine Beschreibung angegeben werden, die zur Anzeige eines Tooltipps (Mouse-Over) genutzt wird.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
description | Nein | 3.1 | String | Keiner |
label
Mit dem Parameter label wird die Oberflächenbeschriftung für Eingabe- und Visualisierungkomponenten angegeben.
Parameter | Pflichtparameter | Seit | Typ | Standardwert |
---|---|---|---|---|
label | Nein | 3.1 | String | Keiner |
Beispiel
Ein Beispiel für die Formularkomponente "CMS_GROUP":
<CMS_GROUP tabs="TOP">
<LANGINFOS>
<LANGINFO lang="*" label="TEXT"/>
<LANGINFO lang="DE" label="TEXT"/>
<LANGINFO lang="EN" label="TEXT"/>
</LANGINFOS>
...
</CMS_GROUP>