Ссылка на синтаксис настройки панели команд

Настройка панели команд помогает персонализировать список в соответствии с определенными требованиями. Функция, основанная на JSON, позволяет вносить простые изменения в панель команд, в том числе изменять значок и/или текст, скрывать существующие возможности или менять положение команд.

commandBarProps

Параметры для настройки панели команд. Работает во всех типах макетов.

Команды

Массив объектов JSON, выделяющий команды для настройки.

ключа

Обязательное свойство для уникального определения команды в панели команд. Допустимые клавиши:

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

скрыть

Необязательное свойство, указывающее условие для сокрытия определенной команды. Значение этого свойства может быть логическим значением, строкой или объектом Expression. Значение false — это поведение по умолчанию (означает, что команда видима). true означает, что команда будет скрыта.

текст

Необязательное свойство, задающее текст, который выводится в качестве имени команды. Значение этого свойства может быть строкой или объектом Expression. Если значение не предоставлено, будет показано имя команды по умолчанию.

title

Необязательное свойство, задающее текст всплывающей подсказки, видимой для команды. Значение этого свойства может быть строкой или объектом Expression. Если значение не предоставлено, будет показана всплывающая подсказка команды по умолчанию.

iconName

Необязательное свойство, задающее значок пользовательского интерфейса Fluent, видимый для команды. Значение этого свойства может быть строкой или объектом Expression. Если значение не предоставлено, будет показан значок команды по умолчанию.

primary

Необязательное свойство, задающее условие применения основного стиля кнопки к команде. Значение этого свойства может быть логическим значением, строкой или объектом Expression. false – поведение по умолчанию (это означает, что будет применен стиль по умолчанию). true означает, что основной стиль кнопки будет применяться к команде только в том случае, если команда размещена на 0-й позиции в панели команд.

В следующем примере показан пример форматирования командной панели JSON, который выполняет следующее:

• Скрывает команду "Создать".
• Меняет текст и значок команды "Изменить в режиме просмотра в виде сетки" и добавляет к ней основной стиль кнопки.
• Удаляет значок из команды "Предоставить общий доступ" и меняет текст всплывающей подсказки.

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

position

Необязательное свойство, задающее положение команды в панели команд. Значение этого свойства может быть числом, строкой или объектом Expression. Если значение свойства не указано, команда будет помещена в положение по умолчанию. Индексация в этом свойстве начинается с 0.

sectionType

Необязательное свойство, задающее раздел в панели команд, в котором будет размещена настраиваемая команда. Для этого свойства допустимы следующие строки:

• Primary
• Переполнение

В следующем примере показан пример форматирования командной панели JSON, который выполняет следующее:

• Ставит команду "Создать" на третью позицию в основном разделе панели команд.
• Помещает команду "Предоставить общий доступ" на вторую позицию в меню переполнения панели команд.
• Ставит команду "Оповестить" на четвертую позицию в основном разделе панели команд.

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

selectionModes

Необязательное свойство, указывающее режимы выбора, в которых будет применяться настроенная команда. Если значение не указано, то настройка будет применяться во всех режимах выбора, в которых доступна данная команда. Значением этого свойства может быть массив строк, в котором разрешены следующие строки:

• NoSelection
• SingleSelection
• MultiSelection

В следующем примере показан пример форматирования командной панели JSON, который выполняет следующее:

• Меняет текст команды "Предоставить общий доступ", если выбранный элемент имеет значение 3 в столбце "NumberField"
• Меняет текст команды "Удалить", если выбрано несколько элементов.

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