Config.xml

config.xml 定义Warp 7 的主题设置。

在主题设置中，可以控制主题布局、小工具和菜单的基础参数设置。每个菜单选项卡都有它自己的选项面板，由config.xml定义。

<fields> 元素

<fields>元素定义菜单选项卡，已经为它们的选项创建面板。

<?xml version="1.0" encoding="utf-8"?>
<config>
    <fields name="Settings" icon="uk-icon-cogs">
        ...
    </fields>
    <fields name="Layouts" icon="uk-icon-columns">
        ...
    </fields>
    <fields name="Modules" icon="uk-icon-th">
        ...
    </fields>
    <fields name="Menus" icon="uk-icon-reorder">
        ...
    </fields>
    <fields name="Information" icon="uk-icon-info-sign">
        ...
    </fields>
</config>

添加新的菜单项

添加一个<fields>元素将会为主题设置加入新的选项卡。它的name属性的值即是选项卡的名称。

<fields name="MY-MENUITEM" icon="uk-icon-info-sign">
    ...
</fields>

<field> 元素

在<fields>元素内的<field>元素，用于定义选项卡菜单中的设置选项。

基本 XML 类型（type）

你可以使用基础XML类型为主题设置创建新的选项。它可以是单选按钮，选择框或者输入框。

特殊的 XML 类型（type）

还有一些可用于Warp 7的特殊类型：layouts, verify, styles, compile 和 info。

代码示例

<!-- Section field -->
<field type="section" name="Headline" description="A description text." />

<!-- Checkbox field -->
<field type="checkbox" name="my-option-1" value="1" label="A description text." />

<!-- Radio field -->
<field type="radio" name="my-option-2" value="1" label="A description text." />

<!-- Select field -->
<field type="select" name="my-option-3" default="0">
    <option value="0">Option A</option>
    <option value="1">Option B</option>
    <option value="2">Option C</option>
    <option value="3">Option D</option>
</field>

<!-- Text field -->
<field type="text" name="my-option-4" />

<!-- Textarea field -->
<field type="textarea" name="my-option-5" class="uk-form-width-large" rows="8" />

添加新选项

创建新的选项，添加一个 <field> 元素到设置中即可，即：在想要添加选项的<fields>元素中添加。还可以复制现成的选项，并修改成你需要的。

config.json

config.xml用于定义哪些主题设置是可用的。如果保存了主题设置，它们会保存在压缩的config.json文件中。伴随每次改动，此文件均会被覆写。

Warp 主题提供了一个单独的config.default.json文件，默认的主题设置baoc 保存于此。这便给了你回复默认设置的机会，并且可以备份config.json文件，使设置的更新有迹可循。

注意 为了更好的进行概览，使用JSON 格式化工具 - 它可以让压缩的文件恢复为可读的格式。

配置对象/Config object

来自于config.xml的变量被存储在配置对象中。访问变量的值，使用get方法即可。了解更多，见主题布局文档。