Referencia de sintaxis de personalización de la barra de comandos

La personalización de la barra de comandos ayuda a personalizar una lista para satisfacer requisitos específicos. La característica basada en JSON permite cambios básicos en la barra de comandos, incluida la modificación del icono o texto, ocultar las opciones existentes o cambiar la posición de los comandos.

commandBarProps

Propiedades para la personalización de la barra de comandos. Válido en todos los tipos de diseño.

Comandos

Matriz de objetos JSON para especificar los comandos para la personalización.

clave

Propiedad obligatoria para identificar de forma única un comando en la barra de comandos. Las claves válidas incluyen:

'new'
'newFolder'
'newWordDocument'
'newExcelWorkbook'
'newPowerPointPresentation'
'newOneNoteNotebook'
'newFormsForExcel'
'newVisioDrawing'
'upload'
'uploadFile'
'uploadFolder'
'open'
'share'
'copyLink'
'download'
'rename'
'copyTo'
'moveTo'
'delete'
'edit'
'comment'
'editNewMenu'
'powerBI'
'powerBIVisualizeList'
'automate'
'automateCreateRule'
'automateManageRules'
'powerAutomate'
'powerAutomateCreateFlow'
'powerAutomateSeeFlows'
'powerAutomateConfigureFlows'
'aiBuilderCreate'
'aiBuilderGoto'
'aiBuilder'
'alertMe'
'newLink'
'integrate'
'manageAlert'
'powerApps'
'powerAppsCreateApp'
'powerAppsSeeAllApps'
'powerAppsCustomizeForms'
'viewDocumentUnderstandingModels'
'versionHistory'
'openInImmersiveReader'
'classifyAndExtract'
'checkOut'
'checkIn'
'undoCheckOut'
'properties'
'pinItem'
'exportExcel'
'exportCSV'
'export'
'editInGridView'
'exitGridView'
'sync'
'uploadTemplate'
'addTemplate'
'openInOfficeOnline'
'openInOfficeClient'
'addShortcut'
'pinToQuickAccess'
'unpinFromQuickAccess'
'manageForms'

ocultar

Propiedad opcional que especifica la condición para ocultar un comando determinado. El valor de esta propiedad puede ser un valor booleano, una cadena o un objeto de expresión. false es el comportamiento predeterminado (lo que significa que el comando es visible). true significa que el comando estará oculto.

text

Propiedad opcional que especifica el texto que se va a mostrar como nombre del comando. El valor de esta propiedad puede ser una cadena o un objeto de expresión. Si no se proporciona el valor, se mostrará el nombre predeterminado del comando.

title

Propiedad opcional que especifica el texto de información sobre herramientas que se va a mostrar en el comando. El valor de esta propiedad puede ser una cadena o un objeto de expresión. Si no se proporciona el valor, se mostrará la información sobre herramientas predeterminada del comando.

iconName

Propiedad opcional que especifica el icono Fluent UI que se mostrará en el comando. El valor de esta propiedad puede ser una cadena o un objeto de expresión. Si no se proporciona el valor, se mostrará el icono predeterminado del comando.

principal

Propiedad opcional que especifica la condición para aplicar el estilo del botón principal a un comando. El valor de esta propiedad puede ser un valor booleano, una cadena o un objeto de expresión. false es el comportamiento predeterminado (lo que significa que se aplicará el estilo predeterminado). true significa que el estilo del botón principal se aplicará al comando solo si el comando se ubica en la posición 0 de la barra de comandos.

En el ejemplo siguiente se muestra un formato JSON de la barra de comandos para hacer lo siguiente:

• Ocultar el comando "Nuevo".
• Actualice el texto y el icono del comando "Editar en la vista de cuadrícula" y agréguele el estilo del botón principal.
• Quite el icono del comando "Compartir" y actualice el texto de la información sobre herramientas.

{
  "commandBarProps" : {
    "commands": [
      {
        "key": "new",
        "hide": true
      },
      {
        "key": "editInGridView",
        "text": "Quick edit",
        "iconName": "EditTable",
        "primary": true
      },
      {
        "key": "share",
        "iconName": "",
        "title": "Share this List"
      }
    ]
  }
}

position

Propiedad opcional que especifica la posición donde se colocará el comando en la barra de comandos. El valor de esta propiedad puede ser un número, una cadena o un objeto de expresión. Si no se proporciona el valor, el comando se colocará en su posición predeterminada. Esta propiedad sigue la indexación de base cero.

sectionType

Propiedad opcional que especifica la sección donde se colocará el comando personalizado en la barra de comandos. Las siguientes cadenas son valores válidos para esta propiedad:

• Principal
• Desbordamiento

En el ejemplo siguiente se muestra un formato JSON de la barra de comandos para hacer lo siguiente:

• Coloca el comando "New" en la tercera posición de la sección principal de la barra de comandos.
• Coloca el comando "Compartir" en la segunda posición del menú de desbordamiento de la barra de comandos.
• Coloca el comando "Enviarme alertas" en la cuarta posición de la sección principal de la barra de comandos.

{
  "commandBarProps" : {
    "commands": [
      {
        "key": "new",
        "position": 2
      },
       {
        "key": "share",
        "position": 1,
        "sectionType": "Overflow"
      },
      {
        "key": "alertMe",
        "position": 3,
        "sectionType": "Primary"
      }
    ]
  }
}

selectionModes

Propiedad opcional que especifica los modos de selección en los que se aplicará la personalización de comandos. Si no se proporciona el valor, la personalización se aplicará en todos los modos de selección en los que el comando está disponible. El valor de esta propiedad puede ser una matriz de cadenas donde se permiten las cadenas siguientes:

• NoSelection
• SingleSelection
• MultiSelection

En el ejemplo siguiente se muestra un formato JSON de la barra de comandos para hacer lo siguiente:

• Actualice el texto del comando "Compartir" si el elemento seleccionado tiene el valor 3 de la columna "NumberField".
• Actualice el texto del comando "Delete" solo si se seleccionan varios elementos.

{
  "commandBarProps": {
    "commands": [
      {
        "key": "share",
        "selectionModes": [
          "SingleSelection"
        ],
        "text": "=if([$NumberField] == 3, 'Share item 3', 'Share')"
      },
      {
        "key": "delete",
         "selectionModes": [
          "MultiSelection"
        ],
        "text": "Delete multiple items"
      }
    ]
  }
}