Елементи керування дозволяють користувачеві змінювати вміст і вигляд елемента. Ви можете визначити елементи керування елемента за допомогою методу set_controls() у вашому класі PHP елемента.
Приклад класу елемента з параметрами керування для керування testColor:
class Prefix_Element_Test extends EslElement {public function set_controls() {$this->controls['testColor'] = ['tab' => 'content','group' => 'settings','label' => esc_html__( 'Колір тексту', 'esl' ),'type' => 'color','inline' => true,'small' => true,'css' => [['property' => 'color','selector' => '.content','important' => true, // Додатково],],'default' => ['rgb' => 'rgba(158, 158, 158, .8)','hex' => '#9e9e9e',],'pasteStyles' => false,'description' => esc_html__( 'Визначте колір вмісту.', 'esl' ),'required' => ['showText', '!=', ''],];}}
Наступні параметри керування доступні для всіх типів керування. Щоб детальніше ознайомитися з аргументами конкретного типу керування, виберіть керування з списку внизу.
Універсальні аргументи керування
| Назва | Тип | За замовчуванням | Опис |
|---|---|---|---|
| tab | рядок | content | Вкладка, під якою потрібно показати елемент керування. Приймає: content або style. |
| group | рядок | Група, під якою потрібно показати елемент керування. За замовчуванням елемент керування показується без групи під вкладкою content. |
|
| label | рядок | Локалізована позначка елемента керування. Наприклад: esc_html__( 'Колір', 'esl' ), |
|
| type | рядок | Встановіть тип елемента керування (див. список нижче для отримання переліку всіх доступних типів елементів керування). | |
| inline | логічний | false | Встановіть в true, щоб показати позначку елемента керування та введення на одному рядку. |
| small | логічний | false | Встановіть в true, щоб показати вхід елемента керування шириною 60 пікселів. За замовчуванням вбудовані позначка та введення мають рівні ширини 50%. |
| css | масив | Масив з визначеннями CSS-правил. Кожне правило CSS — це окремий масив і вимагає параметри property та selector. |
|
| default | рядок/масив | Значення за замовчуванням для елемента керування. Може бути рядком або масивом (залежно від типу елемента керування, див. список елементів керування нижче для конкретного значення за замовчуванням) | |
| pasteStyles | логічний | true | Встановіть в true, щоб виключити налаштування з можливості вставлення через специфічний клік правою кнопкою миші “Вставити стилі”. Рекомендується для всіх елементів керування, які виводять HTML-контент замість CSS. |
| description | рядок | Опційний опис для елементів керування, які потребують додаткового пояснення або посилання на ресурс. | |
| required | масив | Показати елемент керування у зв’язку з налаштуванням іншого елемента керування.
Параметр #1: ID елемента керування Приклад: |
Типи елементів керування
| Тип керування | Вихідні дані (Контент/CSS) |
| застосувати | Немає |
| вирівнювання-елементів | CSS |
| аудіо | Контент |
| фон | CSS |
| контур | CSS |
| тінь-коробки | CSS |
| прапорець | Умовний |
| код | Контент |
| колір | CSS |
| вибір-дати | Контент |
| розміри | CSS |
| напрямок | CSS |
| редактор | Контент |
| фільтри | CSS |
| градієнт | CSS |
| іконка | Контент |
| зображення | Контент/CSS |
| галерея-зображень | Контент |
| інформація | Тільки панель двигуна |
| вирівнювання-змісту | CSS |
| посилання | Контент |
| число | Контент/CSS |
| публікації | Контент |
| повторювач | Контент |
| вибір | Контент/CSS |
| слайдер | Контент |
| svg | Контент |
| текст | Контент |
| текстова-область | Контент |
| вирівнювання-тексту | CSS |
| оформлення-тексту | CSS |
| тінь-тексту | CSS |
| трансформація-тексту | CSS |
| типографіка | CSS |