A list is a stylized container used to vertically group a series of related content.
List supports two main variants:
Attribute | Description |
---|---|
daff-list |
A standard list used for grouping generic content. |
daff-nav-list |
A navigation list intended for use with anchor elements (<a> ). |
To use list in a standalone component, import each list type directly into your custom component.
Available imports:
DAFF_LIST_COMPONENTS
DAFF_NAV_LIST_COMPONENTS
import { DAFF_LIST_COMPONENTS } from '@daffodil/design/list';
@Component({
selector: 'custom-component',
templateUrl: './custom-component.component.html',
imports: [
DAFF_LIST_COMPONENTS,
],
})
export class CustomComponent {}
To use list in a module, import DaffListModule
into your custom module:
import { NgModule } from '@angular/core';
import { DaffListModule } from '@daffodil/design/list';
import { CustomComponent } from './custom.component';
@NgModule({
declarations: [
CustomComponent,
],
exports: [
CustomComponent,
],
imports: [
DaffListModule,
],
})
export class CustomComponentModule { }
This method is deprecated. It's recommended to update all custom components to standalone.
A list consists of the following components:
<daff-list>
: A standard list wrapper used for grouping generic content items.
<daff-nav-list>
: A navigation list container intended for use with anchor elements (<a>
).
<daff-list-item>
: Individual list items that contain the content for each row in the list.
<daff-list>
<daff-list-item>Content item</daff-list-item>
<daff-list-item>Content item</daff-list-item>
<daff-list-item>Content item</daff-list-item>
</daff-list>
<daff-nav-list>
<a href="/" daff-list-item>Navigation link</a>
<a href="/" daff-list-item>Navigation link</a>
<a href="/" daff-list-item>Navigation link</a>
</daff-nav-list>
Use the [daffPrefix]
element to display a leading visual icon for a list item.
For list items that contain multiple lines of text, use the [daffListItemTitle]
element to identify the primary title. Additional supporting content can be added using <div>
or <p>
elements.
By default, list includes appropriate ARIA roles by default to support screen readers and provide an accessible experience.
<daff-list>
is assigned role="list"
to identify a list of items.<daff-list-item>
within a <daff-list>
is assigned role="listitem"
to identify a list item contained inside the list.<daff-nav-list>
is assigned role="navigation"
to indicate that the list is used for navigation.Always provide an accessible label for
<daff-nav-list>
viaaria-label
oraria-labelledby
to describe its purpose (e.g."Footer links"
or"Sidebar links"
).