Renderowanie ustawień składnika

Do renderowania ustawień składnika można używać adresu URL ustawień składnika i opcji renderowania ustawień składnika.

URL ustawień składnika

URL ustawień składnika jest renderowany w ramce wstawkowej i jest wywoływany z użyciem parametrów określających konkretne ustawienia składnika umieszczanego na stronie. Format adresu URL ustawień jest następujący:

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

Component Settings URL

URL

URL ustawień składnika

width

Liczba

Szerokość ramki wstawkowej ustawień w pikselach

currCompId

Napis

Bieżący ID składnika edytowanego przy użyciu panelu "Ustawienia"

locale

Napis

Bieżące ustawienia narodowe serwisu-hosta (konstruktor serwisów). Format ma postać <język>_<dialekt>. Przykład: En_us.

Opcje renderowania ustawień składnika lokalnego

W panelu "Ustawienia" są dla składnika lokalnego dostępne trzy opcje renderowania go w ramce wstawkowej, bazujące na rozmiarze i stopniu złożoności ramki wstawkowej. Każda z tych opcji jest określana we właściwości settingsRenderOption.

Uwaga:

Opcje te są dostępne tylko dla składników lokalnych. Panele "Ustawienia" składników odległych są zawsze renderowane z użyciem opcji "dialog".
  • inline

    • Opcji tej należy używać, jeśli użytkownik ma wprowadzać niewielką liczbę właściwości.

    • Ramka wstawkowa zostanie wstawiona na karcie Ogólne w miejscu zwykłego przycisku używanego do przechodzenia do panelu "Ustawienia".

    • Zapewnia najbardziej zintegrowane rozwiązanie, wymagając najmniejszej liczby działań użytkownika, lecz ma ograniczone miejsce.

  • panel

    • Opcji tej należy używać, gdy lista właściwości jest dłuższa, lecz nadal można je sensownie wyświetlić w 300-pikselowym obszarze standardowego panelu "Ustawienia".

    • Ramka wstawkowa wsunie się do widoku i pojawi się przycisk "Wstecz" pozwalający użytkownikowi wrócić na kartę "Ogólne".

    • Zapewnia zintegrowane rozwiązanie, umożliwiające interakcję z ramką wstawkową na stronie.

  • dialog

    • Tryb domyślny do obsługi bardziej ogólnych układów ustawień, wymagających złożonego interfejsu użytkownika.

    • Wyświetla ramkę wstawkową w modalnym oknie dialogowym na stronie.