enes

Tree View Experimental

Tree View muestra datos jerárquicos en una lista anidada donde cada elemento puede expandirse, marcarse o seleccionarse. Los elementos se componen con los componentes TreeViewItem y TreeViewItemContent; el árbol no acepta una propiedad data.

  • Fruits
    • Apple
    • Banana
  • Vegetables

Uso

<script>
	import { TreeView, TreeViewItem, TreeViewItemContent } from 'fluentui-svelte';
</script>

<TreeView selectionMode="multiple">
	<TreeViewItem id="fruits" type="branch">
		<TreeViewItemContent>Fruits</TreeViewItemContent>
		<TreeView>
			<TreeViewItem id="apple">
				<TreeViewItemContent>Apple</TreeViewItemContent>
			</TreeViewItem>
			<TreeViewItem id="banana" disabled>
				<TreeViewItemContent>Banana</TreeViewItemContent>
			</TreeViewItem>
		</TreeView>
	</TreeViewItem>
	<TreeViewItem id="vegetables">
		<TreeViewItemContent>Vegetables</TreeViewItemContent>
	</TreeViewItem>
</TreeView>

Anidar un TreeView dentro de un TreeViewItem de tipo='branch' crea un subárbol. Usa openItems / checkedItems en el TreeView raíz (bindable) para controlar programáticamente el estado abierto y marcado.

Checkable Items

Set selectionMode="multiple" to render checkboxes on selectable items.

  • Fruits
    • Apple
    • Banana

Controlling Open and Checked State

Use the bindable openItems and checkedItems props on the root TreeView to control state programmatically.

  • Fruits
    • Apple
    • Banana

Propiedades del componente (TreeView)

NameTypeDefaultDescription
ref bindableHTMLUListElementLa referencia del DOM del elemento árbol.
size'small' | 'medium' | 'large''medium'El tamaño de cada item del árbol.
navigationMode'tree' | 'treegrid''tree'Si el árbol ocupa una sola parada de tabulación, o cada fila es alcanzable por su cuenta.
onOpenChange(e: Event, openItems: string[]) => voidSe llama cada vez que una rama se abre o se cierra.
selectionMode'single' | 'multiple''multiple'Cuántos items se pueden marcar a la vez.
onCheckedChange(e: Event, checkedItems: string[]) => voidSe llama cada vez que un item se marca o se desmarca.
virtualizerTreeViewVirtualizerPuente hacia una librería de virtualización. Solo el tramo de items renderizado vive en el DOM.
openItems bindablestring[] | SvelteSet<string>Los ids de las ramas abiertas. Se requiere un `SvelteSet` cuando hay un `virtualizer`.
checkedItems bindablestring[] | SvelteSet<string>Los ids de los items marcados. Se requiere un `SvelteSet` cuando hay un `virtualizer`.
childrenSnippetLos items del árbol.
TreeViewVirtualProps | TreeViewStaticProps
Element Attributes (ul)

Propiedades del componente (TreeViewItem)

NameTypeDefaultDescription
idstringEl id del item, que el árbol usa para seguir su estado. Si no se indica, se genera uno.
type'item' | 'branch''item'Si el item contiene hijos y, por tanto, se puede abrir.
refHTMLLIElementLa referencia del DOM del elemento item.
valuestring | numberidEl valor que reportan los eventos del árbol. Si no se indica, se usa el id del item.
textstringLa etiqueta del item, que usa la navegación por escritura.
openbooleanSi la rama está abierta.
checkedbooleanSi el item está marcado.
indeterminatebooleanRenderiza el checkbox en su estado mixto, cuando solo algunos hijos están marcados.
disabledbooleanDeshabilita la interacción del usuario.
indexnumberEl índice real del item dentro del conjunto de datos. Obligatorio cuando el árbol está virtualizado.
onOpenChange(e: Event, data: { id: string; open: boolean }) => voidSe llama cuando esta rama se abre o se cierra.
onCheckedChange(e: Event, data: { id: string; checked: boolean }) => voidSe llama cuando este item se marca o se desmarca.
Element Attributes (li)

Propiedades del componente (TreeViewItemContent)

NameTypeDefaultDescription
refHTMLDivElementLa referencia del DOM del elemento de layout.
expandIconSnippet | ComponentIcono personalizado para el control que abre una rama.
iconBeforeSnippet | ComponentContenido que se renderiza antes de la etiqueta.
iconAfterSnippet | ComponentContenido que se renderiza después de la etiqueta.
asideSnippet | ComponentContenido fijado al final de la fila.
actionsSnippet | ComponentContenido fijado al final de la fila, que se revela al pasar el puntero y al recibir el foco.
Element Attributes (div)