Navbars

Inhaltsverzeichnis des Blox-Projektes | Übersicht aller Projekte

Blox Project Table of Contents | Overview of all Projects

Impressum

Inhalt dieser Seite

  • 1   Ziele
  • 2   docutils-Container
  • 3   Navbars mit mehreren Abschnitten
    • 3.1   Der flexnavbar-Container
    • 3.2   Die Gruppen der Navbar
  • 4   Navbars mit genau einem Abschnitt
  • 5   Fußleisten
  • 6   Zusammenfassung
  • 7   Diskussion

1   Ziele

Es soll eine Navigationsleiste mit mehreren Abschnitten erstellt werden, welche zum Beispiel jeweils eine Reihe von Links enthalten. Typischerweise existieren zwei solche Abschnitte, welche am linken und rechten Ende der Navigationsleiste dargestellt werden sollen. Es soll aber auch möglich sein, nur links oder nur rechts einen solchen Abschnitt einzublenden.

Die einzelnen Abschnitte (oder Gruppen) der Navigationsleiste sollen als durch Leerzeilen getrennte Absätze im Inhalt einer ReST-container-Direktive notiert werden können. Beispielsweise soll man schreiben können:

.. container:: flexnavbar

    ((linke Linkgruppe))

    ((rechte Linkgruppe))

Zusätzlich sollen auf eine ähnliche Weise Fußleisten möglich gemacht werden:

.. container:: flexfooter

    ((linke Linkgruppe))

    ((rechte Linkgruppe))

Die Navigationsleisten dieser Art werden auch kurz als Navbars bezeichnet.

2   docutils-Container

Die container-Direktive in docutils umschließt ihren Inhalt im HTML-Rendering durch ein div-Element. Man schreibt:

.. container:: ((Argumente))

    ((Körper des Containers))

Die (optionalen) Argumente der container-Direktive werden in Klassennamen des resultierenden div-Elements übertragen.

Enthält der Körper eines docutils-Containers mehrere durch Leerzeilen voneinander getrennte Absätze, werden diese Absätze von docutils als p-Elemente dargestellt. Andernfalls, wenn genau ein Absatz vorhanden ist, wird auf den Einschluss in ein p-Element verzichtet.

Dies hat Auswirkungen auf das Design der Navbar-Styles, da man im Falle eines einzelnen Abschnitts nicht mit einem p-Element rechnen kann. Andernfalls, bei Vorhandensein mehrerer Absätze, können die p-Elemente für das Styling verwendet werden.

Für die Gruppierung von Inhalten in Absätzen stellt docutils die compound-Direktive bereit. Man könnte daher schreiben:

.. container::

    .. compound::

        ((Absatzinhalt))

Leider erzeugt die compound-Direktive zwar wie gewünscht ein p-Element, welches den ((Absatzinhalt)) umschließt, aber dieser Absatz wird nicht direkt im Container-div-Element platziert. Stattdessen wird der p-Absatz umschlossen durch ein zusätzliches div-Element im übergeordneten div-Container dargestellt.

Es ist mir keine Methode bekannt, um in Containern mit nur einem Absatz als Körper dessen Inhalt in ein p-Element einzuschließen, so dass dieser Absatz direkt im Container-div-Element positioniert wird. Deshalb werden getrennte Styles für Navigationsleisten mit mehreren Abschnitten und solche mit nur einem Abschnitt erstellt. Eine derartige Unterscheidung ist auch deshalb notwendig, da für Navigationsleisten mit nur einer Gruppe zwischen der Darstellung dieser Gruppe auf der linken oder rechten Seite gewählt werden muss. Es ist auch richtig, dass docutils bei Abwesenheit mehrerer Absätze das p-Element fortlässt, um das HTML-Rendering so einfach wie möglich zu halten.

3   Navbars mit mehreren Abschnitten

Der hier dargestellte CSS-Code ist auf ReST-Texte der folgenden Form anwendbar:

.. container:: flexnavbar

    ((Abschnitt 1))

    ((Abschnitt 2))

    ((...))

Dabei ist es notwendig, dass mindestens zwei Abschnitte ((Abschnitt 1)) und ((Abschnitt 2)) vorhanden sind.

3.1   Der flexnavbar-Container

Dem div.flexnavbar-Container geben wir den folgenden Stil:

div.flexnavbar {
    display: flex;
    justify-content: space-between;
    background-color: #f8f8f8;

    border: thin solid #ddd;
    border-radius: 1.5ex;
}

Durch die Deklaration display: flex wird das div.flexnavbar-Element zu einem Flex-Container mit von links nach rechts verlaufender Hauptachse (dem Standardverhalten).

