Помимо регулярных выражений: улучшение синтаксического анализа значений CSS в инструментах разработчика Chrome

Philip Pfaffe
Ergün Erdogmus
Ergün Erdogmus

Вы заметили, что свойства CSS на вкладке Стили в Инструментах разработчика Chrome стали выглядеть немного лучше? Эти обновления, выпущенные в версиях Chrome 121–128, значительно улучшают обработку и представление значений CSS. В этой статье мы расскажем о технических деталях этого перехода – от системы сопоставления регулярных выражений к более надежному синтаксическому анализатору.

Давайте сравним текущую версию DevTools с предыдущей:

Сверху: последняя версия Chrome. Снизу: Chrome 121.

Разница очевидна, не так ли? Вот основные улучшения:

  • color-mix. Удобный предварительный просмотр, визуально представляющий два аргумента цвета в функции color-mix.
  • pink. Интерактивный предпросмотр цвета для цвета pink. Нажмите на него, чтобы открыть палитру и выбрать нужный цвет.
  • var(--undefined, [fallback value]). Улучшена обработка неопределенных переменных. Неопределенная переменная выделена серым цветом, а активное резервное значение (в данном случае цвет HSL) отображается с интерактивным предварительным просмотром цвета.
  • hsl(…) – ещё один интерактивный предварительный просмотр цвета для функции hsl, обеспечивающий быстрый доступ к палитре.
  • 177deg – интерактивные часы, на которых можно перетаскивать стрелку, чтобы изменить значение угла.
  • var(--saturation, …) – ссылка на определение пользовательского свойства, позволяющая быстро перейти к соответствующему объявлению.

Разница поразительна. Для этого нам пришлось научить DevTools понимать значения свойств CSS намного лучше, чем раньше.

Разве эти предварительные версии не были доступны ранее?

Хотя эти значки предварительного просмотра могут показаться знакомыми, они не всегда отображались единообразно, особенно в сложном синтаксисе CSS, как в примере выше. Даже если они работали, требовалось немало усилий, чтобы настроить их правильно.

Причина в том, что система анализа значений органически росла с первых дней существования DevTools. Однако он не поспевает за новыми функциями CSS и усложнением языка. Чтобы идти в ногу со временем, систему нужно было полностью переработать, и мы это сделали.

Как обрабатываются значения свойств CSS

В DevTools процесс рендеринга и оформления объявлений свойств на вкладке Стили разделен на два отдельных этапа:

  1. Структурный анализ. На этом начальном этапе декларация свойства анализируется, чтобы определить его базовые компоненты и их взаимосвязи. Например, в объявлении border: 1px solid red он распознает 1px как длину, solid как строку, а red как цвет.
  2. Отрисовка. На этапе отрисовки эти компоненты преобразуются в HTML-код. Это позволяет дополнить текст интерактивными элементами и визуальными подсказками. Например, значение цвета red отображается в виде интерактивного значка, при нажатии на который открывается палитра для удобного изменения цвета.

Регулярные выражения

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

В большинстве случаев это работало нормально, но количество случаев, когда это не работало, продолжало расти. За годы работы мы получили множество сообщений об ошибках, связанных с неправильным сопоставлением. Исправляя их (иногда это было просто, а иногда требовало значительных усилий), мы поняли, что нам нужно пересмотреть свой подход, чтобы не накапливать технический долг. Давайте рассмотрим некоторые из них.

Совпадение: color-mix()

Регулярное выражение, которое мы использовали для функции color-mix(), было следующим:

/color-mix\(.*,\s*(?<firstColor>.+)\s*,\s*(?<secondColor>.+)\s*\)/g

Синтаксис:

