Customizer.json

Этот файл определяет количество контроля у вас есть над вашей темы внешний вид.

Каждая тема имеет свои специфические customizer.json. Он определяет, какие переменные выводятся по умолчанию или только в расширенном режиме. Файл разделена на две основные части, controls и groups.


Контроль

Контроля определять, как значение переменной будет отображаться в окне настройщика. По умолчанию, все переменные отображаются внутри элемента Input. Вы можете изменить стандартное поле ввода с помощью одного из следующих типов.

Тип Описание
"type": "color" Превращает поля ввода со значением цвета в легко ручка выбора цвета.
"type": "select" Используйте этот тип, чтобы получить выберите поле вместо поля ввода.
"type": "font" Превратится в выберите окно с дополнительными опциями вроде url или в окне выбора групп.

Переменные

После выбора типа входного сигнала необходимо определить, какие переменные должны быть затронуты каждого типа. Вы можете использовать специальные переменные или просто подстановочный символ *, чтобы выбрать группу переменных, не устанавливая каждую переменную.

Конкретные переменные

Влияет только @global-border и @global-light-border.

{
    "vars": [
        "@global-border",
        "@global-light-border"
    ]
}

Подстановочные переменные

Воздействует на все переменные, заканчивающиеся на -color и -background.

{
    "vars": [
        "*-color",
        "*-background"
    ]
}

Выбор цвета

Установка "type": "color" следующий пример включает все переменные, которые оканчиваются на слово -color или -background в удобный для обработки палитры, при условии, что значение переменной-это значение цвета.

Пример

{"controls": [
    {
        "type": "color",
        "vars": [
            "*-color",
            "*-background"
        ]
    }
]}

Выберите элемент

Если переменной необходимо использовать только определенные значения, можно легко превратить в элемент Input в Select элемент с помощью "type": "select" и добавив доступные варианты.

Пример

{"controls": [
    {
        "type": "select",
        "vars": [
            "*-weight"
        ],
        "options": [
            {"name": "Normal", "value": "normal"},
            {"name": "Bold", "value": "bold"}
        ]
    }
]}

Шрифты

Когда дело доходит до шрифтов, вы можете просто использовать выбрать типа как выше или "type": "font", чтобы создать поле выбора шрифтов, где вы можете добавить дополнительные значения, как шрифт url или разделить ваши шрифты на группы.

Пример

{"controls": [
    {
        "type": "font",
        "vars": [
            "*-font-family"
        ],
        "options": {
            "System Fonts": [
                {"name": "Arial", "value": "\"Helvetica Neue\", Helvetica, Arial, sans-serif"},
                {"name": "Consolas", "value": "Consolas, monospace, serif"}
            ],
            "Google Fonts": [
                {"name": "Abel", "value": "'Abel'", "url":"http://fonts.googleapis.com/css?family=Abel"},
                {"name": "Asul", "value": "'Asul'", "url":"http://fonts.googleapis.com/css?family=Asul"},
        }
    }
]}

Групп

Группы определить, какие переменные будут отображаются в боковом меню настройщика. Вы сможете собрать связанных с ними переменных в группе, нанести название или отображать их в Advanced Mode.

Пример

Два набора переменных будут отображаться в боковой панели настройщик по умолчанию.

{"groups": [
    {
        "label": "Backgrounds",
        "vars": [
            "@global-background",
            "@global-dark-background"
        ]
    }
]}

Показывает все переменные из компонент навигации в расширенном режиме.

{"groups": [
    {
        "label": "Navbar",
        "advanced": true,
        "vars": [
            "@navbar-*"
        ]
    },
]}