enes

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.

  • Chile
  • Colombia
  • Dominican Republic
  • Costa Rica
  • Venezuela

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>

Mejores prácticas

Consulta List para conocer las mejores prácticas.

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.

  • Apple
  • Banana
  • Cherry

Checkmark

Agrega y configura una casilla de verificación para el elemento. Puedes usar las mismas propiedades para el componente Checkbox .

  • Card Content Inside ListItem
  • Nota: cada elemento interactivo dentro de este ListViewItem debe llamar a e.stopPropagation().

    Propiedades de ListView

    NameTypeDefaultDescription
    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 bindablestring[]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[] | []) => voidSe llama cada vez que cambia la selección.
    as'ul' | 'ol' | 'div''ul'El elemento HTML con el que se renderiza la lista.
    ref bindableHTMLUListElement | HTMLOListElement | HTMLDivElementLa referencia del DOM del elemento lista.
    disableTabspotbooleanfalseDeja la lista fuera de la gestión de foco de tabspot, para conectar la tuya propia.
    HTML Attributes

    Propiedades de ListViewItem

    NameTypeDefaultDescription
    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.
    valuestringEl valor que se reporta a la lista cuando se selecciona el item. Si no se indica, se genera un id.
    activebooleanRenderiza el elemento en su estado pulsado.
    role'treeitem' | 'menuitem' | 'option' | 'row'El rol ARIA del item. Por defecto se deriva de la lista.
    disabledbooleanDeshabilita la interacción del usuario.
    checkmarkCheckboxPropsLas props que se aplican al checkbox que se renderiza cuando la lista es multiselect.
    onAction(e: MouseEvent, value: string) => voidSe llama cuando el item recibe un clic o se activa con el teclado.
    onfocus(e: Event, value: string) => voidSe llama cuando el item recibe el foco.
    ref bindableHTMLLIElement | HTMLAnchorElement | HTMLDivElementLa referencia del DOM del elemento item.
    HTML Attributes