color-mix(<color-interpolation-method>, [<color> && <percentage [0,100]>?]#{2})

Попробуйте запустить следующий пример, чтобы визуализировать совпадения.

const re = /color-mix\(.*,\s*(?<firstColor>.+)\s*,\s*(?<secondColor>.+)\s*\)/g;

// it works - simpler example
const simpler = re.exec('color-mix(in srgb, pink, hsl(127deg 100% 50%))');
console.table(simpler.groups);

re.exec('');

// it doesn't work - complex example
const complex = re.exec('color-mix(in srgb, pink, var(--undefined, hsl(127deg var(--saturation, 100%) 50%)))');
console.table(complex.groups);

Результат сопоставления для функции color-mix.

Простой пример работает нормально. Однако в более сложном примере соответствием для <firstColor> будет hsl(177deg var(--saturation, а для <secondColor> – 100%) 50%)), что не имеет никакого смысла.

Мы знали, что это проблема. В конце концов, CSS как формальный язык не является регулярным, поэтому мы уже включили специальную обработку для работы с более сложными аргументами функций, такими как функции var. Однако, как видно на первом скриншоте, это не всегда помогало.

Совпадение: tan()

Одна из самых забавных ошибок была связана с тригонометрической функцией tan(). Регулярное выражение, которое мы использовали для сопоставления цветов, включало подвыражение \b[a-zA-Z]+\b(?!-) для сопоставления именованных цветов, таких как ключевое слово red. Затем мы проверили, является ли совпавшая часть названием цвета, и оказалось, что tan – это тоже цвет! Поэтому мы ошибочно интерпретировали tan() выражений как цвета.

Совпадение: var()

Рассмотрим другой пример – функции var() с резервным значением, содержащим другие ссылки var(): var(--non-existent, var(--margin-vertical)).

