Ошибки компиляции
ECSS проверяет файлы на этапе сборки. Ошибки синтаксиса и нарушения правил языка выводятся в терминал, а в dev-режиме Vite — ещё и оверлеем прямо в браузере. Каждая ошибка указывает позицию в формате [строка:колонка].
Частые ситуации
| Ситуация | Как исправить |
|---|---|
| Имя блока, элемента или перечисления не с заглавной буквы | Используйте PascalCase: Button, NavItem |
@param стоит после CSS-правил или других директив | Перенесите все @param в начало тела блока |
@element, @external, @if или @debug на верхнем уровне файла | Эти директивы допустимы только внутри @block |
@param внутри @element или @external | Параметры объявляются только в самом блоке |
@elseif / @else без предшествующего @if | Условная цепочка начинается с @if |
Значение @enum без кавычек (values: sm, md;) | Значения — строковые литералы: values: "sm", "md"; |
Неизвестная единица измерения или заглавные буквы в ней (16PX) | Используйте допустимую единицу в нижнем регистре — см. Типы данных |
Неизвестное @-правило | ECSS допускает фиксированный набор at-правил — см. Директивы |
В @if сравнивается значение, которого нет в @enum | Сравнивайте только с объявленными значениями перечисления |
См. также
- Директивы — где какая директива допустима
- Типы данных — единицы измерения и значения
- Интеграция с TypeScript — типы и подсказки в редакторе