Startseite / Vorlagenentwicklung / Formulare / Gestaltungselemente / LABEL

CMS_LABELVerfügbar ab FirstSpirit-Version 4.0

Inhaltsverzeichnis
zum Beispiel

CMS_LABEL

Mithilfe dieser Komponente kann ein Text festgelegt werden, der als Label auf jeder Seite bzw. auf jedem Absatz angezeigt werden soll.

Wichtig Das Gestaltungselement CMS_LABEL wird im FirstSpirit ContentCreator unterstützt. Zu Einschränkungen siehe Kapitel Einschränkungen in ContentCreator.
bold
YesNo
Optionaler Parameter
italic
YesNo
Optionaler Parameter
name
Designator
Optionaler Parameter
size
PositiveInteger
Optionaler Parameter
lang
LanguageAbbreviation
Pflichtparameter
description
String
Optionaler Parameter
label
String
Optionaler Parameter

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

ParameterPflichtparameterSeitTypStandardwert
boldNein4.0YesNoYES
italicNein4.0YesNoNO
nameNein4.2DesignatorKeiner
sizeNein4.0PositiveInteger12

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.

ParameterPflichtparameterSeitTypStandardwert
boldNein4.0YesNoYES

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.

ParameterPflichtparameterSeitTypStandardwert
italicNein4.0YesNoNO

name

Mit dem optionalen Parameter name kann einem über CMS_LABEL definierten Label ein Bezeichner zugewiesen werden.
Auf diese Weise kann z. B. im Rahmen von Regeln / dynamischen Formularen ein Hinweistext eingeblendet werden (siehe Seite <MESSAGE/>: Korrekturhinweise einblenden).

Anders als Bezeichner von Eingabekomponenten (ebenfalls Parameter name), muss der Bezeichner für CMS_LABEL innerhalb eines Formulars nicht eindeutig sein.

ParameterPflichtparameterSeitTypStandardwert
nameNein4.2DesignatorKeiner

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.

ParameterPflichtparameterSeitTypStandardwert
sizeNein4.0PositiveInteger12

LANGINFOSVerfügbar ab FirstSpirit-Version 3.1

Ü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>

LANGINFOVerfügbar ab FirstSpirit-Version 3.1

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.

ParameterPflichtparameterSeitTypStandardwert
lang*Ja3.1LanguageAbbreviationKeiner
descriptionNein3.1StringKeiner
labelNein3.1StringKeiner

lang

Mit dem Parameter lang wird das Sprachkürzel, das in den Servereigenschaften im Feld Abkürzung eingetragen ist (siehe Sprach-Vorlagen (→Dokumentation für Administratoren)), 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.

ParameterPflichtparameterSeitTypStandardwert
lang*Ja3.1LanguageAbbreviationKeiner

description

Über den Parameter description kann eine Beschreibung angegeben werden, wie die Eingabekomponente vom Redakteur verwendet und befüllt werden soll. Der hier definierte Text wird als Tooltip bei Mouse-Over an der betreffenden Eingabekomponente eingeblendet.

Der Text soll dem Redakteur als Hilfestellung dienen und so kurz wie möglich, verständlich und relevant sein. Er sollte zum Label (Parameter label) passen bzw. dieses geeignet ergänzen.
Achten Sie darauf, dabei Terminologie zu verwenden, die der Redakteur kennt und erwartet.

Beispiel:

...description="Bitte geben Sie hier den Text für die Überschrift ein (H1)."...

Tipp: Wenn Sie wissen möchten, wie Sie Redakteure beim Befüllen von Eingabekomponenten noch besser unterstützen und anleiten können, schauen Sie sich das Kapitel zu Regeln sowie weitere Parameter und Funktionen von Formularen an.

ParameterPflichtparameterSeitTypStandardwert
descriptionNein3.1StringKeiner

label

Mithilfe des Parameters label definieren Sie das Label (die Beschriftung) der Eingabekomponente.

Wählen Sie ein möglichst kurzes und aussagekräftiges Label.
In Verbindung mit einer relevanten Beschreibung (Parameter description) können Sie den Redakteur darin unterstützen, die Eingabekomponente korrekt und erfolgreich zu verwenden.

Beispiel:

... label="Überschrift (H1)" ...

ParameterPflichtparameterSeitTypStandardwert
labelNein3.1StringKeiner
Legende

PositiveInteger

Positive Ganzzahl

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"

String

Eine beliebige Zeichenkette

YesNo

Schalter, um ein Attribut anzuwenden oder nicht

NOVerfügbar ab FirstSpirit-Version 2.0

Attribut nicht anwenden

YESVerfügbar ab FirstSpirit-Version 2.0

Attribut anwenden

LanguageAbbreviation

Sprachkürzel, z.B. DE, EN, FR oder * für Rückfallwerte

Beispiel

Ein Beispiel für die Formularkomponente CMS_LABEL:

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

© 2005 - 2024 Crownpeak Technology GmbH | Alle Rechte vorbehalten. | FirstSpirit 2024.12 | Datenschutz