Um bei zwei Abschnitten ((Abschnitt 1)) und ((Abschnitt 2)) diese am linken und rechten Ende des Containers darzustellen, kommt die Deklaration justify-content: space-between zur Anwendung.

Außerdem geben wir der gesamten Navigationsleiste noch einen grauen Farbton, mit einer grauen dünnen Umrandungslinie sowie abgerundeten Ecken.

3.2   Die Gruppen der Navbar

Da hier mehrere Abschnitte im Körper des flexnavbar-Containers vorhanden sind, werden diese als p-Elemente gerendert. Um diese als Abschnitte der Navbar zu formatieren, kann man schreiben:

div.flexnavbar > p {
    text-align: left;
    padding: 0.5ex 0.8ex;
    margin: 1.25ex 1.5ex;
    background-color: white;

    border: thin solid #ccc;
    border-radius: 1ex;
}

Hier werden die Absatzelemente ausgewählt, welche direkte Kinder des Container-div.flexnavbar-Elements sind. Wir umranden die jeweiligen Gruppen durch das Setzen der border-Eigenschaft mit einem dünnen grauen Rahmen. Innerhalb des Rahmens werden die Gruppen durch weißen Hintergrund (background-color: white) aus der Navbar herausgehoben.

Die Ecken der Gruppenumrandungen werden ähnlich denen der Navbar abgerundet. Außerhalb der Umrandungen um jede Gruppe lassen wir etwas Platz bis zur Kante der Navbar (margin). Der Abstand wird horizontal absichtlich etwas größer als vertikal gewählt.

Der Rahmen um eine Gruppe wird außerdem ein klein wenig von ihrem Textinhalt abgesetzt (padding). Dabei wird der horizontale Abstand etwas größer als der vertikale Abstand gewählt, um visuell diese Abstände gleich groß zu rendern. Dies ist insbesondere aufgrund der abgerundeten Ecken als Korrektur notwendig.

Wenn in einem Abschnitt kein Zeilenumbruch notwendig ist, bestimmt sich seine horizontale Größe genau aus dem in ihm enthaltenen Text:

Link links

Link rechts

Wenn der horizontale Platz in der Navigationsleiste nicht ausreicht, um den Text der Navbar-Gruppen einzeilig darzustellen, kommt die Deklaration text-align: left zum Tragen:

Inhaltsverzeichnis des Projektes | Übersicht aller Projekte | Zusätzlicher Link 1 | Zusätzlicher Link 2 | Project Table of Contents | Overview of all Projects | Additional Link 1 | Additional Link 2

Downloads im Projekt | Downloads der gesamten Site | Impressum

Der überschüssige Platz wird hier durch text-align: left am rechten Ende der Abschnitte freigelassen.

4   Navbars mit genau einem Abschnitt

Im Falle nur einer einzelnen Gruppe im Container für die Navigationsleiste existiert im Container-div kein hierarchisch untergeordnetes XML-Element, welches den Inhalt der Gruppe umschließt. Es ist deswegen nicht möglich, die einzelne Gruppe von der umschließenden Navigationsleiste graphisch abzusetzen. Für die Gestaltung bietet sich daher an:

div.flexnavbar-left {
    text-align: left;
    padding: 0.5ex 0.8ex;
    background-color: #f8f8f8;

    border: thin solid #ddd;
    border-radius: 1ex;
}
div.flexnavbar-right {
    text-align: right;
    padding: 0.5ex 0.8ex;
    background-color: #f8f8f8;

    border: thin solid #ddd;
    border-radius: 1ex;
}

Diese CSS-Codes erheben die Gruppe zur Navbar. Die Auszeichnung ist weitgehend äquivalent zur Gestaltung der Absätze im Falle mehrbereichiger Navigationsleisten, sie betrifft hier allerdings den div-Bereich anstelle der p-Elemente, während der graue Hintergrund des div-Elements beibehalten wird. Dies führt dazu, dass der einzelne Bereich der flexnavbar-left- oder flexnavbar-right-Navbar sich über die gesamte zur Verfügung stehende Breite erstreckt. Der enthaltene Text wird durch die text-align-Eigenschaft linksbündig bzw. rechtsbündig in der Navigationsleiste formatiert.

Eine linksbündige Navigationsleiste mit einem einzelnen Bereich unter Verwendung von flexnavbar-left wird beispielsweise folgendermaßen dargestellt:

Erster Link | Zweiter Link

5   Fußleisten

Fußleisten werden genauso wie Navigationsleisten mit Inhalt versehen, es wird lediglich eine andere CSS-Klasse für den umschließenden Container verwendet:

.. container:: flexfooter

    ((linker Abschnitt))

    ((rechter Abschnitt))

