LinkGroup
Die LinkGroup-Komponente bildet einen umfassenden Container für eine vertikale oder horizontale Liste von Links. Sie rendert eine auf Barrierefreiheit optimierte Liste von Links, die als Text, als Icon oder auch in Kombination ausgegeben werden kann. Möglich ist auch die Ausgabe von versteckten Links.
Konstruktion
Hinweis zur Version 3
Die KolLinkGroup Komponente der Version 3 wurde als veraltet markiert (deprecated), da sie keinen wesentlichen Beitrag zur Verbesserung der Barrierefreiheit bietet.
Hinweis zum nav Tag
Die Verwendung des nav Tags wurde aus der KolLinkGroup Komponente entfernt, da er für die Barrierefreiheit leistet.
Code
<kol-link-group
_label="Einfache LinkGroup"
_links="[{'_label':'Link 1','_href':'https://www.w3.org'},{'_label':'Link 2','_href':'https://www.w3.org'},{'_label':'Link 3','_href':'https://www.w3.org'}]"
_list-style-type="disc"
_orientation="'vertical"
></kol-link-group>
Beispiel
Verwendung
Links
Die auszugebenden Links werden als JSON-Objekt an das Attribut _links übergeben. Dort können die Attribute des _href und _label sind jedoch Pflicht.
[
{ _label: 'Link 1', _href: 'https://www.w3.org' },
{ _label: 'Link 2', _href: 'https://www.w3.org' },
{ _label: 'Link 3', _href: 'https://www.w3.org' },
];
Ausrichtung
Über das Attribut _orientation kann die Ausrichtung der LinkGroup bestimmt werden. Mögliche Werte sind horizontal und vertical (Standard).
List-Style-Type
Über das Attribut _list-style-type kann bestimmt werden, mit welchem Symbol die einzelnen Zeilen der Group dargestellt werden sollen. Es stehen diese vier Möglichkeiten zur Auswahl:
disccirclesquarenone
Anwendungsfälle
LinkGroup innerhalb eines Fließtextes
Lorem, ipsum dolor sit amet consectetur adipisicing elit. Ea optio deleniti fuga quos molestias, voluptate nobis nemo, incidunt excepturi facilis, amet ducimus minus quae corporis eligendi cum distinctio. Fugit, repellendus.
Lorem, ipsum dolor sit amet consectetur adipisicing elit. Ea optio deleniti fuga quos molestias, voluptate nobis nemo, incidunt excepturi facilis, amet ducimus minus quae corporis eligendi cum distinctio. Fugit, repellendus.
Barrierefreiheit
Tastatursteuerung
| Taste | Funktion |
|---|---|
Tab | Fokussiert das erste Element der LinkGroup. |
Enter | Ruft den hinterlegten Link auf. |
Properties
| Property | Attribute | Description | Type | Default |
|---|---|---|---|---|
_label | _label | Defines the visible or semantic label of the component (e.g. aria-label, label, headline, caption, summary, etc.). | string | undefined | undefined |
_links (required) | _links | Defines the list of links to render. | LinkProps[] | string | undefined |
_listStyleType | _list-style-type | Gibt den List-Style-Typen für ungeordnete Listen aus. Wird bei horizontalen LinkGroups als Trenner verwendet | "circle" | "decimal" | "decimal-leading-zero" | "disc" | "lower-alpha" | "lower-greek" | "lower-latin" | "lower-roman" | "none" | "square" | "upper-alpha" | "upper-latin" | "upper-roman" | undefined | undefined |
_orientation | _orientation | Defines whether the orientation of the component is horizontal or vertical. | "horizontal" | "vertical" | undefined | 'vertical' |