CMS_LABEL

CMS_LABEL

Mit Hilfe dieser Komponente kann bereits bei der Vorlagenentwicklung festgelegt werden, welcher Text als Label auf jeder Seite bzw. auf jedem Absatz angezeigt werden soll.

Parameter

Mit der Komponente CMS_LABEL kann eine zusätzliche Beschriftung erstellt werden.

Die Komponente verfügt über drei optionale Parameter

• bold: die zusätzliche Beschriftung wird Fett dargestellt
• italic: die zusätzliche Beschriftung wird Kursiv dargetellt
• size: Größenangabe der Beschriftung

Übersicht

bold

Mit dem Parameter bold wird die zusätzliche Beschriftung (Label) in fetter Schrift dargestellt.

Wird der Parameter nicht angegeben, so wird die Beschriftung standardmäßig in fetter Schrift angezeigt.

Bei der Angabe von NO (...bold="NO"...) wird die Beschriftung in nicht fetter Schrift angezeigt.

Übersicht

italic

Mit dem Parameter italic kann die zusätzliche Beschriftung (Label) in kursiver Schrift dargestellt werden.

Bei der Angabe von YES (...bold="YES"...) wird die Beschriftung in kursiver Schrift angezeigt.

Wird der Parameter nicht angegeben, so wird die Beschriftung standardmäßig in nicht kursiver Schrift angezeigt.

Übersicht

name

The name identifying the form element

Übersicht

size

Mit dem Parameter size kann die Schriftgröße der zusätzlichen Beschriftung (Label) in Pixel definiert werden. Der Parameter erwartet eine positive Ganzzahl, z.B. size="14".

Wird der Parameter nicht angegeben, so wird die Beschriftung standardmäßig in 12 Pixel großer Schrift angezeigt.

Übersicht

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.

Übersicht

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.

Übersicht

description

Mit dem Parameter description kann eine Beschreibung angegeben werden, die zur Anzeige eines Tooltipps (Mouse-Over) genutzt wird.

Übersicht

label

Mit dem Parameter label wird die Oberflächenbeschriftung für Eingabe- und Visualisierungkomponenten angegeben.

Übersicht

LanguageAbbreviation	Sprachkürzel, z.B. DE, EN, FR oder * für Rückfallwerte
PositiveInteger	Positive Ganzzahl
YesNo	Schalter, um ein Attribut anzuwenden oder nicht NO Attribut nicht anwenden YES Attribut anwenden
String	Eine beliebige Zeichenkette
Designator	Eindeutiger Bezeichner variabler Länge; muss mit einem Buchstaben oder Unterstrich beginnen und darf nur die Zeichen "A-Z", "a-z", "0-9" und "_" enthalten, z.B. "fr_st_varName"

Beispiel

Ein Beispiel für die Formularkomponente "CMS_LABEL":

<CMS_LABEL bold="YES" size="14">
  <LANGINFOS>
    <LANGINFO lang="*" label="TEXT" description="TEXT"/>
    <LANGINFO lang="DE" label="TEXT" description="TEXT"/>
    <LANGINFO lang="EN" label="TEXT" description="TEXT"/>
  </LANGINFOS>
</CMS_LABEL>