Регулярное выражение для var() будет соответствовать этому значению. Однако поиск прекратится на первой закрывающей скобке. Таким образом, приведенный выше текст будет сопоставлен как var(--non-existent, var(--margin-vertical). Это классическое ограничение регулярных выражений. Языки, в которых требуется сопоставление скобок, не являются регулярными.

Переход на синтаксический анализатор CSS

Когда анализ текста с помощью регулярных выражений перестает работать (потому что анализируемый язык не является регулярным), есть канонический следующий шаг: использовать синтаксический анализатор для грамматики более высокого типа. Для CSS это означает синтаксический анализатор для контекстно-свободных языков. На самом деле такая система синтаксического анализа уже существовала в базе кода DevTools: Lezer от CodeMirror, которая является основой, например, для подсветки синтаксиса в CodeMirror, редакторе, который вы найдете на панели Источники. Синтаксический анализатор CSS Lezer позволил нам создавать (неабстрактные) синтаксические деревья для правил CSS и был готов к использованию. Победа.

Синтаксическое дерево для значения свойства hsl(177deg var(--saturation, 100%) 50%). Это упрощенная версия результата, полученного синтаксическим анализатором Lezer, в которой опущены чисто синтаксические узлы для запятых и круглых скобок.

Однако мы обнаружили, что перейти от сопоставления на основе регулярных выражений к сопоставлению на основе синтаксического анализатора напрямую невозможно: эти два подхода работают в противоположных направлениях. При сопоставлении частей значений с регулярными выражениями DevTools сканирует входные данные слева направо, неоднократно пытаясь найти самое раннее совпадение из упорядоченного списка шаблонов. В синтаксическом дереве сопоставление начинается снизу вверх. Например, сначала анализируются аргументы вызова, а затем выполняется попытка сопоставить вызов функции. Это похоже на вычисление арифметического выражения, в котором сначала выполняются действия в скобках, затем умножение и деление, а потом сложение и вычитание. В этом случае сопоставление на основе регулярного выражения соответствует вычислению арифметического выражения слева направо. Мы не хотели переписывать всю систему сопоставления с нуля. В ней было 15 разных пар сопоставителей и отрисовщиков с тысячами строк кода, поэтому мы вряд ли смогли бы выпустить ее за один этап.

Поэтому мы разработали решение, которое позволило нам вносить изменения постепенно. Ниже мы расскажем о нем подробнее. Короче говоря, мы сохранили двухэтапный подход, но на первом этапе мы пытаемся сопоставить подвыражения снизу вверх (таким образом, нарушая поток регулярных выражений), а на втором этапе мы выполняем рендеринг сверху вниз. На обоих этапах мы могли использовать существующие сопоставители и средства визуализации на основе регулярных выражений практически без изменений, поэтому смогли перенести их по одному.

Этап 1. Сопоставление снизу вверх

Первый этап более или менее точно и исключительно делает то, что написано на обложке. Мы проходим по дереву снизу вверх и пытаемся сопоставить подвыражения в каждом узле синтаксического дерева, который мы посещаем. Чтобы сопоставить определенное подвыражение, сопоставитель может использовать регулярное выражение, как и в существующей системе. В версии 128 мы по-прежнему используем его в некоторых случаях, например для сопоставления длин. Кроме того, сопоставитель может анализировать структуру поддерева, корнем которого является текущий узел. Это позволяет одновременно выявлять синтаксические ошибки и записывать информацию о структуре.

Рассмотрим пример дерева синтаксического анализа, приведенный выше.

Этап 1. Сопоставление снизу вверх в синтаксическом дереве.

Для этого дерева сопоставители будут применяться в следующем порядке:

  1. hsl(177degvar(--saturation, 100%) 50%): сначала мы определяем первый аргумент вызова функции hsl – угол цветового тона. Мы сопоставляем его с сопоставителем углов, чтобы мы могли украсить значение угла значком угла.
  2. hsl(177degvar(--saturation, 100%)50%): во-вторых, мы обнаруживаем вызов функции var с помощью сопоставителя var. В таких случаях мы в основном хотим сделать две вещи:
    • Найти объявление переменной и вычислить ее значение, а также добавить ссылку и всплывающее окно к имени переменной, чтобы подключиться к ним соответственно.
    • Если вычисленное значение является цветом, добавьте к вызову цветной значок. Есть ещё и третий вариант, но о нем мы поговорим позже.
  3. hsl(177deg var(--saturation, 100%) 50%) Наконец, мы сопоставляем выражение вызова для функции hsl, чтобы украсить его цветным значком.

Помимо поиска подвыражений, которые мы хотели бы украсить, на самом деле есть вторая функция, которую мы запускаем в рамках процесса сопоставления. Обратите внимание, что на шаге 2 мы упомянули, что ищем вычисленное значение для имени переменной. На самом деле мы делаем ещё один шаг и распространяем результаты вверх по дереву. Причем не только для переменной, но и для резервного значения. При посещении узла функции var гарантируется, что его дочерние узлы уже были посещены, поэтому мы уже знаем результаты всех функций var, которые могут появиться в резервном значении. Поэтому мы можем легко и без лишних затрат заменять функции var их результатами на лету. Это позволяет нам без труда отвечать на вопросы вроде "Является ли результат этого вызова var цветом?", как мы делали на шаге 2.

Этап 2. Отрисовка сверху вниз

На втором этапе мы меняем направление. На основе результатов сопоставления, полученных на этапе 1, мы преобразуем дерево в HTML-код, проходя по нему сверху вниз. Для каждого посещенного узла мы проверяем, соответствует ли он условию, и если да, вызываем соответствующий рендерер сопоставителя. Чтобы не обрабатывать отдельно узлы, содержащие только текст (например, NumberLiteral "50%"), мы добавили сопоставитель и отрисовщик по умолчанию для текстовых узлов. Средства визуализации просто выводят узлы HTML, которые вместе представляют значение свойства, включая его оформление.

Этап 2. Отрисовка синтаксического дерева сверху вниз.

Для дерева из примера выше порядок, в котором отображается значение свойства, будет следующим:

  1. Перейдите к вызову функции hsl. Совпадение найдено, поэтому вызывается функция отрисовки цвета. Она выполняет две функции:
    • Вычисляет фактическое значение цвета, используя механизм подстановки на лету для любых аргументов var, а затем рисует цветной значок.
    • Рекурсивно отображает дочерние элементы CallExpression. Это автоматически позаботится о рендеринге названия функции, скобок и запятых, которые являются просто текстом.
  2. Перейдите к первому аргументу вызова hsl. Совпадение найдено, поэтому вызывается средство визуализации угла, которое рисует значок угла и текст угла.
  3. Перейдите ко второму аргументу, который является вызовом var. Совпадение найдено, поэтому вызывается переменная renderer, которая выводит следующее:
    • Текст var( в начале.
    • Название переменной и ссылка на ее определение или серый цвет текста, указывающий, что переменная не определена. Также добавляется всплывающее окно с информацией о значении переменной.
    • запятую, а затем рекурсивно отображает резервное значение.
    • Закрывающая скобка.
  4. Перейдите к последнему аргументу вызова hsl. Оно не совпало, поэтому просто выведите его текстовое содержимое.

Вы заметили, что в этом алгоритме рендер полностью контролирует, как рендерятся дочерние элементы сопоставленного узла? Рекурсивный рендеринг дочерних элементов – это упреждающий подход. Этот трюк позволил нам постепенно перейти от рендеринга на основе регулярных выражений к рендерингу на основе синтаксического дерева. Для узлов, сопоставленных с устаревшим средством сопоставления регулярных выражений, соответствующее средство визуализации можно использовать в исходном виде. В терминах синтаксического дерева он будет отвечать за рендеринг всего поддерева, а его результат (узел HTML) может быть чисто подключен к окружающему процессу рендеринга. Это позволило нам переносить сопоставители и средства визуализации парами и заменять их по одному.

Ещё одна интересная особенность рендереров, управляющих рендерингом дочерних элементов сопоставленного узла, заключается в том, что они позволяют нам рассуждать о зависимостях между добавляемыми значками. В примере выше цвет, создаваемый функцией hsl, очевидно, зависит от значения оттенка. Это значит, что цвет, показанный на значке цвета, зависит от угла, показанного на значке угла. Если пользователь откроет редактор угла с помощью этого значка и изменит угол, мы сможем обновить цвет значка цвета в реальном времени:

Как видно из примера выше, мы используем этот механизм и для других пар значков, например для color-mix() и двух его цветовых каналов или функций var, которые возвращают цвет из резервного.

Влияние на производительность

Когда мы начали работать над этой проблемой, чтобы повысить надежность и устранить давние ошибки, мы ожидали некоторого снижения производительности, учитывая, что мы начали использовать полноценный синтаксический анализатор. Чтобы проверить это, мы создали тест, который отображает около 3,5 тыс.объявлений свойств, и профилировали версии на основе регулярных выражений и синтаксического анализатора с 6-кратным регулированием на машине M1.

Как мы и ожидали, подход на основе синтаксического анализа оказался на 27 % медленнее, чем подход на основе регулярных выражений. Отрисовка на основе регулярных выражений заняла 11 секунд, а на основе синтаксического анализатора – 15 секунд.

Учитывая преимущества нового подхода, мы решили перейти на него.

Благодарности

Выражаем глубочайшую благодарность Софии Емельяновой и Джеселин Йин за неоценимую помощь в редактировании этой публикации.

Скачайте каналы предварительного просмотра

Рекомендуем использовать в качестве браузера для разработки Chrome Canary, Dev или Beta. Эти предварительные версии каналов дают доступ к новейшим функциям инструментов разработчика, позволяют тестировать передовые API веб-платформ и помогают находить проблемы на сайте раньше пользователей.

Как связаться с командой инструментов разработчика Chrome

Ниже перечислены варианты, которые можно использовать, чтобы обсудить новые функции, обновления или другие вопросы, связанные с инструментами разработчика.