Freigeben über

Hinzufügen eines Webpart-Zonenausschnitts in SharePoint

  • Artikel

Wichtig

Diese Erweiterbarkeitsoption ist nur für klassische SharePoint-Oberflächen verfügbar. Sie können diese Option nicht mit modernen Benutzeroberflächen in SharePoint Online, wie z. B. mit Kommunikationswebsites, verwenden. Es wird davon abgeraten, klassische Benutzeroberfläche oder Brandingmethoden mehr zu verwenden.

Eine Webpartzone ist ein Ausschnitt, den Sie einem Seitenlayout hinzufügen können, damit Inhaltsautoren Webparts in dieser Zone hinzufügen, bearbeiten und löschen können.

Einführung in den Codeausschnitt "Webpartzone"

Ein Webpart ist ein Serversteuerelement, das eine bestimmte SharePoint-Funktionalität bereitstellt, und eine Webpartzone ist ein Container, der das Layout, das Verhalten und andere Eigenschaften der in dieser Zone enthaltenen Webparts bestimmt. Eine Webpartzone kann beispielsweise angeben, ob die Webparts in der Zone:

  • mit einem horizontalen oder vertikalen Layout angeordnet werden.
  • gemeinsame Benutzeroberflächenelemente wie Titelleiste oder Rand aufweisen.
  • von Inhaltsautoren angepasst werden können, wenn diese eine Seite im Browser bearbeiten.
  • von Websitebesuchern individuell angepasst werden können, die bei der Anzeige einer Seite im Browser eine persönliche Ansicht erstellen können.

Inhaltsautoren mit den erforderlichen Berechtigungen können in einer Veröffentlichungssite erstellen oder Bearbeiten von Seiten, die sich in der Bibliothek für Seiten befinden. Als Designer können Sie einem Seitenlayout eine Webpartzone hinzufügen. Wenn ein Inhaltsautor eine Seite basierend auf diesem Seitenlayout erstellt oder bearbeitet, kann der Autor Webparts in dieser Zone hinzufügen, bearbeiten oder löschen. Beispielsweise können Sie einem Seitenlayout eine Webpartzone hinzufügen, damit Inhaltsautoren:

  • Zeigen Sie die Ergebnisse einer Suchabfrage mithilfe eines Inhaltssuche-Webparts an. Autoren können die Suchabfrage aktualisieren oder ändern, wenn sich ein suchgesteuertes Webpart in einer Webpartzone befindet.
  • Einbetten von Video- oder Audioclips in eine Webseite mithilfe eines Medienwebparts.
  • Erstellen von Listen mit Hyperlinks, die mit einem Hyperlinkübersicht-Webpart mühelos bearbeitet, gruppiert oder neu angeordnet werden können.
  • Erstellen einer Siteübersicht mit allen Seiten einer Website, die automatisch aktualisiert wird, wenn eine Seite mit einem Inhaltsverzeichnis-Webpart hinzugefügt, gelöscht, umbenannt oder entfernt wird.

Verwendung von Webpartzonen

Wenn ein Seitenlayout eine oder mehrere Webpartzonen enthält, sind die Webpartzonen auf allen Seiten verfügbar, die dieses Layout verwenden, sodass Autoren Webparts auf diesen Seiten einfügen können. Wenn Sie Autoren das Einfügen von Webparts auf Seiten ermöglichen, verringern Sie die Kontrolle über die Benutzerfreundlichkeit der Website. Beispielsweise könnte ein Autor ein Inhaltsverzeichnis-Webpart auf eine Seite einfügen, die Teile Ihrer Website verfügbar macht, zu denen Besucher von der aktuellen Seite nicht navigieren sollen.

Wenn Sie die vollständige Kontrolle darüber haben möchten, wie ein Webpart auf Ihrer Website angezeigt wird, und wenn dieses Webpart auf allen Seiten eines bestimmten Typs angezeigt werden soll, fügen Sie das Webpart direkt einem Seitenlayout hinzu. Wenn ein Webpart auf allen Seiten einer Website angezeigt werden soll, können Sie ein Webpart auch direkt zu einer master Seite hinzufügen.

Hinweis

