隐藏主题中组件的对齐方式、宽度或间距选项

默认情况下,大多数组件允许构建站点的人员在组件的设置对话框中指定对齐方式、宽度和间距选项。但是,作为开发人员,您可能希望对定制组件隐藏这些选项,从而防止内容提供者使用的内容呈现方式与站点主题不一致。例如,如果您希望提升外观的一致性,将按钮居中并保持将间距设置为 30 像素,则可以通过编辑主题的 components.json 文件在设置中隐藏用于更改它们的选项。

有时您可能还希望覆盖定制组件的初始默认值,这也可以通过编辑 components.json 文件来完成。对初始值的所有更改只应用于在编辑的 components.json 文件已作为新版本上载后添加到页面的组件。

要隐藏主题中组件的对齐方式、宽度或间距的设置选项,请执行以下操作:

  1. Oracle Content Management 中,单击左侧导航菜单中的开发人员
  2. 在“开发人员”页上,单击查看所有主题
  3. 在“主题”页上,选择要修改的主题,然后在右键单击菜单中单击打开,或单击操作栏中的 “打开”图标
  4. 选择 components.json 文件并单击下载
  5. 在文本编辑器中打开 components.json 文件。
  6. 添加用于指定组件类型和 ID 的对象,将要隐藏的属性设置为等于 true
    例如,下面是用于隐藏设置对话框中按钮组件的对齐方式、宽度和间距属性的条目:
    "type":"scs-button",
    "id":"scs-button",
    "hideAlignmentAndWidth": true,
    "hideSpacing": true,
    如果要覆盖按钮组件的默认对齐方式和间距属性,下面是如何指定初始值的示例:
    "initialData": {
        "alignment": "center",
        "marginTop": 30,
        "marginBottom": 30

    components.json 文件中用于指定默认值以及隐藏主题中所用按钮组件的设置对话框中的对齐方式、宽度和间距选项的完整条目如下所示:

    [
        {
            "name": "",
            "list": [
                {
                    "type": "scs-button",
                    "id": "scs-button",
                    "hideAlignmentAndWidth": true,
                    "hideSpacing": true,
                    "initialData": {
                        "alignment": "center",
                        "marginTop": 30,
                        "marginBottom": 30
                    }
                }
            ]
        },
        {
            "name": "Starter",
            "list": [
                {
                    "type": "component",
                    "id": "StarterComponent",
                    "themed": true
                },
                {
                    "type": "component",
                    "id": "StarterFooter",
                    "themed": true
                }
            ]
        }
    ]
  7. 进行了所需更改后,将 components.json 文件作为新版本上载到主题。