次の方法で共有

コマンド バーのカスタマイズ構文リファレンス

コマンド バーのカスタマイズは、特定の要件に合わせてリストをカスタマイズするのに役立ちます。 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'
'favoriteCommand'
'createCopilot'

🚀 commandBarCustomization キーの最近の更新

[注意] commandBarCustomization スキーマの一部のキーが更新されました。 カスタム フォーマッタが正しく動作するように、既存の JSON をこれらの新しいキーで更新できますか?

元のキー 現在のキー
new newComposite (ドキュメント ライブラリ)
upload uploadCommand
sync syncCommand
addShortcut addShortcutToOneDriveCommand
pinToQuickAccess PinToQuickAccessCommand
pinItem pinItemCommand
properties propertiesCommand

非表示にする

特定のコマンドを非表示にする条件を指定するオプションのプロパティ。 このプロパティの値は、ブール値、文字列、または式オブジェクトのいずれかです。 false が既定の動作です (コマンドが表示されることを意味します)。 true は、コマンドが非表示になることを意味します。

text

コマンドの名前として表示するテキストを指定するオプションのプロパティ。 このプロパティの値は、文字列または式オブジェクトのいずれかです。 値が指定されていない場合は、コマンドの既定の名前が表示されます。

title

コマンドに表示されるツールヒントのテキストを指定するオプションのプロパティ。 このプロパティの値は、文字列または式オブジェクトのいずれかです。 値が指定されていない場合は、コマンドの既定のツールヒントが表示されます。

iconName

コマンドに表示される Fluent UI アイコンを指定するオプションのプロパティ。 このプロパティの値は、文字列または式オブジェクトのいずれかです。 値が指定されていない場合は、コマンドの既定のアイコンが表示されます。

primary

コマンドにプライマリ ボタンのスタイルを適用する条件を指定するオプションのプロパティ。 このプロパティの値は、ブール値、文字列、または式オブジェクトのいずれかです。 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 オブジェクトを指定できます。 値が指定されていない場合、コマンドは既定の位置に配置されます。 このプロパティは、ゼロベースのインデックス作成に従います。

sectionType

カスタマイズされたコマンドがコマンド バーに配置されるセクションを指定するオプションのプロパティ。 次の文字列は、このプロパティの有効な値です。

  • Primary
  • オーバーフローしました

次の例は、JSON を書式設定して次のことを行うサンプルのコマンド バーを示しています。

  • コマンド バーのプライマリ セクションの 3 番目の位置に [新規] コマンドを配置します。
  • コマンド バーのオーバーフロー メニューの 2 番目の位置に 'Share' コマンドを配置します。
  • コマンド バーのプライマリ セクションの 4 番目の位置に "Alert me" コマンドを配置します。
{
  "commandBarProps" : {
    "commands": [
      {
        "key": "new",
        "position": 2
      },
       {
        "key": "share",
        "position": 1,
        "sectionType": "Overflow"
      },
      {
        "key": "alertMe",
        "position": 3,
        "sectionType": "Primary"
      }
    ]
  }
}

selectionModes

コマンドのカスタマイズが適用される選択モードを指定するオプションのプロパティ。 値が指定されていない場合、カスタマイズは、コマンドが使用可能なすべての選択モードで適用されます。 このプロパティの値は、次の文字列が許可されている文字列の配列にすることができます。

  • NoSelection
  • SingleSelection
  • MultiSelection

次の例は、JSON を書式設定して次のことを行うサンプルのコマンド バーを示しています。

  • 選択したアイテムの 'NumberField' 列の値が 3 の場合は、[共有] コマンドのテキストを更新する
  • 複数のアイテムが選択されている場合にのみ、[削除] コマンドのテキストを更新します。
{
  "commandBarProps": {
    "commands": [
      {
        "key": "share",
        "selectionModes": [
          "SingleSelection"
        ],
        "text": "=if([$NumberField] == 3, 'Share item 3', 'Share')"
      },
      {
        "key": "delete",
         "selectionModes": [
          "MultiSelection"
        ],
        "text": "Delete multiple items"
      }
    ]
  }
}