Слогер Создать блог
Разработка

Rails уже поставляется с class_names, но я всё равно написал clsx

Разбираемся, почему встроенного хелпера для CSS-классов в Rails иногда недостаточно и как альтернатива решает проблемы в реальных проектах.

Когда два года назад я опубликовал небольшую библиотеку для условных CSS-классов, первым комментарием был вопрос Адриана Поли: «А в чём главное отличие от встроенного хелпера class_names в Rails?» Честно признаюсь: я тогда не знал, что class_names существует. Я написал гем для того, что уже было в Rails. Пошёл посмотрел, решил, что разница в производительности, и оставил как есть. Но этот ответ не давал мне покоя два года. Вот настоящая история.

Сначала отдадим должное

Если вы используете Rails 6.1 или новее, то можете прямо сейчас собирать строку классов условно — без всяких гемов:

<%= tag.div class: class_names("btn", "btn-primary", active: @active) do %> Click me <% end %>

class_names — это публичный псевдоним для token_list в ActionView::Helpers::TagHelper. Он принимает строки, массивы и хеши, разделяет по пробелам, отбрасывает ложные значения, удаляет дубликаты и возвращает HTML-безопасную строку. Для повседневных задач этого вполне достаточно, и clsx согласен с ним токен в токен:

require "clsx" require "action_view" view = Object.new.extend(ActionView::Helpers::TagHelper) view.class_names("a", "b") # => "a b" Clsx["a", "b"] # => "a b" view.class_names(foo: true, bar: false) # => "foo" Clsx[foo: true, bar: false] # => "foo" view.class_names("a b", "b c") # => "a b c" Clsx["a b", "b c"] # => "a b c" view.class_names("a", ["b", ["c"]]) # => "a b c" Clsx["a", ["b", ["c"]]] # => "a b c"

Если вам нужно только это — используйте встроенный хелпер. Честно. А остальная часть статьи — о четырёх случаях, когда «только этого» оказывается недостаточно.

Причина 1: class_names привязан к ActionView

class_names — это метод в ActionView::Helpers::TagHelper. Ему не нужен живой view, не нужен запрос или буфер вывода. Ему нужен сам модуль. Но модуль — часть ActionView, поэтому, чтобы склеить две строки в Sinatra-приложении или в обычном сервис-объекте, приходится подгружать целый фреймворк и примешивать его вручную:

# В обычном объекте без require class_names не определён: class_names("a", active: true) # => NoMethodError # Приходится подключать ActionView и расширять модулем: require "action_view" view = Object.new.extend(ActionView::Helpers::TagHelper) view.class_names("a", active: true) # => "a"

Именно этот зуд привёл к разделению. Я поместил сборщик классов внутрь Rails-гема, потому что в ту неделю работал в Rails. А потом захотел то же самое в компоненте Phlex и в обычном презентере — и тянуть для этого ActionView показалось абсурдом. В склеивании имён классов нет ничего специфичного для Rails. Поэтому я выделил логику в clsx-ruby — один файл, около 130 строк, ноль зависимостей, а clsx-rails оставил как тонкую прослойку сверху:

require "clsx" is_active, is_disabled = true, false Clsx["btn", "btn-primary", active: is_active, disabled: is_disabled] # => "btn btn-primary active"

Причина 2: пустой результат и поведение с «мусором»

class_names и clsx сходятся в обычных случаях. Но есть одно отличие, которое я использую ежедневно: что возвращается, когда ничего не подходит:

view.class_names(nil, false) # => "" (рендерит class="") Clsx[nil, false] # => nil (Rails-хелперы тегов пропускают nil)

Rails пропускает nil-атрибут class, поэтому Clsx[...] никогда не рендерит пустой class="" на компоненте, которому нечего добавить. class_names возвращает "", и это рендерится.

Есть один честный аргумент в другую сторону: class_names возвращает html_safe-строку, а clsx — обычную String. Внутри атрибута class: это неважно — Rails экранирует значение в любом случае, а в токенах классов нечего экранировать. Если вы интерполируете результат clsx где-то ещё в сыром виде, это обычная строка, и она экранируется как положено — безопасное поведение по умолчанию. Но если вам нужен именно html_safe, class_names даёт его, а clsx — нет.

Остальное — надёжность. Никто не пишет такие входные данные намеренно, но какой-нибудь хелпер рано или поздно передаёт сборщику что-то странное, и две библиотеки расходятся в том, что с этим делать:

# Сложное значение как ключ хеша. view.class_names([{ foo: true }, "bar"] => true) # => "[{foo: true}, &quot;bar&quot;]" Clsx[[{ foo: true }, "bar"] => true] # => "foo bar" # Невызванная лямбда и случайный true. view.class_names(proc {}, true) # => "#&lt;Proc:0x...&gt; true" Clsx[proc {}, true] # => nil

class_names преобразует в строку всё, что получает, и экранирует в атрибут; clsx рекурсивно обрабатывает сложный ключ и игнорирует «голый» Proc или true. Когда хелпер admin_link случайно передаёт невызванную лямбду, clsx её отбрасывает, а class_names печатает адрес Proc в ваш HTML.

Полный набор правил

Название — дань уважения: clsx-ruby создан по образцу lukeed's clsx — крошечного JavaScript-пакета, так что модель аргументов знакома разработчикам на React. Поскольку различия выше касаются в основном того, что считается классом и что считается истинным, вот все правила в одном месте. clsx принимает строки, символы, числа, хеши, массивы и любую их вложенность:

Clsx["foo", true && "bar", "baz"] # => "foo bar baz" Clsx[:foo, :"bar-baz"] # => "foo bar-baz" Clsx[1, 2, 3] # => "1 2 3" Clsx[["foo", nil, false, "bar"]] # => "foo bar" Clsx["foo", ["bar", { baz: false }, ["hi", ["there"]]]] # => "foo bar hi there"

Хеш включает каждый ключ, значение которого истинно, в порядке объявления:

Clsx[foo: true, bar: false, baz: 2 > 1] # => "foo baz"

Единственное правило, которое сбивает с толку пришедших из JavaScript: в Ruby ложны только false и nil. Поэтому 0, "", [] и {} — все истинны и сохраняют свой ключ.

Clsx["foo" => 0, bar: []] # => "foo bar"

И два удобства, которых нет в JS-версии: дубликаты удаляются даже в многотокенных строках, а пустой результат — nil, а не "":

Clsx["a", "a"] # => "a" Clsx["a b", "b c"] # => "a b c" Clsx[nil, false] # => nil

По материалам: dev.to. Текст переработан редакцией Слогера.

← На главную

Рекламное место — Конец поста
Реклама · Слогер

Комментарии (0)

Войдите, чтобы комментировать.

Пока нет комментариев. Будьте первым.

Личный опыт

Как довести до конца одно незаконченное дело: метод одной даты

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

Слогер 19.11.2026 ▲ 0
Карьера

Как автоматизировать отклики на вакансии: разбор автозаполнения заявок на Greenhouse, Lever и Ashby

Расширение для Chrome берёт на себя формы, которые вы заполняете десятый раз подряд, — но работает только на трёх системах найма и требует собственных ответов. Разбираем механику, цену и границы.

Слогер 18.11.2026 ▲ 0
Карьера

Как выбрать между двумя офферами на стажировку: разбор по шагам

Два оффера одновременно — хорошая проблема, которая всё равно выматывает. Вот порядок действий: приоритеты, реальные задачи, деньги после аренды, разговор с бывшим стажёром и честная просьба об отсрочке.

Слогер 18.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Стартапы

Fluxs включён в реестр российского ПО Минцифры России

🇷🇺 **Fluxs официально включён в реестр российского ПО!** Наша платформа для управления бизнесом вошла в Единый реестр российских программ Минцифры России. Это важный этап развития Fluxs и новые возможности для сотрудничества с российскими компаниями, банками и организациями, заинтересованными в импортозамещении.

Слогер 17.11.2026 ▲ 0
Разработка

Как получить от клиента согласование сайта на staging: чек-лист приёмки

Устное «выглядит хорошо» в мессенджере не защищает никого: через месяц не вспомнить, что именно смотрели и на какой версии. Вот как превратить просмотр staging в нормальную запись о приёмке.

Слогер 17.11.2026 ▲ 0
Карьера

WARN Act: как работает закон о сокращениях и что делать, если уведомление не пришло

Федеральный WARN Act обязывает крупных работодателей предупреждать о закрытии предприятия или массовом сокращении за 60 дней. Разбираем пороги, исключения и порядок действий — на примере отрасли вывоза и переработки отходов, где сокращения легко пропустить.

Слогер 17.11.2026 ▲ 0
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как читать WARN-уведомления о сокращениях: разбор календаря увольнений на 2027 год

Пересчёт уведомлений с датами вступления в силу в 2027 году дал 4 950 человек вместо 2 882 — и это всё ещё нижняя граница. Разбираем, откуда берётся разница в 42% и как не обмануться такой статистикой.

Слогер 17.11.2026 ▲ 0
Разработка

Заменит ли ИИ программиста: что показывают исследования и как выбрать между ИИ и разработчиком

Вопрос «зачем платить разработчику, если ИИ пишет код» построен на неверном представлении о работе программиста. Разбираем два исследования, цену такого заблуждения и практический чек-лист.

Слогер 17.11.2026 ▲ 0
Стартапы

Почему сотрудники забывают задачи и как это исправить | FLUXS

📌 **Почему сотрудники забывают поручения, даже когда всё записано?** Задача поставлена. Сотрудник записал. Срок прошёл. Результата нет. Такая ситуация встречается часто, и часто проблема не в дисциплине, а в отсутствии прозрачной системы управления задачами. Кто исполнитель? Какой срок? На каком этапе работа? 🚀 **FLUXS помогает управлять поручениями и выстраивать бизнес-процессы под правила вашей компании.** А встроенный ИИ-ассистент помогает создавать и настраивать процессы выполнения задач. 👉 Попробуйте конструктор бизнес-модели: https://fluxs.ru/konstruktor-biznes-modeli #FLUXS #УправлениеЗадачами #АвтоматизацияБизнеса #БизнесПроцессы

Слогер 16.11.2026 ▲ 1
Fluxs lenta
Реклама · fluxs.ru
Карьера

Как делиться опытом, если вы не эксперт: ловушка «об этом уже написали» и рабочие форматы

Мешает делиться знаниями не их дефицит, а мысль, что они недостаточно весомые. Разбираем, что считать полезным вкладом, как писать конкретно и с чего начать без давления.

Слогер 16.11.2026 ▲ 0