Eigenschaft LABEL

Oberflächenbeschriftung einer Eingabe- oder Gestaltungskomponente auswerten

Für alle FirstSpirit Eingabe- und Gestaltungskomponenten muss in der Formularvorlage ein „Label“
(<LANGINFO lang="*" label="Product name" .../>, siehe dazu beispielsweise CMS_INPUT_DOM) definiert werden. Diese sprachabhängige Oberflächenbeschriftung wird anschließend im Formular zu jeder Komponente angezeigt.

Mithilfe des Attributs LABEL kann eine Regel definiert werden, die das Einblenden oder Bearbeiten eines Formularelements, abhängig von der sprachabhängigen Oberflächenbeschriftung eines Formularelements, ermöglicht. Auf diese Weise können beispielsweise Formularelemente mit einer bestimmten Beschriftung in einer bestimmten Sprache gezielt ein- oder ausgeblendet werden.

Der Ausdruck <PROPERTY source='gadget' name='LABEL'/> kann im Bereich Wertermittlung der Regeldefinition (oder für die Definition einer Vorbedingung) eingesetzt werden und liefert das sprachabhängige Label einer Komponente zurück.

Die Eigenschaft LABEL bezieht sich auf die sprachabhängige Anzeige eines Formularelements. Dabei müssen auch die individuellen Einstellungen des Redakteurs zur „Bevorzugten Anzeigesprache“ (Menü „Ansicht“ - „Bevorzugte Anzeigesprache“) beachtet werden. Legt der Regelentwickler also beispielsweise fest, dass eine Eingabekomponente mit dem sprachabhängigen Label „Produktname“ in der Sprache DE nicht bearbeitet werden kann, so kann ein Redakteur der als bevorzugte Anzeigesprache Englisch und die Option „Formulare immer in bevorzugter Anzeigesprache anzeigen“ eingestellt hat, diese Komponente dennoch bearbeiten.

Beispiele

Beispiel:

Formular:

<CMS_INPUT_TEXT name="cs_name" hFill="yes" singleLine="no" useLanguages="yes">
    <LANGINFOS>
        <LANGINFO lang="*" label="Product name" description="Insert the product name."/>
        <LANGINFO lang="DE" label="Produktname" description="Tragen Sie den Produktname ein."/>
    </LANGINFOS>
</CMS_INPUT_TEXT>

Regel:

<RULE>
    <WITH>
        <NOT>
            <OR>
                <EQUAL>
                    <PROPERTY source="cs_name" name="LABEL"/>
                    <TEXT>Product name</TEXT>
                </EQUAL>
                <EQUAL>
                    <PROPERTY source="cs_name" name="LABEL"/>
                    <TEXT>Produktname</TEXT>
                </EQUAL>
            </OR>
        </NOT>
    </WITH>
    <DO>
        <PROPERTY source="cs_name" name="EDITABLE"/>
    </DO>
</RULE>