Datentyp MappingMedium
Wertebereich des Datentyps MappingMedium
In FirstSpirit gibt es die Möglichkeit, für ein Bild maus-sensitive Bereiche festzulegen (auch verweis-sensitive Grafiken genannt). Um ein Bild mit maus-sensitiven Bereichen zu versehen, kann die Eingabekomponente IMAGEMAP verwendet werden. Die Eingabekomponente liefert ein Objekt vom Datentyp MappingMedium zurück. Mithilfe dieses Objekts kann der HTML-Quellcode für eine Imagemap erzeugt werden.
Weitere Informationen zum Datentyp MappingMedium siehe API-Dokumentation: de.espirit.firstspirit.access.editor.value.MappingMedium
Zur Ausgabe von Imagemaps siehe auch Datentyp Area.
Definition über die Standard-Eingabekomponenten
Im Formularbereich einer Seiten- oder Absatzvorlage können unterschiedliche Eingabekomponenten definiert werden. Über diese Formularelemente können dann die eigentlichen redaktionellen Inhalte in die Seite einfügen werden. Die von FirstSpirit unterstützten Standard-Eingabekomponenten liefern unterschiedliche Datentypen zurück.
Die folgenden Standard-Eingabekomponenten liefern ein Objekt vom Datentyp MappingMedium zurück:
Auf diesem Objekt lassen sich dann mit Hilfe einer $CMS_VALUE(...)$-Anweisung Methoden anwenden:
$CMS_VALUE(BEZEICHNER.METHODE)$
Unter BEZEICHNER muss der Parameter resultname, der in der Eingabekomponente definiert wurde, angegeben werden.
Methoden auf MappingMedium-Objekten
In der unten angegebenen Tabellen werden alle Methoden aufgelistet, die auf Objekten von Datentyp MappingMedium aufgerufen werden können:
Objekt wird von folgenden Formular-Objekten erzeugt: |
---|
CMS_INPUT_IMAGEMAP |
compareTo(Comparable)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
compareTo(Comparable) | int |
equals(Object)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
equals(Object) | boolean |
getAltText
Die Methode .getAltText() (in Bean-Syntax: .altText) liefert den in der Eingabekomponente gespeicherten Wert für das Feld Kommentar zurück.
Das Rückgabeobjekt ist eine Zeichenkette (siehe java.lang.String).
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getAltText | String |
getAreas
Die verweissensitiven Bereiche einer CMS_INPUT_IMAGEMAP-Eingabekomponente können über die Methode getAreas() (in Bean-Syntax: .areas) ausgegeben werden.
Da innerhalb einer CMS_INPUT_IMAGEMAP-Eingabekomponente mehrere verweissensitive Bereiche gepflegt sein können, wird die Anweisung $CMS_FOR(...)$ verwendet, um die Attribute jedes einzelnen Bereichs ausgeben zu können:
$CMS_FOR(BEREICH, st_imagemap.getAreas())
Auf der Variablen BEREICH können dann verschiedene Methoden angewendet werden.
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getAreas | List |
getClass
Die Methode .getClass() (in Bean-Syntax: .class) liefert die Klasse des aufrufendes Objektes zurück (vgl. java.lang.Class).
Aufruf:
$CMS_VALUE(myString.class)$
$CMS_VALUE(myString.getClass())$
Ausgabe:
java.lang.String
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getClass | Class |
getComment
Die Methode .getComment() (in Bean-Syntax: .comment) liefert den in der Eingabekomponente gespeicherten Wert für das Feld Kommentar zurück.
Das Rückgabeobjekt ist eine Zeichenkette (siehe java.lang.String).
Bei der Methode handelt es sich um ein Synonym zu der Methode .getAltText(). Die Methode wurde aus Kompatibilitätsgründen eingebaut und kann in einer späteren Version entfallen. |
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getComment | String |
getElement
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getElement | Referenceable |
getElementName
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getElementName | String |
getFile
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getFile | File |
getFolder
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getFolder | MediaFolder |
getHeight
Die Methode .getHeight() (in Bean-Syntax: .height) liefert die Höhe des in der Eingabekomponente gespeicherten Mediums (vgl. Eingabekomponente IMAGEMAP) zurück.
Das Rückgabeobjekt ist eine Ganzzahl (siehe java.lang.Integer).
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getHeight | int |
getImage
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getImage | Media |
getLanguage
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getLanguage | Language |
getMedium
Die Methode .getMedium() (in Bean-Syntax: .medium) liefert das in der Eingabekomponente ausgewählte Medium zurück (Beschriftung: Referenz).
Das Rückgabeobjekt ist ein Medium (siehe de.espirit.firstspirit.access.store.mediastore.Media).
Das Medium kann in einer $CMS_REF(...)$-Anweisung zur Ermittlung der URL genutzt werden:
<a href="$CMS_REF(referenzname)$">Text</a>
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getMedium | Media |
getPicture
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getPicture | Picture |
getRemoteName
Die Methode .getRemoteName() (in Bean-Syntax: .remoteName) liefert den in der Eingabekomponente gespeicherten Namen des Remote-Projektes.
Der Wert wird in der Eingabekomponente gespeichert, wenn ein Element (z. B. Seitenreferenz, Bild, Datei usw.) aus einem Remote-Projekt ausgewählt wurde.
Das Rückgabeobjekt ist eine Zeichenkette (siehe java.lang.String).
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getRemoteName | String |
getResolution
Die Methode .getResolution() (in Bean-Syntax: .resolution) liefert die ausgewählte Auflösung des gespeicherten Mediums in der Eingabekomponente (vgl. Eingabekomponenten IMAGEMAP) zurück.
Die Auflösung ist bei der Auswahl des Bildes aus der Medien-Verwaltung auswählbar.
Das Rückgabeobjekt ist eine Auflösung (siehe de.espirit.firstspirit.access.project.Resolution).
Die Auflösung kann in einer $CMS_REF(...)$-Anweisung zur Ermittlung der URL genutzt werden:
<img src="$CMS_REF(st_cmsImagemap.medium, res:st_cmsImagemap.resolution)$">
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getResolution | Resolution |
getType
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getType | BinaryMedium$Type |
getWidth
Die Methode .getWidth() (in Bean-Syntax: .width) liefert die Breite des in der Eingabekomponente gespeicherten Mediums (vgl. Eingabekomponente IMAGEMAP) zurück.
Das Rückgabeobjekt ist eine Ganzzahl (siehe java.lang.Integer).
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
getWidth | int |
isCase(Object)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
isCase(Object) | boolean |
isEmpty
Die Methode .isEmpty() (in Bean-Syntax: .isEmpty) prüft, ob ein Ausdruck bzw. Objekt leer ist, z.B. storeElement.isEmpty(). Das Ergebnis der semantischen Prüfung hängt vom Ausdruck bzw. Objekt ab, z.B. eine Zeichenkette ist dann leer, wenn sie kein Zeichen enthält. Bei Objekten mit komplexen Werten oder Objekten entscheidet das Objekt wann es leer ist. Der Datentyp DomElement enthält beispielsweise immer ein leeres Dokument, ist also nie null. Die Prüfung einer leeren DOM-Editor-Eingabekomponente mit der Methode .isNull() liefert daher den Wert false, während die Prüfung der Komponente auf .isEmpty() den Wert true liefern würde.
Die Methode .isEmpty() gibt einen booleschen Wert als Ergebnis der Prüfung zurück. true (=wahr) ist die Prüfung, wenn der Ausdruck bzw. das Objekt leer ist und false (=unwahr) wenn nicht.
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
isEmpty | boolean |
isNull
Die Methode .isNull() (in Bean-Syntax: .isNull) prüft, ob ein Ausdruck bzw. Objekt Null ist, z.B. storeElement.isNull(). Bei Objekten mit komplexen Werten oder Objekten entscheidet das Objekt wann es null ist. Der Datentyp DomElement enthält beispielsweise immer ein leeres Dokument, ist also nie null. Die Prüfung einer leeren DOM-Editor-Eingabekomponente mit der Methode .isNull() liefert daher den Wert false, während die Prüfung der Komponente auf .isEmpty() den Wert true liefern würde.
Die Methode .isNull() gibt einen booleschen Wert als Ergebnis der Prüfung zurück. true (=wahr) ist die Prüfung, wenn der Ausdruck bzw. das Objekt Null ist und false (=unwahr) wenn nicht.
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
isNull | boolean |
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
void |
set(String, Object)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
set(String, Object) | Object |
setAltText(String)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
setAltText(String) | void |
setAreas(List)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
setAreas(List) | void |
setComment(String)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
setComment(String) | void |
setElementName(String)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
setElementName(String) | void |
setFolder(MediaFolder)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
setFolder(MediaFolder) | void |
setMedium(Media)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
setMedium(Media) | void |
setRemoteName(String)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
setRemoteName(String) | void |
setResolution(Resolution)
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
setResolution(Resolution) | void |
toJson
Convert to JSON string representtion (only handles Maps, Collections, Arrays, Numbers, and Strings)Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
toJson | String | 4.2.14 |
toString
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
toString | String |
type
Methodenname | Rückgabetyp | Verfügbar seit |
---|---|---|
type | String |