Eseguire il rendering delle impostazioni componente

Per eseguire il rendering delle impostazioni componente è possibile utilizzare un URL di impostazioni componente e opzioni di rendering specifiche.

URL di impostazioni componente

L'URL di impostazioni componente viene visualizzato con un frame in linea e chiamato con parametri per consentire le impostazioni specifiche di un componente effettivo rilasciato su una pagina. L'URL di impostazioni ha il formato seguente:

{Component Settings URL}?instance=<app-instance>&width=<width>&currCompId=<id of the app associated with the settings panel>&locale=<locale>
Nome Tipo Descrizione

Component Settings URL

URL

URL di impostazioni componente di un componente

width

Numero

Larghezza del frame in linea Impostazioni in pixel

currCompId

Stringa

ID componente corrente del componente modificato dal pannello Impostazioni

locale

Stringa

Impostazioni nazionali correnti del sito host (SiteBuilder). Il formato è <language>_<dialect>. Esempio: En_us.

Opzioni di rendering delle impostazioni del componente locale

Per il rendering del frame in linea nel pannello Impostazioni per un componente locale sono disponibili tre opzioni a seconda delle dimensioni e della complessità del frame in linea. Ogni opzione è specificata nella proprietà settingsRenderOption.

Nota:

queste opzioni sono disponibili solo per i componenti locali. I pannelli Impostazioni dei componenti remoti vengono visualizzati sempre in una finestra di dialogo.
  • inline

    • Utilizzare questa opzione solo se si dispone di alcune piccole proprietà che l'utente può immettere.

    • Il frame in linea verrà inserito nella scheda Generale al posto del consueto pulsante per l'accesso al pannello Impostazioni.

    • Fornisce la soluzione più integrata, che richiede la quantità di clic minima per l'utente, ma dispone di spazio limitato.

  • panel

    • Utilizzare questa opzione quando si dispone di una lista di proprietà più lunga, che possono essere comunque ragionevolmente visualizzate nei 300 pixel del pannello Impostazioni standard.

    • Il frame in linea scorrerà nella vista e verrà visualizzato un pulsante Indietro in modo che l'utente possa tornare alla scheda Generale.

    • Fornisce una soluzione integrata in cui è possibile interagire con il frame in linea nella pagina.

  • dialog

    • Modalità predefinita per la gestione di layout di impostazioni più generali che richiedono un'interfaccia utente complessa.

    • Visualizza il frame in linea in una finestra di dialogo modale nella pagina.