Komponenteneinstellungen rendern

Zum Rendern von Komponenteneinstellungen können Sie eine Komponenteneinstellungs-URL und Renderingoptionen für Komponenteneinstellungen verwenden.

Komponenteneinstellungs-URL

Eine Komponenteneinstellungs-URL wird mit einem Inlineframe gerendert und mit Parametern aufgerufen, damit bestimmte Einstellungen einer tatsächlichen Komponente auf einer Seite abgelegt werden können. Die Einstellungs-URL hat das folgende Format:

{Component Settings URL}?instance=<app-instance>&width=<width>&currCompId=<id of the app associated with the settings panel>&locale=<locale>
Name Typ Beschreibung

Component Settings URL

URL

Komponenteneinstellungs-URL einer Komponente

width

Zahl

Breite des Inlineframes für die Einstellungen in Pixel

currCompId

Zeichenfolge

Aktuelle Komponenten-ID der mit dem Einstellungsbereich bearbeiteten Komponente

locale

Zeichenfolge

Aktuelles Gebietsschema der Hostsite (Sitebuilder). Format: <language>_<dialect>. Beispiel: En_us.

Renderingoptionen für Einstellungen einer lokalen Komponente

Es stehen drei Optionen für das Rendering des Inlineframes im Einstellungsbereich für eine lokale Komponente zur Verfügung, basierend auf Größe und Komplexität des Inlineframes. Jede Option wird in der settingsRenderOption-Eigenschaft angegeben.

Hinweis:

Diese Optionen sind nur für lokale Komponenten verfügbar. Einstellungsbereiche für Remotekomponenten werden immer in einem Dialogfeld gerendert.
  • inline

    • Verwenden Sie diese Option nur, wenn Benutzer wenige kleine Eigenschaften eingeben.

    • Der Inlineframe wird anstelle der gewöhnlichen Schaltfläche zum Navigieren zum Einstellungsbereich auf der Registerkarte Allgemein eingefügt.

    • Bietet die größte Integration und erfordert die wenigsten Klicks von Benutzern, verfügt aber über eingeschränkten Platz.

  • panel

    • Verwenden Sie diese Option, wenn die Liste der Eigenschaften länger ist, diese aber dennoch angemessen innerhalb der 300 Pixel des standardmäßigen Einstellungsbereichs angezeigt werden können.

    • Der Inlineframe wird eingeblendet, und die Schaltfläche "Zurück" wird angezeigt, über die Benutzer zur Registerkarte "Allgemein" zurückkehren können.

    • Liefert eine integrierte Lösung, bei der Sie mit dem Inlineframe auf der Seite interagieren können.

  • dialog

    • Der Standardmodus für allgemeine Einstellungslayouts, die eine komplexe Benutzeroberfläche erfordern.

    • Zeigt den Inlineframe in einem modalen Dialogfeld auf der Seite an.