Startseite
Startseite

Startseite / Vorlagenentwicklung / Vorlagensyntax / Datentypen / MappingMedium

Datentyp MappingMediumVerfügbar ab FirstSpirit-Version 4.0

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
Methodenname Rückgabetyp Kurzbeschreibung Verfügbar seit
compareTo(Comparable) int
equals(Object) boolean
getAltText String Gespeicherter Kommentar in der Eingabekomponente
getAreas List Ausgabe der verweissensitiven Bereiche
getClass Class Klasse des aufrufenden Objektes
getComment String Gespeicherter Kommentar in der Eingabekomponente
getElement Referenceable
getElementName String
getFile File
getFolder MediaFolder
getHeight int Höhe des gespeicherten Mediums in der Eingabekomponente
getImage Media
getLanguage Language
getMedium Media Gespeichertes Medium in der Eingabekomponente
getPicture Picture
getRemoteName String Gespeicherter Name des Remote-Projektes
getResolution Resolution Auflösung des gespeicherten Mediums
getType BinaryMedium$Type
getWidth int Breite des gespeicherten Mediums in der Eingabekomponente
isCase(Object) boolean
isEmpty boolean Prüft, ob ein Ausdruck leer ist
isNull boolean Prüft, ob ein Ausdruck Null ist
print void
set(String, Object) Object
setAltText(String) void
setAreas(List) void
setComment(String) void
setElementName(String) void
setFolder(MediaFolder) void
setMedium(Media) void
setRemoteName(String) void
setResolution(Resolution) void
toJson String Convert to JSON string representtion (only handles Maps, Collections, Arrays, Numbers, and Strings) 4.2.14
toString String
type String

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).

Wichtig 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

print

Methodenname Rückgabetyp Verfügbar seit
print 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

© 2005 - 2015 e-Spirit AG | Alle Rechte vorbehalten. | Letzte Änderung: 2014-07-16