Referência de sintaxe de personalização da barra de comandos

A personalização da barra de comandos ajuda a personalizar uma lista para atender a requisitos específicos. O recurso baseado em JSON permite alterações básicas na barra de comandos, incluindo modificação de ícone e/ou texto, ocultação de opções existentes ou comandos de reposicionamento.

commandBarProps

Propriedades para personalização da barra de comandos. Válido em todos os tipos de layouts.

comandos

Matriz de objetos JSON para especificar os comandos para personalização.

chave

Propriedade obrigatória para identificar exclusivamente um comando na barra de comandos. As chaves válidas incluem:

'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'

ocultar

Uma propriedade opcional que especifica a condição para ocultar um comando específico. O valor desta propriedade pode ser um booleano, cadeia de caracteres ou um objeto Expression. false é o comportamento padrão (o que significa que o comando é visível). true significa que o comando ficará oculto.

texto

Uma propriedade opcional que especifica o texto a ser exibido como o nome do comando. O valor dessa propriedade pode ser uma cadeia de caracteres ou um objeto Expression. Se o valor não for fornecido, o nome padrão do comando será mostrado.

title

Uma propriedade opcional que especifica o texto da dica de ferramenta a ser exibido no comando. O valor dessa propriedade pode ser uma cadeia de caracteres ou um objeto Expression. Se o valor não for fornecido, a dica de ferramenta padrão do comando será mostrada.

iconName

Uma propriedade opcional que especifica o ícone Interface do usuário do Fluent a ser exibido no comando. O valor dessa propriedade pode ser uma cadeia de caracteres ou um objeto Expression. Se o valor não for fornecido, o ícone padrão do comando será mostrado.

primário

Uma propriedade opcional que especifica a condição para aplicar o estilo do botão principal a um comando. O valor desta propriedade pode ser um booleano, cadeia de caracteres ou um objeto Expression. false é o comportamento padrão (o que significa que o estilo padrão será aplicado). true significa que o estilo do botão principal será aplicado ao comando somente se o comando for colocado na posição 0 na barra de comandos.

O exemplo a seguir mostra um exemplo de barra de comando formatando JSON para fazer o seguinte:

• Oculte o comando 'Novo',.
• Atualize o texto e o ícone do comando 'Editar no modo de exibição de grade' e adicione o estilo do botão principal a ele.
• Remova o ícone do comando 'Compartilhar' e atualize o texto da dica de ferramenta dele.

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

position

Uma propriedade opcional que especifica a posição onde o comando será colocado na barra de comandos. O valor desta propriedade pode ser um número, cadeia de caracteres ou um objeto Expression. Se o valor não for fornecido, o comando será colocado em sua posição padrão. Essa propriedade segue a indexação baseada em zero.

sectionType

Uma propriedade opcional que especifica a seção onde o comando personalizado será colocado na barra de comandos. As seguintes cadeias de caracteres são valores válidos para esta propriedade:

• Primário
• Transbordar

O exemplo a seguir mostra um exemplo de barra de comando formatando JSON para fazer o seguinte:

• Coloca o comando 'Novo' na terceira posição na seção principal da barra de comandos.
• Coloca o comando 'Compartilhar' na segunda posição no menu flutuante da barra de comandos.
• Coloca o comando 'Alertar-me' na quarta posição na seção primária da barra de comandos.

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

selectionModes

Uma propriedade opcional que especifica os modos de seleção nos quais a customização do comando será aplicada. Se o valor não for fornecido, a personalização será aplicada em todos os modos de seleção em que o comando estiver disponível. O valor desta propriedade pode ser uma matriz de cadeias de caracteres onde as seguintes strings são permitidas:

• Nenhuma seleção
• SingleSelection
• MultiSelection

O exemplo a seguir mostra um exemplo de barra de comando formatando JSON para fazer o seguinte:

• Atualize o texto do comando 'Compartilhar' se o item selecionado tiver o valor de coluna 'NumberField' 3
• Atualize o texto do comando 'Excluir' somente se vários itens estiverem selecionados.

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