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类型为主题设置创建新的选项。它可以是单选按钮,选择框或者输入框。

Type 描述
section 定义描述文本区段
radio 定义单选按钮
checkbox 定义选择框
select 定义下拉列表
text 定义文本框
textarea 定义多行文本框

特殊的 XML 类型(type)

还有一些可用于Warp 7的特殊类型:layouts, verify, styles, compileinfo

代码示例

<!-- 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方法即可。了解更多,见主题布局文档。