» Projekte » gsCalendar » Dokumentation » Allgemeine Funktionen
gsCalendar: Allgemeine Funktionen
Elemente automatisch ein- und ausblenden
enableAutoHide([boolean enable])
Mit der Methode enableAutoHide() lässt sich das automatische Ein- und Ausblenden von <select> und <applet> Elementen aktivieren oder deaktivieren. Wenn dieses Verhalten eingeschaltet ist, werden die genannten Elemente, die sich hinter dem Kalender befinden, beim Anzeigen des Kalenders ausgeblendet. Dieses Verhalten ist standardmäßig eingeschaltet.
Beispiele:
// automatisches Ausblenden aktivieren
cal.enableAutoHide(true);
// bzw. deaktivieren
cal.enableAutoHide(false);
Elemente manuell ein- und ausblenden
addElementsToHide(string elementIds)
Mit der Methode addElementsToHide() können IDs von Elementen angegeben werden, die beim Anzeigen des Kalenders ausgeblendet werden sollen. Damit können auch Elemente versteckt werden, die nicht von der Automatik erkannt werden. Die Methode erwartet eine variable Anzahl an Parametern (IDs der zu versteckenden Elemente), kann jedoch auch mehrfach aufgerufen werden.
Beispiele:
// Aufruf mit Übergabe von mehreren Element-IDs
cal.addElementsToHide('select1', 'select2', 'applet1');
// erneuter Aufruf mit nur einem Parameter
cal.addElementsToHide('applet2');
Erweiterte Navigation
enableExtendedNavigation([boolean enable])
Bei Übergabe von true wird die erweiterte Navigation eingeblendet. Bei der erweiterten Navigation kann das angezeigte Kalenderblatt nicht nur monatsweise geändert werden sondern ermöglicht auch das einfache Ändern des angezeigten Jahres. Darüber hinaus lässt sich die gewünschte Jahreszahl auch einfach eintippen.
Beispiele:
// die erweiterte Navigation aktivieren
cal.enableExtendedNavigation(true);
// bzw. deaktivieren
cal.enableExtendedNavigation(false);
Aktion bei Klick auf ein deaktiviertes Datum
enableMonthNavigation([boolean enable])
Wenn im Kalender ein Monat angezeigt wird, werden auch die letzten Tage des vorhergehenden Monats und ein paar des folgenden Monats dargestellt. Im Normalfall wird keine Aktion ausgeführt, wenn auf einen dieser Tage geklickt wird. Mit der Methode enableMonthNavigation() kann dieses Verhalten jedoch geändert werden. Durch die Übergabe von true wird bei einem Klick zum jeweiligen Monat gewechselt und dieses angezeigt.
Beispiele:
// auf einen Klick reagieren
cal.enableMonthNavigation(true);
// auf einen Klick nicht reagieren
cal.enableMonthNavigation(false);
Sprache festlegen
setLanguage(string language)
Mit dieser Methode kann man die vom Kalender verwendete Sprache ändern. Dabei werden Länderkürzel wie "en", "de", etc. übergeben. Möglich sind natürlich nur solche, für die im Skript auch Übersetzungen vorhanden sind.
Beispiel:
// die Sprache auf Englisch setzen
cal.setLanguage('en');