@coconut-software/ui
Version:
React components for faster and easier web development.
34 lines (33 loc) • 1.19 kB
TypeScript
import type { AriaAttributes, PropsWithChildren, ReactNode } from 'react';
import type { ListNestedLevel } from './ListContext';
export interface ListProps {
/**
* Accessible label for the list.
* Only use if further context is needed and/or subheader is not present
*/
'aria-label'?: AriaAttributes['aria-label'];
/**
* List items to be rendered within the list
*/
children?: ReactNode | ReactNode[];
/**
* If true, reduces vertical padding for a more compact appearance
* @default false
*/
dense?: boolean;
/**
* The nesting level of the list: None=0, One=1, Two=2, Three=3, Four=4. Used for visual indentation
* @default 0
*/
nested?: ListNestedLevel;
/**
* Optional header text displayed above the list.
* If the header is not present, you may provide an `aria-label` for accessibility
*/
subheader?: ReactNode;
}
declare function List({ 'aria-label': label, children, dense, nested, subheader, }: PropsWithChildren<ListProps>): JSX.Element | null;
declare namespace List {
var Item: typeof import("./Item").default;
}
export default List;