Styles für Fußzeilen mit nur einem Abschnitt werden nicht definiert, da sie nicht gebraucht werden. Es sind stets eine Gruppe auf der linken Seite mit Datumsangaben bzgl. der Freigabe sowie eine Gruppe auf der rechten Seite zur Navigation in der Veröffentlichungsgeschichte vorhanden.

Die Gestaltung von Fußleisten ist einfacher als die von Navigationsleisten, da Fußleisten vom gewöhnlichen Seiteninhalt bereits durch einen Querstrich getrennt sind und graphisch im Hintergrund stehen. Es reicht deshalb aus zu schreiben:

div.flexfooter {
    display: flex;
    justify-content: space-between;
}
div.flexfooter > p {
    text-align: left;
    margin-top: 0pt;
    margin-bottom: 0pt;
}

Hier werden weder Hintergrundfarben noch Umrandungen angepasst. Das prinzipielle Herangehen ist dem für Navigationsleisten mit mehreren Einträgen sehr ähnlich: Es wird ein flex-Container mit justify-content: space-between verwendet. Für die p-Abschnitte genügt es hier, die margin-top- und margin-bottom-Maße auf 0pt zu setzen, um den docutils-Style von 1em zu übersteuern.

Ein Beispiel wird hier nicht gegeben, da der Trennstrich, welcher die Fußleiste vom Textkörper trennt, hier nicht wiedergegeben werden kann und es außerdem für die Darstellung essentiell ist, dass unterhalb der Fußleiste kein weiterer Inhalt mehr folgt.

6   Zusammenfassung

Der CSS-Code für Navigationsleisten mit mehreren Gruppen, Navigationsleisten mit nur einer Gruppe sowie Fußzeilen lautet insgesamt:

navbars.css
div.flexnavbar {
    display: flex;
    justify-content: space-between;
    background-color: #f8f8f8;

    border: thin solid #ddd;
    border-radius: 1.5ex;
}
div.flexnavbar > p {
    text-align: left;
    padding: 0.5ex 0.8ex;
    margin: 1.25ex 1.5ex;
    background-color: white;

    border: thin solid #ccc;
    border-radius: 1ex;
}

div.flexnavbar-left {
    text-align: left;
    padding: 0.5ex 0.8ex;
    background-color: #f8f8f8;

    border: thin solid #ddd;
    border-radius: 1ex;
}
div.flexnavbar-right {
    text-align: right;
    padding: 0.5ex 0.8ex;
    background-color: #f8f8f8;

    border: thin solid #ddd;
    border-radius: 1ex;
}

div.flexfooter {
    display: flex;
    justify-content: space-between;
}
div.flexfooter > p {
    text-align: left;
    margin-top: 0pt;
    margin-bottom: 0pt;
}

7   Diskussion

Es gibt mehrere Gestaltungselemente, welche im Zusammenhang mit der Navbar gesehen werden können: Große Buttons und Codesegmente. Die hier vorgestellten Stile wurden so definiert, dass die resultierenden Navbars gestalterisch mit diesen anderen Elementen harmonieren. So wurde der Radius der äußeren Eckenabrundung genauso gewählt wie für die großen Buttons. Das Grau der Hintergrundfarbe der Navigationsleisten wurde so gewählt, dass das Gewicht der Navigationsleisten nicht zu groß und nicht zu klein ist; es ergibt sich ein anderes Grau als es für die Codesegmente verwendet wird. Der horizontale Abstand zwischen den Berandungen der Navbar-Gruppen und der Kante der Navbar selbst wurde so angepasst, dass das Ergebnis den horizontalen Abständen in großen Buttons ähnelt; der vertikale Abstand ist davon unabhängig und wurde etwas kleiner eingestellt. Auf eine Angleichung der Eckabrundung zwischen Codesegmenten und Navbars wurde verzichtet, sodass die scharfen Ecken der Codesegmente ungeändert bleiben.

Die graphische Heraushebung der Navigationsleistengruppen aus dem Hintergrund der Navigationsleiste betont die Zusammengehörigkeit der gruppierten Elemente. Dies ist der Übersicht förderlich, wenn aufgrund von Platzmangel Gruppen einer Navigationsleiste mehrzeilig dargestellt werden müssen. Für Fußzeilen kann auf eine derartige Betonung erfahrungsgemäß verzichtet werden.

Im Falle mehrzeiliger Gruppen sind die Abschnitte der Navbar breiter als der umgebrochene Inhalt. Die Lesbarkeit ist hier mit text-align: left das Optimum, dies ist hier insbesondere der Alternative text-align: justify überlegen.


Es ist eine neuere Version dieser Seite verfügbar.

Freigegeben am 27. Juni 2024. Ausgemustert am 7. Januar 2025.

← Vorherige Version | Nächste Version → | Letzte Version