Webpartzonen stehen für Seitenlayouts, aber nicht für Gestaltungsvorlagen zur Verfügung. Zweck der Zonen ist es, Autoren das Ändern von Webparts zu erlauben, denn Autoren bearbeiten in der Regel keine Gestaltungsvorlagen.

Sie können einem Seitenlayout auch Webpartzonen hinzufügen, deren Verwendung jedoch einschränken. Beispielsweise können Sie einer Zone Webparts hinzufügen und dann eine Eigenschaft dieser Zone festlegen, sodass Inhaltsautoren die Eigenschaften vorhandener Webparts bearbeiten können, aber keine Webparts aus der Zone hinzufügen oder daraus entfernen können. Webpartzonen verfügen über eine Reihe von Eigenschaften, die einem doppelten Zweck dienen. Sie können eine Teilmenge von Eigenschaften verwenden, um das Layout und Format von Webparts auf der Seite zu organisieren. Sie können eine weitere Teilmenge der Eigenschaften verwenden, um eine zusätzliche Schutzebene vor Änderungen (oder "Sperren") der Webparts innerhalb der Zone bereitzustellen.

Sie haben folgende Möglichkeiten, die Darstellung von Webparts auf Ihrer Website zu steuern:

  • Fügen Sie Webparts direkt zu einer master Seite oder einem Seitenlayout hinzu. Dies bedeutet, dass Inhaltsautoren die Webparts nicht ändern können.
  • Webparts zu Zonen in Seitenlayouts hinzufügen, doch diese Zonen ausschließlich auf die Standardwebparts beschränken, die Sie hinzufügen.
  • Webpartzonen zu Seitenlayouts hinzufügen und Inhaltsautoren die vollständige Kontrolle darüber geben, welche Webparts in diesen Zonen angezeigt und wie diese konfiguriert werden.

Mit den Eigenschaften einer Webpartzone kann angegeben werden, ob Inhaltsautoren Folgendes ändern dürfen:

  • Das Layout von Webparts in der Zone durch Hinzufügen, Löschen, Verschieben oder Verändern der Größe von Webparts.
  • Die Webparteinstellungen für alle Benutzer (die freigegebene Ansicht eines Webparts).
  • Die persönlichen Webparteinstellungen (die persönliche Ansicht eines Webparts).

Tabelle 1 zeigt wichtige Eigenschaften, die beim Einschränken einer Webpartzone berücksichtigt werden müssen.

Tabelle 1. Webpartzoneneigenschaften, die zum Einschränken von Inhaltsautoren verwendet werden

Eigenschaftenname Beschreibung
AllowLayoutChange Gibt an, ob Webparts innerhalb der Zone geschlossen, minimiert, gelöscht oder wiederhergestellt werden können. Bei Festlegung auf False können Benutzer Webparts in der Zone nicht schließen, minimieren, löschen oder wiederherstellen, Webparts in eine andere Zone ziehen oder Webparts innerhalb der Zone neu anordnen oder verschieben. Benutzer können auch keine Webparts aus dem Webpartkatalog hinzufügen, und mehrere Eigenschaften, die sich auf die Benutzeroberfläche von Webparts in der Zone auswirken, sind deaktiviert. Diese Eigenschaft wirkt sich nicht auf die Möglichkeit aus, das Layout programmgesteuert zu ändern. Bei Festlegung auf True können Benutzer mit den entsprechenden Berechtigungen diese Aktionen ausführen.
LockLayout Gibt an, ob Webparts innerhalb der Zone hinzugefügt, gelöscht, in der Größe geändert oder verschoben werden können. Diese Eigenschaft funktioniert unabhängig davon, ob sich die Webpartseite in der persönlichen oder freigegebenen Ansicht befindet. Wenn true festgelegt ist, sind die spezifischen Webparteigenschaften für jedes Webpart in der Zone, die betroffen sind: Zone (ZoneID), Part Order (PartOrder),Visible on Page (IsVisible), Height (Height), Width (Width), Allow Close (AllowRemove) und IsIncluded (der Befehl Schließen im Webpartmenü ). Andere Webparteigenschaften sind nicht betroffen. Bei Festlegung auf False bestimmen die Webparteigenschaften (gemeinsam mit den entsprechenden Websiteberechtigungen), ob Änderungen erfolgen dürfen.
AllowCustomization Gibt an, ob freigegebene Eigenschaftenwerte von Webparts innerhalb der Zone geändert werden können. Bei Festlegung auf True können Benutzer mit den entsprechenden Berechtigungen Änderungen an der Webparts in der Zone für alle Benutzer vornehmen. Bei Festlegung auf False können Benutzer auf der Benutzeroberfläche der freigegebenen Ansicht keine Änderungen an den Webparts in der Zone vornehmen. Änderungen können jedoch weiter programmgesteuert und über die Seite Webpartwartung erfolgen.
AllowPersonalization Gibt an, ob persönliche Eigenschaftenwerte von Webparts innerhalb der Zone geändert werden können. Bei Festlegung auf True können Benutzer mit den entsprechenden Berechtigungen persönliche Änderungen an den Webparts in der Zone vornehmen. Bei Festlegung auf False können Benutzer auf der Benutzeroberfläche keine persönlichen Änderungen vornehmen, es sei denn, das Webpart ist privat und sie verfügen über die benötigten Berechtigungen.

