JS spezifische Buch-Parameter

Die Anzahl der allgemeinen (und von allen Varianten unterstützten) Parametern ist deutlich geringer als in den AIR/FLASH Varianten:

  • Anzahl JS Parameter: ca. 60
  • Anzahl AIR/FLASH Parameter: ca. 300

Es gibt aktuell 5 Parameter, die nur in der Javascript Version unterstützt werden. Diese beginnen alle mit den Zeichen “js” und können bei Bedarf über die Suche/Filter Funktion leicht gefunden werden.
Es handelt sich dabei um diese Parameter:

  • jsLanguageToggle
    Falls auf “true” gesetzt, wird nur ein Sprach-Icon angezeigt, und ein Klick schaltet zur nächsten verfügbaren Sprache weiter.
    Vorteil: In der “navigation bar”, d.h. dem Block mit den Social und language Icons, wird Platz gespart.
    Die kann Sinn machen, wenn auch Bildschirme mit geringer Breite und viele Social Icons und Sprachen unterstützt werden sollen.
    Ist dieser Parameter auf “false” gesetzt (Default Einstellung), werden alle SPrach-Kürzel bzw. Sprach-Icons in der navigationbar angezeigt und die gewünschte Sprache kann gezielt ausgewählt werden.
  • jsNavbarHeightFactor
    Über diesen Parameter kann allgemein die Höhe der aller Icons reduziert werden.
  • jsSocialButtonHeightFactor
    Über diesen Button kann (zusätzlich) die Höhe der Social-Buttons angepasst (verkleinert) werden.
  • jsActiveLangHeightFactor
    Die Höhe der ausgewählten (aktiven) Sprache kann mit diesem Faktor eingestellt werden; unabhängig von den Social Buttons.
  • jsInactiveLangHeightFactor
    Die Höhe der anderen (nicht aktiven) Sprach-Kürzel bzw. Sprach-Icons kann unabhängig von den anderen Icons gewählt werden.
    Damit kann man z.B. bei Verwendung derselben Icons für die aktive und inaktive Variante anzeigen, welches die aktuell ausgewählte Sprache ist.
    In so einem Fall wird man den Faktor für die inaktive Sprache kleiner als den Faktor für die aktive Sprache wählen..

Der gültige Wertebereich wird bei jedem Parameter angegeben. Auch der Default-Wert wird angezeigt.

Um z.B. die ANzeige der Sprach-Icons beurteilen zu können, muss das Javascript “Package” auf den Server geladen und übers Internet, oder im lokalen Server (s. Kapitel XAMPP) im Browser angezeigt werden.

AIR/FLASH spezifische Buch-Parameter

In den AIR/FLASH Varianten stehen alle ca. 300 Parameter zur Verfügung.
Um bei der Auswahl zu helfen, sind die Parameter (subjektiv) in Gruppen mit unterschiedlichem “Ranking” eingeteilt:
Mit“1” sind alle Parameter gekennzeichnet, die häufig genutzt werden.
Ein 2-er Parameter wird schon seltener genutzt, und ein 4-er oder 5-er Parameter sollte nur bei entsprechenden Kenntnissen und Notwendigkeiten verändert werden.

Allgemeine Hinweise

Diese Hinweise sind für alle Varianten gültig, da die Bedienung und die Fenster identisch sind.
Je nach Variante werden allerdings nur die Parameter angeboten, die jeweils unterstützt werden.
Sollte ein Parameter in allen Versionen unterstützt werden, werden die entsprechenden Parameter in den anderen Versionen ebenfalls geändert/synchronisiert.

Buch-Parameter-Auswahl-Fenster

Über den Book Parameter Knopf im jeweiligen Settings-Menü wird das Fenster mit der Anzeige der spezifischen Buch-Parameter angezeigt.
Hier beispielhaft für die Buchparameter der Air/FLASH Variante. Das Fenster der Jaascript Variante sieht genau so aus, enthält aber nur Parameter, die von der Javascript Variante unterstützt werden.

Zur Eingrenzung/Reduzierung/Suche stehen folgende Optionen zur Verfügung:

Suche/Filter
Gibt man in das Feld einige Buchstaben des gesuchten Parameters ein, zeigt die Liste nur noch alle ähnlichen Parameter an

