Создание форм с Phlex в Rails: Полное руководство

Superform: революция в создании компонентов форм в Rails

Superform меняет подход разработчиков к созданию компонентов форм в Rails, используя архитектуру компонентов Phlex. Он предлагает декларативный подход к созданию форм, где формы строятся с помощью вызовов методов, соответствующих HTML-элементам, где аргументы выступают в качестве атрибутов, а блоки — в качестве содержимого. Этот подход устраняет необходимость в ERB-шаблонах и обеспечивает лучшую инкапсуляцию и кастомизацию по сравнению с традиционными помощниками форм Rails.

Содержание

• Superform: Решение для форм на основе Phlex
• Альтернативные подходы к формам на Phlex
• Возможности кастомизации
• Совместимость с Literal Props
• Стратегии миграции
• Преимущества производительности и поддерживаемости

Superform: Решение для форм на основе Phlex

Superform представляет собой фундаментальный сдвиг от традиционных помощников форм Rails, строя формы как классы Ruby вместо ERB-шаблонов. Как описано в статье Ruby Dispatch, это “новая библиотека помощников форм, созданная с нуля на основе Phlex, которая делает создание форм в Rails менее утомительным”. Этот подход позволяет разработчикам создавать формы, которые одновременно являются лаконичными и высоко настраиваемыми.

class Posts::Form < ApplicationForm
  def template(&:)
    field :title
    field :publish_at, type: "datetime-local"
    field :content, rows: 6
    submit
  end
end

Superform предоставляет интуитивные помощники полей, которые генерируют правильные типы ввода с соответствующей проверкой:

• field(:publish_at).date для ввода дат
• field(:email).email для проверки email
• field(:price).number для числовых вводов

Помощники RESTful-контроллеров библиотеки работают точно так же, как методы ActiveRecord save и save!, делая код контроллера предсказуемым и в стиле Rails. Ключевое преимущество заключается в том, что формы Superform могут “разрешать собственные сильные параметры”, устраняя необходимость разделять логику формы и логику контроллера.

Альтернативные подходы к формам на Phlex

Хотя Superform является наиболее популярным решением для форм на основе Phlex, у разработчиков есть несколько альтернативных подходов к созданию форм с Phlex в Rails:

1. Интеграция с помощником Rails form_with

Некоторые разработчики выбирают использование встроенного помощника Rails form_with внутри компонентов форм Phlex. Этот подход сохраняет совместимость с генерацией форм Rails, при этом используя архитектуру компонентов Phlex. Однако, как отмечается в обсуждении на GitHub, это может создавать проблемы с токенами аутентификации и автоматической генерацией имен ввода при использовании со стилевыми библиотеками, такими как PhlexUI.

2. Пользовательские библиотеки форм

Разработчики создают собственные библиотеки форм с использованием Phlex с нуля. Как один пользователь Reddit отметил: “Я даже написал собственную библиотеку для построения форм с использованием Phlex, и все прошло гладко. Я не думаю о том, как взломать то, как кто-то другой взломал Rails.”

3. Интеграция с PhlexUI

Для проектов, использующих библиотеки UI-компонентов, такие как DaisyUI, разработчики создают гибридные подходы, в которых они используют PhlexUI для стилизации, сохраняя при этом функциональность помощников Rails. Это часто включает создание пользовательских компонентов, копирующих стили из PhlexUI, при использовании помощников Rails для фактической генерации форм.

4. Приложения Rails на основе только компонентов

Амбициозные разработчики создают полностью компонентные приложения Rails с использованием Phlex, Superform и Superview. Как показано в видео на YouTube “Build Rails Apps with 100% Phlex Components”, возможно создавать приложения “совершенно без ERB”, используя эти инструменты вместе.

Возможности кастомизации

Вопреки вашим опасениям, Superform на самом деле разработан с учетом возможности кастомизации. Библиотека предоставляет несколько механизмов для расширения и кастомизации поведения форм:

Расширение ApplicationForm

Разработчики могут расширять базовый класс ApplicationForm, чтобы создавать переиспользуемые компоненты, адаптированные под нужды их приложения. Например, добавление сообщений об ошибках в поля ввода:

class ApplicationForm < Superform::Rails::Form
  class MyInputComponent < ApplicationComponent
    def template(&:)
      div class: "form-field" do
        input(**attributes)
        if field.errors?
          div class: "error-message" do
            field.errors.join(", ")
          end
        end
      end
    end
  end
end

Кастомизация полей