Hinweis

Sie können keine Webpartzone in einen Gerätekanalbereich einfügen. Wenn Sie zulassen möchten, dass Autoren Webparts zu einer Seite hinzufügen können, und wenn Sie sich keine Sorgen über die Seitengewichtung für mobile Geräte machen, können Sie ein Rich-Text-Editor-Seitenfeld in einen Gerätekanalbereich einfügen und dann die Autoren anweisen, Webparts dort hinzuzufügen. Sie können Webparts direkt zu einem Gerätekanalbereich (ohne eine Webpartzone) hinzufügen. Weitere Informationen finden Sie unter Vorgehensweise: Hinzufügen eines Ausschnitts für den Gerätekanalbereich in SharePoint.

Einfügen eines Webpartzone-Ausschnitts

Wie alle Codeausschnitte können Sie diesen Codeausschnitt aus dem Codeausschnittkatalog hinzufügen. Sie müssen zunächst ein zu bearbeitendes Seitenlayout auswählen, um zum Codeausschnittkatalog zu gelangen. Webpartzonen können Seitenlayouts hinzugefügt werden, können jedoch nicht master Seiten hinzugefügt werden.

So fügen Sie den Codeausschnitt "Webpartzone" ein

  1. Wechseln Sie zu Ihrer Veröffentlichungswebsite.

  2. Wählen Sie in der rechten oberen Ecke der Seite das Zahnradsymbol für Einstellungen und dann Entwurfs-Manager aus.

  3. Wählen Sie im Entwurfs-Manager im linken Navigationsbereich Seitenlayouts bearbeiten aus.

  4. Wählen Sie den Namen des Seitenlayouts aus, dem Sie den Codeausschnitt hinzufügen möchten.

  5. Wählen Sie zum Öffnen des Codeausschnittkatalogs in der serverseitigen Vorschau in der rechten oberen Ecke Codeausschnitte aus.

  6. Wählen Sie auf dem Menüband auf der Registerkarte Entwurf die Option Webpartzone aus.

  7. Im Codeausschnittkatalog können auf der rechten Seite auf Infos zu dieser Komponente klicken oder diese Option auswählen, um Eigenschaftengruppen ein- oder auszublenden, und anschließend die gewünschten benutzerdefinierten Einstellungen konfigurieren.

    Der Abschnitt Wichtig enthält die Eigenschaften, die bekannt sein müssen, um die Funktionsweise dieses bestimmten Codeausschnitts zu kennen. Für eine Webpartzone weist der Codeausschnitt eine eindeutige ID auf. Nachdem Sie den Codeausschnitt in Ihr Seitenlayout kopiert haben, dürfen Sie diese ID nicht wiederverwenden. Wenn Sie einen weiteren Webpartzonenausschnitt hinzufügen möchten, wählen Sie Aktualisieren aus, um eine neue ID für den nächsten Codeausschnitt zu generieren.

    Eine Beschreibung der Eigenschaften, die erforderlich sind, um eine Webpartzone einzuschränken (LockLayout, AllowCustomization und AllowPersonalization) finden Sie in Tabelle 1.

    Hinweis

    Möglicherweise stellen Sie fest, dass einige Eigenschaftennamen im Eigenschaftenraster des Codeausschnittkatalogs fett formatiert sind. Diese Eigenschaften verfügen über Werte, die gegenüber der Standardeinstellung für diese Komponente geändert wurden, aber diese Eigenschaften sind nicht notwendigerweise für ein Designerszenario relevant. Anders ausgedrückt: Eine Eigenschaft kann fett, aber nicht unbedingt wichtig für Ihr Szenario sein.

  8. Nachdem Sie Eigenschaften konfiguriert haben, wählen Sie Aktualisieren. Dadurch wird der HTML-Codeausschnitt links auf der Seite aktualisiert, sodass das Markup Ihre benutzerdefinierten Einstellungen widerspiegelt. Sie können stets Zurücksetzen wählen, um alle Eigenschaften auf ihre Standardeinstellungen zurückzusetzen.

  9. Wählen Sie links im Codeausschnittkatalog unter HTML-Codeausschnitt den Befehl In Zwischenablage kopieren.

  10. Öffnen Sie im HTML-Editor das zugeordnete Netzlaufwerk auf dem Computer, und öffnen Sie dann die HTML-Datei für die Gestaltungsvorlage oder das Seitenlayout, der bzw. dem Sie den Codeausschnitt hinzufügen.

    Weitere Informationen finden Sie unter Vorgehensweise: Zuordnen eines Netzlaufwerks zum SharePoint-Gestaltungsvorlagenkatalog.

  11. Fügen Sie den Codeausschnitt in der HTML-Datei an der Stelle ein, an der das Markup angezeigt werden soll.

    Wenn Sie den Codeausschnitt dem Seitenlayout hinzufügen, vergewissern Sie sich, dass Sie den Codeausschnitt innerhalb des PlaceHolderMain-Tags einfügen.

  12. Ersetzen Sie im <div>-Tag class="DefaultContentBlock" durch Ihren eigenen spezifischen Inhalt.

  13. Wenn Sie die Zone vorab mit Webparts auffüllen möchten, um z. B. festzulegen, dass Inhaltsautoren nur vorhandene Webparts ändern, aber keine neuen hinzufügen dürfen, fügen Sie Webpart-Codeausschnitte dort ein, wo das -Tag angezeigt wird.

  14. Speichern Sie die Seite, und aktualisieren Sie anschließend im Entwurfs-Manager die serverseitige Vorschau, um sicherzustellen, dass die Seite wie gewünscht angezeigt wird.

