Get the MOST

In Zikula 1.3.x sind jQuery und jQuery UI bereits enthalten. Allerdings verwenden viele Module noch Prototype, was dazu führt, dass beide Skripte parallel nebeneinander verwendet werden. Dieser Artikel zeigt auf, welche Konsequenzen dies für die Nutzung mit sich bringt und wie man jetzt schon ohne Probleme mit jQuery arbeiten kann.

Skripte via PageVar laden

Statt mit Pfaden und Dateinamen hantieren zu müssen, können oft benötigte Skripte in Zikula einfach mittels PageVars geladen werden. Um beispielsweise jQuery und jQuery UI in einem Rutsch einzubinden, genügt die folgende Zeile im Template:

{pageaddvar name='javascript' value='jquery,jqueryui'}

Der Kompatibilitätsmodus von jQuery

Da sowohl Prototype als auch jQuery das Dollarzeichen für Funktionen verwenden, gibt es Probleme, wenn beide Skripte gleichzeitig geladen werden. Daher wird in Zikula beim Laden von jQuery direkt der sogenannte “NoConflict-Modus” eingeschaltet. Dieser tut an sich nichts weiter außer die Selektionsfunktionalität, welche jQuery normalerweise mit dem Dollarzeichen verbindet, zusätzlich über das Alias jQuery bereitzustellen. Die beiden folgenden Beispielselektoren und Befehle sind daher als identisch zu betrachten:

1
2
3
4

<script>
    $('#mynavigation li a').attr('target', '_blank');
    jQuery('#mynavigation li a').attr('target', '_blank');
</script>

Wenn man das Alias statt dem Dollarzeichen verwendet, kann man bereits mit jQuery arbeiten, auch wenn Prototype zusätzlich geladen wurde. Allerdings gibt es noch eine andere Möglichkeit, die bevorzugt angewendet werden sollte.

Funktionen an jQuery binden

Es ist möglich, den JavaScript-Code von einer anonymen Funktion ummanteln zu lassen. Damit kann man definieren, dass das Dollarzeichen innerhalb dieser Funktion zu jQuery und nicht zu Prototype gehört. Ein schöner Nebeneffekt dieser Vorgehensweise ist, dass der Code so auch direkt weiter für Zikula 1.4.0 verwendet werden kann.

1
2
3
4
5
6

<script>
    (function($) {
        $('#myelement').hide();
        $('#mynavigation li a').attr('target', '_blank');
    })(jQuery)
</script>

Weitere Details dazu lassen sich im Core-Projekt auf GitHub nachlesen.