要呈现组件设置,可以使用组件设置 URL 和组件设置呈现选项。
组件设置 URL
组件设置 URL 使用内嵌框架进行呈现,通过参数进行调用,以便允许放到某页上的实际组件的特定设置。设置 URL 具有以下格式:
{Component Settings URL}?instance=<app-instance>&width=<width>&currCompId=<id of the app associated with the settings panel>&locale=<locale>
名称 | 类型 | 说明 |
---|---|---|
|
URL |
组件的组件设置 URL |
|
数字 |
设置内嵌框架的宽度(以像素为单位) |
|
字符串 |
通过“设置”面板编辑的组件的当前组件 ID |
|
字符串 |
主机站点的当前区域设置(站点构建器)。格式为 |
本地组件设置呈现选项
有三个选项用于根据内嵌框架的大小和复杂性在本地组件的“设置”面板中呈现内嵌框架。在 settingsRenderOption
属性中指定每个选项。
注:
这些选项仅可用于本地组件。远程组件“设置”面板始终在对话框中呈现。inline
仅当有一些小属性供用户输入时,才使用此选项。
内嵌框架将插入到一般信息选项卡,替代用于导航到“设置”面板的常用按钮。
提供最集成的解决方案,需要最少的用户单击量,但空间有限。
panel
如果属性列表较长,但它们仍可以在标准“设置”面板的 300 像素内合理地显示,请使用此选项。
内嵌框架将滑动到视图中,将显示“返回”按钮以将用户返回“一般信息”选项卡。
提供集成的解决方案,您可以在其中与页上的内嵌框架交互。
dialog
用于处理需要复杂用户界面的更常规设置布局的默认模式。
在页上的模式对话框中显示内嵌框架。