Group
Jeder Parameter ist einer Parameter-Gruppe zugeordnet. Ähnliche Parameter bzw. logisch verwandte Parameter weredn jeweil in einer Gruppe zusammengefasst.
Parameter können auch unterschiedlichen Gruppen angehören.
Filter man z.B. alle Parameter heraus, die der Gruppe “drag” angehören, werden nur noch 12 Parameter aus den insgesamt 303 Parametern angezeigt.

Sortieren
Alle Spalten können mit einem Klick in den Spltenkopf (header) sortiert werden. Ein weiterer Klick kehrt die Sortier-Reiehnfolge um.
Die Grundeinstellung ist: Sortierung nach “rank” um die wichtigsten, am meisten genutzten Parameter zuerst anzuzeigen.

Folgende Informationen (Spalten-Header) werden in den Spalten der Liste angezeigt.
rank
Nach dem Öffnen ist die Liste ist nach dem “rank” (Priorität, “Nützlichkeit”) sortiert. Ein Wert von “1” kennzeichnet die am häufigsten verwendeten Parameter.

attrib
In dieser Spalte, nach der genau wie nach allen anderen Spalten mit einem Klick in den Kopf/Bezeichner der Spalte sortiert werden kann, steht der Name des Parameters/Attributs.

value
Der eingestellte Wert wird in der Spalte “value” angezeigt. Ist das Feld leer, werden die Standard-Einstellungen genutzt. Diese werden in der nächsten Spalte “def” angezeigt.

def (default)
Der “Default-Wert” ist der Standard-Wert des Parameters. Wird kein anderer Wert eingegben (d.h. die Zelle ist leer), wird dieser Standard-Wert genutzt. Man kann über die Eingabe-Option einen anderen Wert setzen. Löschrt man den Wert, wird wieder der Default-Wert genutzt.,

type
“type” bestimmt die Art des Parameter-Werts. Beipiele von Wert-Typen sind: Integer/ganzzahliger Wert, Float (Wert mir Nachkommastellen), Prozent, Farbcode,Auswahlliste, …

Wiki
Jeder Wert ist in der Wiki definiert nd beschrieben (allerdings nur auf Engisch). In der letzten Spalte findet man den Link zum Wiki-Eintrag zu diesem Parameter.

Buch-Parameter-Einstellungs-Fenster

Auch dieses Beispiel zeigt ausgewählte Buch-Parameter der Air/Flash Variante. Bei der JS Variante ändert sich nur die Anzahl der verfügbaren Parameter.

Wählt man in der Liste mit einem Klick in die Zeile/Zelle ein Attribut (Parameter) aus, öffnet sich ein neues Fenster.
In diesem Fenster werden nur noch Attribute derselben Gruppe angezeigt, wie hier die Gruppe “drag” (ziehen mit der Maus).

*Werte ändern”
Der aktuelle Wert des gewählten Attributs wird angezeigt und kann über den spezifischen und Typ-abhängigen “Editor” (Einstell-Hilfe) geändert werden.
Eine Liste aller Editoren ist weiter unten zu finden).
In diesem Beispiel wurde die “Draga Area” ausgewählt. Eine Drag Area ist der Bereich im Buch, der auf einen Klick (oder ein Ziehen) mit der Maus reagiert.
Man kann diese Drag-Bereiche (seitlicher Buch-Rand, oberer/unterer Rand) getrennt aktivieren oder sperren.

Schließt das Fenster

Wurde der Wert verändert und mit “Enter” eingegeben, stehen diese beiden Knöpfe zur Verfügung.
“Abort” schließt das Fenster und macht Änderungen rückgängig.
“Save” übernimmt die Änderungen und speichert sie in der Buch-Parameter Konfigurations-Datei.

Editoren (Einstelloptionen)

Folgende Werte-Typen der Parameter werdn durch eigene, spezifische “Editoren” unterstützt:

Integer-Werte

Ein Integer/Ganzzahl-Wert kann in das Eingabefeld eingetragen oder mit dem Slider eingestellt werden.
Der minimale und maximale zulässige Bereich wird beim Slider angezeigt. EIne Änderung ist nur innerhalb dieser Grenzen möglich.
EIne eingegebene Zahl wird ebenfalls auf diese Grenzen hin überprüft.

Float-Werte

