Елементи керування

Другий крок у створенні конфігуратора — побудова форми за допомогою елементів керування.

Елементи керування визначають поля вводу, з якими взаємодіють користувачі. Кожен елемент встановлює або змінює змінну, яку пізніше використовує у розрахунках і логіці.

Поля елементів керування

Кожен елемент можна налаштувати за допомогою таких параметрів:

Основні властивості

  • Мітка
    Відображуване ім'я поля, що показується користувачу (наприклад, "Ширина", "Тип").

  • Змінна
    Внутрішнє ім'я змінної. Обов'язково починається з $ і може містити літери, цифри та підчеркування (наприклад, $width, $material_type).

  • Тип
    Тип поля вводу. Доступні типи:

    • Текст – однострочне текстове поле
    • Текстова область – багато рядкове
    • Число – числовий ввод (підтримує дроби)
    • Вибір – випадаючий список

  • Розмір поля
    Ширина поля у колонках сітки (наприклад, 6/12). Використовується для управління макетом та дозволяє розміщувати поля у відповідних макетах.

Налаштування типу числа

Для Число ви можете налаштувати:

  • Значення за замовчуванням
    Попередньо заповнене значення (наприклад, 700).

  • Мінімальне значення
    Мінімально допустиме значення (наприклад, 350).

  • Максимальне значення
    Максимально допустиме значення (наприклад, 900).

  • Крок
    Крок збільшення/зменшення (наприклад, 10).

Приклад UI форми елемента керування з числом

Налаштування типу вибору

Для Вибір потрібно налаштувати Джерело значень:

  • Джерело значень
    Визначає, звідки беруться опції:
    • YAML – вручну введені значення у YAML
    • JSON – вручну введені значення у JSON
    • Група матеріалів – генерує список матеріалів із обраної групи
    • Властивість групи матеріалів – використовує вказане властивість із матеріалів групи
    • Властивість матеріалу – з конкретного обраного матеріалу

Приклад UI форми елемента керування з вибором

Опції джерел значень

Залежно від обраного Джерела значень з’являються додаткові поля:

  • Група матеріалів
    Обов'язково, якщо Джерело значень — Група матеріалів. Визначає, з якої групи брати матеріали.

  • Властивість групи
    Обов'язково, якщо Джерело значень — Властивість групи матеріалів. Вказує, яке властивість брати з кожного матеріалу групи.

  • Властивість матеріалу
    Обов'язково, якщо Джерело значень — Властивість матеріалу. Вказує, яке властивість використовувати з обраного матеріалу.

  • YAML / JSON
    Обов'язково, якщо Джерело значень — YAML або JSON. Вказує список доступних значень вручну.

Приклади ручного введення значень

YAML:

- Oak
- Birch
- Pine
- Maple

JSON:

[
  "Oak",
  "Birch",
  "Pine",
  "Maple"
]

Рекомендації з використання

  1. Імена змінних: Використовуйте зрозумілі імена змінних для ясності (наприклад, $board_width замість $w).
  2. Планування макету: Використовуйте розміри полів для створення інтуїтивних форм.
  3. Значення за замовчуванням: Створюйте розумні значення по замовченню.
  4. Джерела значень: Вибирайте відповідний джерело даних.
  5. Валідація: Встановлюйте коректні мінімальні та максимальні значення для числових полів.