呈現元件設定值

若要呈現元件設定值，您可以使用元件設定值 URL 和元件設定值呈現選項。

元件設定值 URL

元件設定值 URL 使用內嵌框架呈現，並且使用參數呼叫，讓特定設定值的實際元件能夠放到頁面上。設定值 URL 的格式如下：

{Component Settings URL}?instance=<app-instance>&width=<width>&currCompId=<id of the app associated with the settings panel>&locale=<locale>
名稱 類型 描述

Component Settings URL

URL

元件的元件設定值 URL

width

數字

「設定值」內嵌框架的寬度 (像素)

currCompId

字串

「設定值」面板中目前編輯元件的元件 ID

locale

字串

主機網站目前的地區設定 (網站產生器)。格式為 <language>_<dialect>。範例：En_us。

本機元件設定值呈現選項

根據內嵌框架大小與複雜度，本機元件「設定值」面板中呈現內嵌框架的選項共有三個。每個選項都是在 settingsRenderOption 特性中指定。

註：

這些選項僅供本機元件使用。遠端元件「設定值」面板一律在對話方塊中呈現。
  • inline

    • 只有在使用者需要輸入幾個小特性時才使用此選項。

    • 內嵌框架會插入一般頁籤，以取代原本用來瀏覽至「設定值」面板的按鈕。

    • 提供整合度最高的解決方案，使用者需要的點選動作最少，但它的空間有限。

  • panel

    • 清單中的特性若比較多，但仍可在標準 300 像素的「設定值」面板內適當顯示時，請使用此選項。

    • 內嵌框架將會滑入檢視中並顯示「上一步」按鈕，讓使用者回到「一般」頁籤。

    • 提供整合式解決方案，可在頁面中與內嵌框架互動。

  • dialog

    • 需要複雜使用者介面以處理更為普遍設定值版面配置時的預設模式。

    • 在頁面上的強制回應對話方塊中顯示內嵌框架。