Ein Float/Kommazahl-Wert kann in das Eingabefeld eingetragen oder mit dem Slider eingestellt werden.
Der minimale und maximale zulässige Bereich wird beim Slider angezeigt. EIne Änderung ist nur innerhalb dieser Grenzen möglich.
EIne eingegebene Zahl wird ebenfalls auf diese Grenzen hin überprüft.

Prozent-Werte

Ein Prozent-Wert kann in das Eingabefeld eingetragen oder mit dem Slider eingestellt werden.
Der minimale und maximale zulässige Bereich wird beim Slider angezeigt. EIne Änderung ist nur innerhalb dieser Grenzen möglich.
EIne Zahl kann als Wert (z.B. Bereich in Pixel) ODER als Prozentwert nn% eingegeben werden und wird ebenfalls auf Einhaltung der individuellen Grenzwerte hin überprüft.
Ein fester Wert wird dabei von mz3Tool unter Nutzung der Bezugsgröße auf den entsprechenden Prozentwert umgerechnet.


Beispiel: Der Drag-Range (Breite des aktiven Bereichs, innerhalb dessen man durch Klick oder Drag die Seite wechseln kann) wird als Prozentsatz der Seitenbreite erwartet.
Ist die Seitenbreite 800px und wird ein Pixelwert von 200 für den Drag-Range eingegeben, wird als Porzentwer 200&800 = 0.25 berechnet.

Farb-Werte

Die Farbe kann in einem Farbfeld (color picker) ausgewählt oder als Hex-Wert eingegeben werden.
Über den Slider kann ein Alpha-Wert (Opazität, auch fälschlkicherweise oft Transparenz gennannt) ausgewählt werden.
Der gültige Bereich liegt zwischen 0 (keine Abdeckung, volle Transparenz) und 255 (volle Abdeckung/Opazität, keine Transparenz).
Verdeutlicht wird dies an zwei Beispiel-Feldern nit schwarzem und weißem Hintergrund.

Binär-Werte

Diese Boolschen Parameter kennen nur die Zustände “ein” und “aus” uind dienen meist als Schalter.
Der Zustand kann über den jeweiligen Radio-Button (true/false) ausgewählt werden. EIn Klick auf den “Default”-Button setzt den Schalter auf die Grundstellung (das kann je nach Parameter auch einem true/ein sein!).

Text-Werte

Die Typen “String” und “URL” werden als Text eingegeben
Eine Überprüfung/Plausibilisierung findet nicht statt.

Auto-Werte

Dies sind spezielle Binärwerte, die um die Einstellung “auto” erweitert wurden.
Da nur eine Einstellung ausgewählt werden kann, ist die Eingabe als “Radio-Button” realisiert.
Mit einem Klick auf so einen Knopf wird die vorhergehende Einstellung abgewählt und die neue übernommen.
Frage aus Neugierde: Kennt noch jemand der jünger als 40 Jahre alt ist, diese alten Radios mit den Tasten zur Auswahl vom UKW, MW, KW, LW?
Von dieser “Tasten-Logik” wurde der Begriff “rario button” (Radio-Knopf/Taste) übernommen!
Im Unterschied zu “Default” wird der festgelegte Standardwert nicht in allen Situation auf denselben Wert gesetzt, sondern kann abhängig von Randbedingungen wechseln.
Beispiel: Unterschiedliches “normales” Verhalten auf einem Desktop-Rechner und einem Touch-Device.
Über die Einstellungen “no” und “yes” kann dieses Verhalten überschrieben werden und erzwingt die Einstellung unabhängig von der Umgebung (Rechner, Seitenverhältnis, Bildschirmauflösung, …).
In fast allen Fällen ist “auto” eine sinnvolle Wahl.

Auswahl-Liste

Kann der Parameter mehrere Zustände einnehmen, werden diese Werte intern als Text mti einem Komma als Trenner gespeichert.
Auswählen kann man die zu nutzenden Werte über eine Check-Box durch setzen des Hakens.
Im Gegensatz zu einem Radio-Button können mehrere Checkboxes gleichzeitig gesetzt werden. Wenn Werte einer Liste mit einer begrenzten Anzahl Einstellungen vorliegen, können diese in Form von “Check-Boxes” angeboten werden.

Last modified: 2019/01/26

Reaktion

War das hilfreich?

Ja Nein
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.

Hinterlasse einen Kommentar.

Kommentar senden