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 keinen Beitrag 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:
disc
circle
square
none
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' |