ListView Beta
ListView es un componente para renderizar un conjunto de elementos apilados verticalmente. Estos elementos pueden recibir foco, seleccionarse, tener una acción principal y una o más acciones secundarias, y admitir navegación por teclado y características de accesibilidad.
Uso
<script>
import { ListView, ListViewItem } from 'fluentui-svelte';
let list = ['A', 'B', 'C'];
let selected = ['A'];
</script>
<ListView selectedItems={selected}>
{#each list as item (item)}
<ListViewItem value={item}>{item}</ListViewItem>
{/each}
</ListView> Navigation Mode
Esta opción te permite configurar la navegación por teclado según tus necesidades. Para datos solo de visualización, no necesitas establecerla a menos que los elementos realicen alguna acción. Si tus elementos tienen varios elementos interactivos dentro de ListViewItem, como botones o menús, puedes establecerla en composite.
Selection Mode
Use selectionMode (single, multiselect, or extended) to control how items are selected.
Checkmark
Agrega y configura una casilla de verificación para el elemento. Puedes usar las mismas propiedades para el componente Checkbox .
Nota: cada elemento interactivo dentro de este ListViewItem debe llamar a e.stopPropagation().
Propiedades de ListView
| Name | Type | Default | Description |
|---|---|---|---|
selectionMode | 'none' | 'single' | 'multiselect' | 'extended' | 'none' | Cuántos items se pueden seleccionar, y cómo se realiza la selección. |
navigationMode | 'items' | 'composite' | 'items' | Si la lista ocupa una sola parada de tabulación, o cada item ocupa la suya. |
selectedItems bindable | string[] | Los valores de los items seleccionados. | |
shape | 'circular' | 'rounded' | 'square' | 'rounded' | Los items pueden tener forma circular, redondeada o cuadrada. |
onSelectionChange | (e: Event, selectedItems: string[] | []) => void | Se llama cada vez que cambia la selección. | |
as | 'ul' | 'ol' | 'div' | 'ul' | El elemento HTML con el que se renderiza la lista. |
ref bindable | HTMLUListElement | HTMLOListElement | HTMLDivElement | La referencia del DOM del elemento lista. | |
disableTabspot | boolean | false | Deja la lista fuera de la gestión de foco de tabspot, para conectar la tuya propia. |
| HTML Attributes |
Propiedades de ListViewItem
| Name | Type | Default | Description |
|---|---|---|---|
as | 'li' | 'a' | 'div' | 'li' | El elemento HTML con el que se renderiza el item. |
shape | 'circular' | 'rounded' | 'square' | El item puede tener forma circular, redondeada o cuadrada. Por defecto se hereda de la lista. | |
value | string | El valor que se reporta a la lista cuando se selecciona el item. Si no se indica, se genera un id. | |
active | boolean | Renderiza el elemento en su estado pulsado. | |
role | 'treeitem' | 'menuitem' | 'option' | 'row' | El rol ARIA del item. Por defecto se deriva de la lista. | |
disabled | boolean | Deshabilita la interacción del usuario. | |
checkmark | CheckboxProps | Las props que se aplican al checkbox que se renderiza cuando la lista es multiselect. | |
onAction | (e: MouseEvent, value: string) => void | Se llama cuando el item recibe un clic o se activa con el teclado. | |
onfocus | (e: Event, value: string) => void | Se llama cuando el item recibe el foco. | |
ref bindable | HTMLLIElement | HTMLAnchorElement | HTMLDivElement | La referencia del DOM del elemento item. | |
| HTML Attributes |
