Control Nav

Un control que s'utilitza per proporcionar navegació.

Nota

Trobareu la documentació completa i el codi font al dipòsit de components de codi de GitHub.

Descripció

Una subfinestra de navegació (Nav) proporciona enllaços a les àrees principals d'una aplicació o d'un lloc.

El component de codi Nav permet utilitzar el component de menú de la Fluent UINav des de les aplicacions del llenç i les pàgines personalitzades.

Nota

Trobareu el codi font del component i informació addicional al dipòsit de components de codi de GitHub.

Propietats

Propietats de la clau

Propietat	Descripció
Selected key	La clau que se selecciona. S'actualitzarà mitjançant la incidència OnChange quan l'usuari interactuï amb el control.
Items	Obligatori. La taula d'elements de font de dades que voleu representar.
Fields	Obligatori. Els camps inclosos al conjunt de dades.

Propietats dels Items

Cada element utilitza l'esquema següent per visualitzar les dades del component.

Nom	Descripció
ItemDisplayName	El nom de visualització de l'element command/tab/menu
ItemKey	La clau que s'utilitza per indicar quin element se selecciona i quan s'afegeixen subelements. Les claus han de ser úniques.
ItemEnabled	Es defineix com a fals si l'opció està inhabilitada
ItemVisible	Es defineix com a fals si l'opció no és visible
ItemIconName	Icona de Fluent UI que s'utilitzarà (vegeu Icones de Fluent UI)
ItemIconColor	El color per representar la icona (per exemple, valor de nom, rgb o hexadecimal)
ItemIconOnly	No es mostra a l'etiqueta del text, només la icona
ItemParentKey	Representar l'opció com a element secundari d'una altra opció
ItemExpanded	Definir com a fals o cert si el grup s'ha de mantenir reduït o expandit, respectivament.

Exemple:

Table(
  {
      ItemKey: "1",
      ItemDisplayName: "Home with Icon & Custom color",
      ItemIconName: "Home",
      ItemIconColor: "Green"
  },
  {
      ItemKey: "2",
      ItemDisplayName: "Documents",
      ItemExpanded: true
  },
  {
      ItemKey: "3",
      ItemDisplayName: "Contents"
  },
  {
      ItemKey: "4",
      ItemDisplayName: "Item Invisible",
      ItemVisible: false
  },
  {
      ItemKey: "5",
      ItemDisplayName: "Quick Reference Guide",
      ItemParentKey: "3",
      ItemIconName: "Document"
  }
)

Propietats d'estil

Propietat	Descripció
Theme	Accepta una cadena JSON generada mitjançant el Fluent UI Theme Designer (windows.net). Deixant aquest camp en blanc s'utilitzarà el tema per defecte definit per Power Apps. Per obtenir ajuda sobre com s'ha de configurar, vegeu temes.
AccessibilityLabel	Etiqueta aria de lector de pantalla
CollapseByDefault	Definir com a Cert o Fals (activat o desactivat) si tot el grup de Nav s'ha de mantenir reduït o expandit, respectivament. Es respecta la propietat d'expandir el nivell d'element individual.

Propietats de l'esdeveniment

Propietat	Descripció
InputEvent	Una incidència que s'enviarà al control. per exemple, SetFocus. Vegeu sota.

Comportament

Admet SetFocus com un InputEvent.

Configurar el comportament en seleccionar

Utilitzeu la fórmula Commuta () a la propietat OnSelect del component per configurar accions específiques per a cada element fent referència a l'estat seleccionat del control ItemKey com a valor de commutació.

Substituïu els valors false per expressions adequades en el llenguatge Power Fx.

  Switch( Self.Selected.ItemKey,

    /* Action for ItemKey 1 */
    "1", false,

    /* Action for ItemKey 2 */
    "2", false,

    /* Action for ItemKey 3 */
    "3", false,

    /* Action for ItemKey 4 */
    "4", false,

    /* Action for ItemKey 5 */
    "5", false,

    /* Default action */
        false
  )

Establir el focus al control

Quan es mostra un diàleg nou i l'enfocament per defecte hauria d'estar al control, es necessitarà un enfocament definit explícit.

Per fer crides a la incidència d'entrada, podeu definir una variable de context enllaçada amb la propietat Incidència d'entrada a una cadena que comença amb SetFocus i va seguida d'un element aleatori per assegurar-vos que l'aplicació la detecta com un canvi.

Per exemple,

UpdateContext({ctxResizableTextareaEvent:"SetFocus" & Text(Rand())}));

La variable de context ctxResizableTextareaEvent s'enllaçarà amb la propietat Input Event.

Limitacions

Aquest codi del llenç només es pot utilitzar a les aplicacions del llenç i a les pàgines personalitzades.