Super TYPO3 Optionsplit Tutorial!

In diesem Tutorial werden sehr anschaulich und ausführlich die Möglichkeiten gezeigt, die einem der Befehl Optionsplit bietet.

Was ist dieses Optionsplit eigentlich?

Mit Optionsplit kannst du für viele Bereiche gebrauchen. Es dient einzelnen Bereichen verschiedene Werte zuzuweisen. Ein Beispiel, bei dem dieser Befehl oft benutzt wird, wäre zum Beispiel ein Menü.

MerkenMerken

Problem:

Man möchte ein Menü mit unterschiedlichen Klassen erstellen und dabei soll das Menü auch zukünftig ohne weiteres eingreifen im Typoscript bestehenen bleiben. Das bedeutet, kein manuelles hinzufügen von Menüpunkten mit den richtigen Klassen.

Lösung:

Die Funktion „optionSplit“ ist eine einfache und mächtige Methode um einzelnen Bereichen unterschiedliche Klassen zuzuweisen. Dies lässt sich auf viele Typoscriptbereiche adaptieren.

Um optionSplit zu benutzen, muss man nur den Split-Befehle zwischen die zutrennenden Bereiche schreiben.

Wir gehen bei unseren Beispielen von einem sechsseitigem TMENU aus.
Die CSS-Klassen stehen für die entsprechenden Farben, die wir im CSS definiert haben.

Beispiel:

wrapItemAndSub =<li class="red">|</li>||<li class="green">|</li>|*|<li class="blue">|</li>

Dieses Ergebnis erhält man durch die Verwendung der obigen Typoscriptzeile:

OptionSplit geht beim Trennen immer von drei zu trennenden Teilen aus:

Dem ersten, dem mittleren und dem letzten Teil.
Oberste Priorität hat immer der letzte Teil, der mittlere hat die niedrigste Priorität und wird bei Bedarf auch übersprungen.

Es gibt 3 verschiedene optionSplit Anweisungen:

|*|

Die einzelnen Teile werden durch ein |*| voneinander getrennt.

Mit || werden innerhalb eines Teils verschiedene Styles getrennt um beispielsweise eine immer wiederkehrende Farbkombination innerhalb des mittleren Teils zu erreichen.

|*||*|

Durch ein |*||*| wird der entsprechende Teil übersprungen, beziehungweise er wird als nicht existent definiert. In diesem Fall wird der nächste Teil solange wiederholt wie es nötig ist.

Generell gelten 4 Grundlegende Regeln für optionSplit:

Oberste Priorität hat der letzte Teil, danach der erste und die niedrigste Priorität hat der mittlere Teil.
Wenn der mittlere Wert fehlt, wird der letzte Befehl des ersten Teils solange wiederholt, wie es nötig ist.
Wenn sowohl der erste als auch der mittlere Teil fehlt, wird der erste Befehl des letzten Teils solange wiederholt, wie es nötig ist.
Wenn der letzte Teil fehlt, wird der mittlere Teil solange wiederholt, wie es nötig ist.

(Quelle: http://wiki.typo3.org/wiki/De:TSref/optionSplit , übersetzt aus dem Englischen)

Zu guter letzt die Kombinationsmöglichkeiten mit optionSplit und eine dazugehörige bildliche Darstellung.

Dieser Typoscriptcode erstellt ein einfaches TMENU:

lib.navi= HMENU
lib.navi{
1 = TMENU
1.wrap =<ul>|</ul>

	1{
		NO = 1
		NO{
		wrapItemAndSub = #[Hier kommt der OptionSplit-Befehl rein]
		}
	}
}

In diesen Beispielen muss man nur jeweils die wrapItemAndSub Zeile austauschen.

wrapItemAndSub =<li class="red">|</li>||<li class="green">|</li>||<li class="blue">|</li>

r || g || b

wrapItemAndSub =<li class="red">|</li>|*|<li class="green">|</li>||<li class="blue">|</li>

r |*| g || b

wrapItemAndSub =<li class="red">|</li>||<li class="green">|</li>|*|<li class="blue">|</li>

r || g |*| b

wrapItemAndSub =<li class="red">|</li>|*|<li class="green">|</li>|*|<li class="blue">|</li>

r |*| g |*| b

wrapItemAndSub =<li class="red">|</li>|*||*|<li class="green">|</li>||<li class="blue">|</li>

r |*||*| g || b

wrapItemAndSub =<li class="red">|</li>||<li class="green">|</li>||<li class="yellow">|</li>||<li class="blue">|</li>

r || g || y || b

wrapItemAndSub =<li class="red">|</li>|*|<li class="green">|</li>||<li class="yellow">|</li>||<li class="blue">|</li>

r |*| g || y || b

wrapItemAndSub =<li class="red">|</li>|*|<li class="green">|</li>|*|<li class="yellow">|</li>||<li class="blue">|</li>

r |*| g |*| y || b

wrapItemAndSub =<li class="red">|</li>||<li class="green">|</li>|*|<li class="yellow">|</li>|*|<li class="blue">|</li>

r || g |*| y |*| b

wrapItemAndSub =<li class="red">|</li>||<li class="green">|</li>|*||*|<li class="yellow">|</li>||<li class="blue">|</li>

r || g |*||*| y || b