Superform понимает структуру отправляемых данных, позволяя разработчикам кастомизировать логику создания полей. В CHANGELOG упоминается, что недавние обновления “обеспечивают лучшую инкапсуляцию и позволяют формам кастомизировать логику создания полей.”

Архитектура компонентов

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

Совместимость с Literal Props

В исследованиях явно не упоминается совместимость с “Literal props”, но они дают представление о том, как Superform обрабатывает атрибуты и кастомизацию:

• Компоненты Superform используют аргументы методов в качестве HTML-атрибутов
• Библиотека поддерживает передачу произвольных атрибутов в элементы форм
• Пользовательские компоненты могут переопределять обработку атрибутов по умолчанию

Для совместимости с literal props, вероятно, потребуется изучить конкретную версию Superform, которую вы используете, и проверить ее документацию или исходный код. Однако, учитывая, что Superform построен на Phlex (который поддерживает literal props), можно ожидать совместимости, хотя для конкретных случаев использования может потребоваться реализовать собственную обработку.

Стратегии миграции

Для разработчиков, обеспокоенных миграцией существующих форм или работой со сложными помощниками полей, из исследований emerge несколько стратегий:

Постепенная миграция

Документация Beautiful Ruby рекомендует “постепенно обновлять существующие приложения Rails с компонентами Phlex в своем собственном темпе”. Это означает, что вы можете начать с замены одной формы за раз, а не с полного переписывания.

Гибридные подходы

Многие разработчики используют гибридные подходы, при которых они сохраняют некоторые ERB-шаблоны, постепенно вводя компоненты Phlex. Это позволяет проводить поэтапное тестирование и снижает риски.

Извлечение компонентов

Как показано в статье Ruby Dispatch, разработчики могут извлекать представления из контроллеров и строить макеты с использованием компонентов Phlex, сохраняя существующую функциональность Rails.

Преимущества производительности и поддерживаемости

Помимо вопросов кастомизации, исследования подчеркивают несколько весомых преимуществ использования решений для форм на основе Phlex:

Производительность

Компоненты Phlex обычно быстрее, чем ERB-шаблоны, поскольку они компилируются в методы Ruby, а не анализируют и выполняют код шаблонов во время выполнения.

Поддерживаемость

Компонентные формы легче поддерживать, потому что:

• Логика формы инкапсулирована в классах Ruby
• Компоненты переиспользуются в разных формах
• Обработка сильных параметров встроена непосредственно в форму
• Нет разделения между логикой представления и логикой контроллера

Опыт разработчика

Разработчики сообщают о повышении производительности при работе с формами Phlex, поскольку они могут оставаться в коде Ruby, не переключаясь между синтаксисом Ruby и HTML/ERB.

Источники

1. Лучшие формы Rails с Superform · The Ruby Dispatch
2. GitHub - rubymonolith/superform: Создавайте высоко настраиваемые HTML-формы с компонентами Phlex
3. Почему Superform? - Beautiful Ruby
4. Phlex в Rails - Beautiful Ruby
5. Лучшие формы Rails с Superform: Изменение правил игры для разработчиков – Ruby Stack News
6. Разработка, управляемая компонентами, в Rails с использованием Phlex · The Ruby Dispatch
7. superform/CHANGELOG.md в main · beautifulruby/superform

Заключение

• Superform предоставляет обширные возможности кастомизации через свою архитектуру компонентов и возможность расширять классы ApplicationForm, вопреки распространенным опасениям относительно ограниченной кастомизации
• Существует несколько подходов к созданию форм Phlex в Rails, включая чистые реализации Superform, интеграцию с Rails form_with и самописные библиотеки форм
• Совместимость с Literal props, вероятно, поддерживается с учетом основы Phlex, хотя конкретная реализация может потребовать собственной обработки
• Стратегии постепенной миграции позволяют разработчикам постепенно внедрять формы Phlex, сохраняя существующую функциональность
• Компонентный подход предлагает значительные преимущества в поддерживаемости и производительности по сравнению с традиционными ERB-шаблонами
• Для сложных форм способность Superform самостоятельно разрешать сильные параметры и инкапсулировать логику формы делает его особенно подходящим для крупных приложений Rails

Для разработчиков со сложными требованиями к формам я рекомендую начинать с основной функциональности Superform и расширять ее через пользовательские компоненты по мере необходимости. Философия дизайна библиотеки подчеркивает кастомизацию и переиспользование, что делает ее хорошо подходящей даже для самых сложных сценариев работы с формами.