Verwenden von Webparts in der Spalte mit voller Breite

Moderne SharePoint-Seiten unterstützen Layouts, mit denen Benutzer die Informationen, die sie auf ihren Seiten präsentieren, organisieren können. Benutzer können aus einer Reihe von verschiedenen Layouts von Abschnitten wählen, z. B. zwei Spalten, drei Spalten oder ein Drittel einer Spalte. Moderne Seiten auf Kommunikationswebsites bieten ein zusätzliches Layout von Abschnitten Namens Spalte mit voller Breite. Dieses Layout umfasst die volle Breite der Seite ohne horizontalen Rand oder Abstand. SharePoint-Framework-Webparts können in jedem beliebigen Layout platziert werden, aber aufgrund der zusätzlichen Anforderungen müssen Webparts die Unterstützung für die Spalte mit voller Breite explizit aktivieren.

Layoutanforderungen für die Spalte mit voller Breite

Eine Sache, die reguläre Layouts auf modernen SharePoint-Seiten teilen, ist die maximale Breite. Um die einfache Lesbarkeit und Benutzerfreundlichkeit zu gewährleisten, wird der Text einer modernen Seite nicht über eine bestimmte Breite hinaus erweitert. Beim Erstellen von Webparts, die in regulären Layouts verwendet werden, testen Sie die Breite Ihres Webparts mit den bekannten Einschränkungen für maximale und minimale Breite, um sicherzustellen, dass sie ordnungsgemäß angezeigt werden.

Bei der Arbeit mit dem Spaltenlayout voller Breite werden die Dinge aber etwas komplizierter, da dieses Layout auf die volle Breite der Seite erweitert wird. Wenn sie auf einem extrem großen Monitor angezeigt wird, könnte die Spalte voller Breite auch einige tausend Pixel breit werden. Dies führt zu zusätzlichen Testanforderungen, die Sie beim Erstellen von Webparts berücksichtigen sollten, die in der Spalte mit voller Breite verwendet werden können.

Aktivieren der Unterstützung für die Spalte mit voller Breite

Standardmäßig können clientseitige SharePoint-Framework-Webparts nicht in Spaltenlayouts voller Breite platziert werden. Damit Benutzer Ihr Webpart Spalten mit voller Breite hinzufügen können, legen Sie im Webpartmanifest (die Datei *.manifest.json neben der Datei *.ts des Webparts) die supportsFullBleed Eigenschaft auf fest true.

{
  //...

  "requiresCustomScript": false,
  "supportsFullBleed": true,

  "preconfiguredEntries": [{
    //...
  }]
}

Ist diese Einstellung aktiviert, wird Ihr Webpart beim Bearbeiten einer Seite mit Spaltenlayout voller Breite unter den Webparts angezeigt, die der Spalte hinzugefügt werden können.

Hinweis

Die SharePoint Workbench unterstützt das Testen von Webparts im Spaltenlayout mit voller Breite nicht. Stattdessen müssen Sie Ihr Webpart in einem Entwicklermandanten bereitstellen, eine Kommunikationswebsite erstellen und ihr Webpart dort testen.