Deutsch
Über dieses Handbuch

Dieses Handbuch gehört zur Vorlage Example für QuartzControl. Es erklärt die Vorlage und führt zugleich alles vor, was sie kann.

Der Text hier kommt aus einer Markdown-Datei, nicht aus der Konfiguration.

Der Sprachumschalter

Der Umschalter steht in der Werkzeugleiste im Kopfbereich, rechts neben Suche, Farbschema-Umschalter und Lesemodus. Er teilt deren Maße: 44 px hoch, gleicher Rahmen, gleiche Ecken, gleiche Rückmeldung beim Überfahren. Vier Bedienelemente in einer Zeile, die sich in der Höhe unterscheiden, lesen sich als Fehler.

Drei Bauformen

Das Plugin kennt drei Darstellungen. Alle drei sind in dieser Vorlage gestaltet, sichtbar ist eine — welche, entscheidet switcher.style in der Konfiguration.

FormWas sie istWofür sie taugt
dropdownein <details>-Element mit Liste darunterhier in Gebrauch — ein Bedienelement, egal wie viele Sprachen
linksdie Sprachen nebeneinander, durch | getrenntzwei Sprachen, viel Platz
flagsFlaggen-Emoji statt Namensehr eng, wenn die Sprachen bekannt sind

Gewählt ist dropdown, weil er als ein Kasten neben dem Suchfeld steht und nicht breiter wird, wenn eine dritte Sprache dazukommt. Die Liste öffnet sich nach unten, rechtsbündig unter dem Button, mit demselben Schatten wie Suche und Vorschau — den einzigen beiden anderen Stellen dieser Vorlage, die wirklich über der Seite schweben.

Die beiden anderen Formen sind trotzdem vollständig gestaltet: Wer in QuartzControl auf links oder flags umstellt, bekommt keine ungestaltete Komponente, sondern eine, die in dieselbe Leiste passt. Bei flags wächst das Emoji auf Lesegröße und der Button bleibt quadratisch.

Was der Umschalter zeigt

  • Die aktuelle Sprache steht als Button-Beschriftung und in der Liste als hervorgehobener, nicht anklickbarer Eintrag mit aria-current.
  • Die Beschriftung ist der Name in der jeweiligen Sprache (switcher.label: native) — „Deutsch“ und „English“, nicht „German“. Ein Sprachname, den man nicht liest, weil man die Sprache nicht kann, ist keine Hilfe.
  • Gibt es keine Übersetzung dieser Seite, führt der Eintrag auf die Startseite der anderen Sprache (switcher.missing: home) und sagt das im title. Die Alternativen wären, den Eintrag auszublenden — dann verschwindet der Ausweg — oder ihn auszugrauen, was eine Sackgasse zeigt, statt einen Weg anzubieten.
  • Jeder Eintrag trägt lang und hreflang. Ein Screenreader spricht „English“ damit englisch aus, auch mitten in einer deutschen Seite.

Am Smartphone

Die Werkzeugleiste ist eine Flex-Zeile mit wrap. Auf 390 px teilen sich Schubladen-Button, Seitenname und vier Bedienelemente den Platz; die Suche gibt ihr Wort auf und wird ein Quadrat, der Umschalter behält seinen Namen, weil zwei Buchstaben („DE“) weniger sagen als „Deutsch“ und der Platz dafür reicht.

Die Merkung

rememberChoice: true legt die gewählte Sprache im localStorage ab. Genutzt wird das von der Wurzel-Weiche — die diese Website nicht hat, weil ihre Wurzel die deutsche Startseite ist — und von den Hinweisen über der Seite: Wer einmal auf Englisch umgeschaltet hat, bekommt den Hinweis danach auf Englisch, unabhängig von der Browsersprache.

Welche Variablen hier greifen

Diese 23 Variablen liest der Abschnitt nav-language-switcher in plugin-multilanguage.scss. Ändern lassen sie sich in QuartzControl unter Stile → Variablen — ohne eine Zeile CSS.

VariableWertgilt außerdem für
--dark#17171A · dunkel #FCFCFA13 weitere Komponenten
--darkgray#333333 · dunkel #DDDDDD18 weitere Komponenten
--font-interfacevar(--bodyFont) = "Noto Sans", system-ui, "Segoe UI", Robot…3 weitere Komponenten
--gray#5F5F5F · dunkel #A1A1A122 weitere Komponenten
--light#FCFCFA · dunkel #16171A14 weitere Komponenten
--secondary#1463A3 · dunkel #699DC319 weitere Komponenten
--tpl-icon-sm0.95rem3 weitere Komponenten
--tpl-leading-snug1.4rem4 weitere Komponenten
--tpl-motion150ms ease13 weitere Komponenten
--tpl-radius-md8px17 weitere Komponenten
--tpl-rule-controlcolor-mix(in srgb, var(--gray) 70%, var(-…11 weitere Komponenten
--tpl-rule-width1px25 weitere Komponenten
--tpl-shadow0 6px 24px rgba(23, 23, 26, 0.10) · dunkel 0 6px 24px rgba(0, 0, 0, 0.55)5 weitere Komponenten
--tpl-space-2xs0.25rem16 weitere Komponenten
--tpl-space-3xs0.125rem6 weitere Komponenten
--tpl-space-lg1.5rem12 weitere Komponenten
--tpl-space-md1rem18 weitere Komponenten
--tpl-space-sm0.75rem10 weitere Komponenten
--tpl-space-xs0.5rem20 weitere Komponenten
--tpl-surface-tintvar(--highlight) = rgba(42, 78, 108, 0.10)14 weitere Komponenten
--tpl-target44px12 weitere Komponenten
--tpl-text-sm0.875rem20 weitere Komponenten
--tpl-text-xl1.4rem6.4 – Variablen

Diese Tabelle ist erzeugt: Sie wird aus den Stylesheets gelesen, nicht von Hand gepflegt.

Weiterlesen

Diese Seite gehört zu Example — der Beispielvorlage für QuartzControl. Ein Überblick über alle Bereiche steht auf der Startseite.

Auf einem schmalen Bildschirm ist die Navigation oben eingeklappt.