Grundlegendes zum Codeausschnittmarkup

Die beiden wichtigsten Teile eines Webpartzonenausschnitts sind die ID-Eigenschaft und der Kommentar. Jede Zone muss eine eindeutige ID haben. Wenn Sie Ihrem Seitenlayout mehr als eine Webpartzone hinzufügen möchten, stellen Sie sicher, dass Sie aktualisieren im Codeausschnittkatalog auswählen, bevor Sie jeden Codeausschnitt kopieren, damit eine neue ID generiert wird. Der Kommentar sollte durch alle Webparts ersetzt werden, die standardmäßig in der Zone angezeigt werden sollen.

Der folgende Code enthält weitere Eigenschaft zum Einschränken, wie Inhaltsautoren Zonen verwenden können ( AllowCustomization, AllowPersonalization und LockLayout).

Hinweis

Die Eigenschaften AllowCustomization, AllowPersonalization und LockLayout werden nur dann im Markup angezeigt, wenn Sie ihre Standardwerte im Eigenschaftenraster ändern.

<div data-name="WebPartZone">
    <!--CS: Start web part zone Snippet-->
    <!--SPM:<%@Register Tagprefix="WebPartPages" Namespace="Microsoft.SharePoint.WebPartPages" Assembly="Microsoft.SharePoint, Version=15.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"%>-->
    <div xmlns:ie="ie">
        <!--MS:<WebPartPages:WebPartZone runat="server" ID="x0e5f5212505f48a9aac43df13eeae4f9" AllowCustomization="True" AllowPersonalization="False" FrameType="TitleBarOnly" LockLayout="True" Orientation="Vertical">-->
            <!--MS:<ZoneTemplate>-->
               <!--DC: Replace this comment with default web parts for new pages. -->
            <!--ME:</ZoneTemplate>-->
        <!--ME:</WebPartPages:WebPartZone>-->
    </div>
    <!--CE: End web part zone Snippet-->
</div>

Siehe auch