diff --git a/README.md b/README.md index 507df0e..46a22fc 100644 --- a/README.md +++ b/README.md @@ -34,7 +34,7 @@ Beim Einbinden muss das attribut `data-class` angegeben werden, welches die CSS- * uhr-fr.js * uhr-it.js -`uhr-de_CH_genau.js` ist eine Variante von Berndeutsch, bei der zur vollen Stunde zusätlich das Wort "genau" angezeigt wird (also z.B. um 15:00 Uhr "ES ISCH GENAU DRÜ"). +`uhr-de_CH_genau.js` ist eine Variante von Berndeutsch, bei der zur vollen Stunde zusätzlich das Wort "genau" angezeigt wird (also z.B. um 15:00 Uhr "ES ISCH GENAU DRÜ"). 2. Uhr-Element im HTML-Dokument einfügen ---------------------------------------- @@ -56,10 +56,11 @@ Damit wird eine Uhr in der Standardkonfiguration erzeugt. Das heisst: * Die Uhr ist eingeschaltet * Die Bedienelemente werden angezeigt * Die Uhr passt sich in der Grösse an, wenn das Elternelement seine Grösse ändert +* Die Uhr zeigt die aktuelle Stunde und Minute -Mit den Bedienelementen kannst du die Uhr ein- und ausschalten sowie Sprache und Farbe wechseln. +Mit den Bedienelementen kannst du die Uhr ein- und ausschalten, zwischen Stunden/Minuten- oder Sekundenanzeige wechseln sowie Sprache und Farbe einstellen. -Wie du diese Optionen ändern kannst, verrät der nächte Abschnitt. +Wie du diese Optionen ändern kannst, verrät der nächste Abschnitt. Es kann natürlich auch eine Collection von Elementen übergeben werden. Mit @@ -75,10 +76,12 @@ Der uhr()-Methode kann ein Options-Objekt mitgegeben werden: status: 'on', // 'on' (default) oder 'off' theme: 'black', // 'black' (default), 'white', 'red', 'yellow', 'green', 'blue' oder 'pink' (je nach eingebundenen Theme-Stylesheets) language: 'de_CH', // 'de_CH' (default), 'de_CH_genau', 'de', 'en', 'fr' oder 'it' (je nach eingebundenen Sprachdateien) + mode: 'normal', // 'normal' (default): Die Uhr zeigt die aktuelle Zeit (Stunden und Minuten) in Worten an + // 'seconds': Die Uhr zeigt die aktuellen Sekunden als grosse Ziffern an width: '100%', // eine CSS-Grössenangabe (default: 100%) force: false, // false (default): Falls ein Cookie im Browser besteht, werden dessen Konfigurationswerte übernommen; // true: immer die angegebene Konfiguration verwenden - controls: true, // true (default): Die Bedienelemente (Ein-/Ausschalter, Theme- und Sprachwähler) werden angezeigt + controls: true, // true (default): Die Bedienelemente (Ein-/Ausschalter, Theme-, Zeitmodus- und Sprachwähler) werden angezeigt // false: Die Bedienelemente werden nicht angezeigt autoresize: true // true (default): Die Uhr passt ihre Grösse dynamisch an // false: Die Uhr behält ihre anfängliche Grösse diff --git a/info/index.html b/info/index.html index 3c2a4fe..1fefaaf 100644 --- a/info/index.html +++ b/info/index.html @@ -20,6 +20,7 @@ along with this program. If not, see . + @@ -44,7 +45,8 @@ along with this program. If not, see .
  • Benötigte Bibliotheken
  • Einbinden in HTML
      -
    1. Javascript- und CSS-Dateien im <head>
    2. +
    3. Javascript- und CSS-Dateien im <head> +
    4. Uhr-Element auf der Seite
    5. Uhr initialisieren
    @@ -60,16 +62,16 @@ along with this program. If not, see .

    Hallo, Besucher!

    -

    Hier gibt's vertiefte Informationen über diese Uhr, die dir sagt, - wie spät es ist. Hier erfährt du, wie du sie selber auf deiner - Website einbauen kannst. Denn das darfst du gerne tun, solange du - dich dabei an die Regeln der Lizenz hältst.

    +

    Hier gibt's vertiefte Informationen über diese Uhr, die dir sagt, wie spät es ist. Hier erfährt du, wie du sie selber + auf deiner Website einbauen kannst. Denn das darfst du gerne tun, solange du dich dabei an die Regeln der Lizenz hältst.

    Das interessiert mich nicht, ich will zurück zur grossen Uhr!

    Die UhrZum Inhalt

    -
    +
    +

    Benötigte BibliothekenZum Inhalt

    @@ -84,9 +86,11 @@ along with this program. If not, see .
  • jQuery-cookie (getestet mit Version 1.4.0)
  • Einbinden in HTMLZum Inhalt

    -

    Javascript- und CSS-Dateien im <head>Zum Inhalt

    +

    Javascript- und CSS-Dateien im <head>Zum + Inhalt

    -

    Füge folgende Zeilen im <head>-Tag deines HTML-Dokumentes ein. Beachte dabei, dass die CSS-Dateien vor den +

    Füge folgende Zeilen im <head>-Tag deines HTML-Dokumentes ein. Beachte dabei, dass die + CSS-Dateien vor den Javascript eingebunden werden.
    <link rel="stylesheet" type="text/css" href="uhr.css" /> <link rel="stylesheet" type="text/css" href="uhr-black.css" data-class="black" data-name="Schwarz" /> @@ -108,12 +112,14 @@ along with this program. If not, see . <script type="text/javascript" src="uhr-it.js"></script>

    -

    Von den Stylesheets zwingend ist uhr.css und mindestens eines der Farbschema-Stylesheets. Die Attribute data-class bzw. - data-name definieren dabei die im Stylesheet deklarierte Klasse bzw. den im Auswahlmenu anzuzeigenden Namen. Der Name kann frei - gewählt werden, die Style-Klasse muss mit der im Stylesheet definierten übereinstimmen.

    +

    Von den Stylesheets zwingend ist uhr.css und mindestens eines der Farbschema-Stylesheets. Die + Attribute data-class bzw. data-name definieren dabei die im Stylesheet deklarierte + Klasse bzw. den im Auswahlmenu anzuzeigenden Namen. Der Name kann frei gewählt werden, die Style-Klasse muss mit + der im Stylesheet definierten übereinstimmen.

    -

    uhr-de_CH_genau.js ist eine Variante von Berndeutsch, bei der zur vollen Stunde zusätlich das Wort genau - angezeigt wird (also z.B. um 15:00 Uhr ES ISCH GENAU DRÜ).

    +

    uhr-de_CH_genau.js ist eine Variante von Berndeutsch, bei der zur vollen Stunde zusätlich das Wort genau angezeigt wird (also z.B. um 15:00 Uhr ES ISCH GENAU + DRÜ).

    Uhr-Element auf der SeiteZum Inhalt

    Definiere an der Stelle, wo die Uhr angezeigt werden soll, ein leeres <div>-Element:
    @@ -121,7 +127,8 @@ along with this program. If not, see .

    Uhr initialisierenZum Inhalt

    -

    Definiere im HTML-Dokument (<head> oder <body>) ein Javascript-Snippet, um die Uhr zu initialisieren:
    +

    Definiere im HTML-Dokument (<head> oder <body>) ein Javascript-Snippet, um die + Uhr zu initialisieren:
    <script type="text/javascript"> jQuery(document).ready(function() { jQuery('#meine-uhr').uhr(); @@ -129,10 +136,10 @@ along with this program. If not, see . </script>

    -

    Die Uhr wird so in der Standardkonfiguration angezeigt, das heisst: Berndeutsche Sprache, in der Farbe der ersten eingebundenen CSS-Datei (im - Beispiel also Schwarz), eingeschaltet, Breite 100% des Elternelementes. Wenn dies nicht deinen Bedürfnissen entspricht, lässt sich die Uhr wie im - folgenden Abschnitt beschrieben konfigurieren. Die Konfiguration wird der .uhr()-Methode als JSON-Objekt übergeben, beispielsweise - so:
    +

    Die Uhr wird so in der Standardkonfiguration angezeigt, das heisst: Berndeutsche Sprache, in der Farbe der ersten + eingebundenen CSS-Datei (im Beispiel also Schwarz), eingeschaltet, Breite 100% des Elternelementes. Wenn dies + nicht deinen Bedürfnissen entspricht, lässt sich die Uhr wie im folgenden Abschnitt beschrieben konfigurieren. + Die Konfiguration wird der .uhr()-Methode als JSON-Objekt übergeben, beispielsweise so:
    jQuery('#uhr').uhr({ width: '200px', theme: 'red' @@ -143,40 +150,47 @@ along with this program. If not, see .

    Es existieren die folgenden Konfigurationsoptionen:

    -
    width
    -
    Die Breite der Uhr als CSS-String, z.B. '50%', '120px' oder '2.8em'. Die Höhe passt sich automatisch - der Breite an, so dass die Uhr immer quadratisch ist. +
    autoresize
    +
    Gibt an, ob die Uhr ihre Grösse dynamisch anpassen soll, wenn das Elternelement seine Grösse ändert, oder ob + sie immer die anfängliche Grösse behält. Mögliche Werte sind true oder false. +
    Typ: boolean +
    Default: true
    +
    controls
    +
    Gibt an, ob die Steuerelemente zur Auswahl von Farbe und Sprache und der Ein-/Ausschalter angezeigt werden + sollen. Mögliche Werte sind true oder false. +
    Typ: boolean +
    Default: true
    +
    force
    +
    Legt fest, ob die in der Konfiguration angegebenen Werte allfällig in einem Browser-Cookie gespeicherte + Einstellungen überschreiben sollen oder nicht. Mögliche Werte sind true (Konfiguration + überschreibt Cookie-Werte) oder false (Cookie-Werte haben Vorrang). +
    Typ: boolean +
    Default: false
    +
    language
    +
    Die anfänglich ausgewählte Sprache als String. Welche Sprachen unterstützt werden, hängt davon ab, welche + Sprachdateien eingebunden werden.
    Typ: String -
    Default: '100%'
    +
    Default: 'de_CH' +
    mode
    +
    Der Zeit-Anzeigemodus, entweder 'normal' (aktuelle Zeit in Worten anzeigen als "ES IST VIER + UHR") oder 'seconds' (aktuelle Sekunden als grosse Ziffern anzeigen). +
    Typ: String +
    Default: 'normal'
    status
    Der Anfangszustand der Uhr, entweder 'on' oder 'off'
    Typ: String
    Default: 'on'
    -
    language
    -
    Die anfänglich ausgewählte Sprache als String. Welche Sprachen unterstützt werden, hängt davon ab, welche Sprachdateien eingebunden werden. -
    Typ: String -
    Default: 'de_CH'
    theme
    -
    Die anfänglich ausgewählte Farbe der Uhr. Welche Farben unterstützt werden, hängt davon ab, welche CSS-Dateien eingebunden werden. +
    Die anfänglich ausgewählte Farbe der Uhr. Welche Farben unterstützt werden, hängt davon ab, welche + CSS-Dateien eingebunden werden.
    Typ: String
    Default: Farbe der ersten eingebundenen CSS-Datei
    -
    force
    -
    Legt fest, ob die in der Konfiguration angegebenen Werte allfällig in einem Browser-Cookie gespeicherte Einstellungen überschreiben sollen - oder nicht. Mögliche Werte sind true (Konfiguration überschreibt Cookie-Werte) oder false (Cookie-Werte haben - Vorrang). -
    Typ: boolean -
    Default: false
    -
    controls
    -
    Gibt an, ob die Steuerelemente zur Auswahl von Farbe und Sprache und der Ein-/Ausschalter angezeigt werden sollen. Mögliche Werte sind true - oder false. -
    Typ: boolean -
    Default: true
    -
    autoresize
    -
    Gibt an, ob die Uhr ihre Grösse dynamisch anpassen soll, wenn das Elternelement seine Grösse ändert, oder ob sie immer die anfängliche Grösse - behält. Mögliche Werte sind true oder false. -
    Typ: boolean -
    Default: true
    +
    width
    +
    Die Breite der Uhr als CSS-String, z.B. '50%', '120px' oder '2.8em'. + Die Höhe passt sich automatisch der Breite an, so dass die Uhr immer quadratisch ist. +
    Typ: String +
    Default: '100%'

    InformationenZum Inhalt

    -

    Programmiert von Manuel Friedli mit Inspiration von QLOCKTWO.
    - Diese Uhr ist aus Freude am Programmieren und am Konzept einer die Zeit in Worten ausdrückenden Uhr entstanden. Sollte daraus jemandem Schaden - oder ein gravierender Nachteil erwachsen, so soll sich diese Person bei mir melden und wir werden bestimmt eine Lösung finden, die für alle - beteiligten angemessen ist. Allen anderen Personen wünsche ich viel Freude mit der Zeit im Wort.

    +

    Programmiert von Manuel Friedli mit Inspiration von QLOCKTWO.
    + Diese Uhr ist aus Freude am Programmieren und am Konzept einer die Zeit in Worten ausdrückenden Uhr entstanden. + Sollte daraus jemandem Schaden oder ein gravierender Nachteil erwachsen, so soll sich diese Person bei mir melden + und wir werden bestimmt eine Lösung finden, die für alle beteiligten angemessen ist. Allen anderen Personen + wünsche ich viel Freude mit der Zeit im Wort.

    Der Quellcode ist frei zugänglich unter https://gittr.ch/manuel/uhr.

    LizenzbestimmungenZum Inhalt

    -

    Der komplette Sourcecode ist unter der GNU GPL 3.0 lizenziert und darf nach deren Vorgaben verwendet, kopiert, weitergegeben und verändert werden. - Die GNU GPL 3.0 findest Du unter folgendem Link: GNU GPL 3.0. Und direkt hier:

    +

    Der komplette Sourcecode ist unter der GNU GPL 3.0 lizenziert und darf nach deren Vorgaben verwendet, kopiert, + weitergegeben und verändert werden. Die GNU GPL 3.0 findest Du unter folgendem Link: GNU GPL 3.0. Und direkt hier:

    GNU GENERAL PUBLIC LICENSE

    @@ -904,6 +933,7 @@ along with this program. If not, see . may consider it more useful to permit linking proprietary applications with the library. If this is what you want to do, use the GNU Lesser General Public License instead of this License. But first, please read - <http://www.gnu.org/philosophy/why-not-lgpl.html>.

    + <http://www.gnu.org/philosophy/why-not-lgpl.html>. +