Стили и CSS
Astro был разработан, чтобы сделать стилизацию и написание CSS простым делом. Пишите свой собственный CSS напрямую внутри Astro-компонента или импортируйте вашу любимую CSS-библиотеку, например Tailwind. Продвинутые языки стилизации, такие как Sass и Less, также поддерживаются.
Стилизация в Astro
Заголовок раздела «Стилизация в Astro»Стилизация компонента в Astro так же проста, как добавление тега <style> в ваш шаблон компонента или страницы. Когда вы размещаете тег <style> внутри Astro-компонента, Astro автоматически обнаружит CSS и обработает ваши стили.
<style> h1 { color: red; }</style>Локальные стили
Заголовок раздела «Локальные стили»Правила CSS в теге <style> Astro по умолчанию автоматически обладают ограниченной областью видимости. Подобные стили компилируются таким образом, что применяются только к HTML-коду внутри этого же компонента. CSS, написанный внутри Astro-компонента, автоматически инкапсулируется в рамках этого компонента.
Вот этот CSS:
<style> h1 { color: red; }
.text { color: blue; }</style>Компилируется в этот:
<style> h1[data-astro-cid-hhnqfkh6] { color: red; }
.text[data-astro-cid-hhnqfkh6] { color: blue; }</style>Локальные стили не распространяются за пределы компонента и не влияют на остальные части вашего сайта. В Astro можно безопасно использовать селекторы с низкой специфичностью, такие как h1 {} или p {}, поскольку в финальной сборке они будут автоматически преобразованы с учётом ограниченной области видимости.
Локальные стили также не применяются к другим Astro-компонентам внутри вашего шаблона. Если вам нужно стилизовать дочерний компонент, рекомендуется обернуть его в <div> (или другой элемент), который затем можно стилизовать.
Специфичность локальных стилей сохраняется, что позволяет им корректно работать вместе с другими CSS-файлами или CSS-библиотеками, при этом сохраняя чёткие границы, предотвращающие применение стилей за пределами компонента.
Глобальные стили
Заголовок раздела «Глобальные стили»Хотя мы рекомендуем использовать локальные стили для большинства компонентов, иногда могут возникнуть ситуации, когда требуется написать глобальный CSS. Можно отключить автоматическую ограниченную область видимости с помощью атрибута <style is:global>.
<style is:global> /* Без ограниченной области видимости, стили доставляются в браузер как есть. Применяется ко всем тегам `<h1>` на вашем сайте. */ h1 { color: red; }</style>Вы также можете сочетать глобальные и локальные правила CSS в одном теге <style>, используя селектор :global(). Это становится мощным инструментом для применения стилей к дочерним элементам вашего компонента.
<style> /* Стили только для этого компонента. */ h1 { color: red; } /* Смешанный режим: применяется только к дочерним элементам `h1`. */ article :global(h1) { color: blue; }</style><h1>Заголовок</h1><article><slot /></article>Это отличный способ стилизации таких элементов, как посты блога или документы с контентом из CMS, где содержимое находится вне Astro. Однако будьте осторожны: компоненты, внешний вид которых меняется в зависимости от наличия определённого родительского компонента, могут вызвать сложности при отладке.
Локальные стили следует использовать как можно чаще. Глобальные стили стоит применять только при необходимости.
Комбинирование классов с class:list
Заголовок раздела «Комбинирование классов с class:list»Если вам нужно динамически комбинировать классы на элементе, используйте служебный атрибут class:list в .astro файлах.
---const { isRed } = Astro.props;---<!-- Если `isRed` истинно, класс будет "box red". --><!-- Если `isRed` ложно, класс будет "box". --><div class:list={['box', { red: isRed }]}><slot /></div>
<style> .box { border: 1px solid blue; } .red { border-color: red; }</style>class:list читайте в справочнике директив (EN).
CSS-переменные
Заголовок раздела «CSS-переменные»
Добавлено в:
astro@0.21.0
Тег <style> в Astro может использовать любые CSS-переменные, доступные на странице. Вы также можете передавать CSS-переменные напрямую из метаданных компонента с помощью директивы define:vars.
---const foregroundColor = "rgb(221 243 228)";const backgroundColor = "rgb(24 121 78)";---<style define:vars={{ foregroundColor, backgroundColor }}> h1 { background-color: var(--backgroundColor); color: var(--foregroundColor); }</style><h1>Hello</h1>define:vars читайте в справочнике директив (EN).
Передача class дочернему компоненту
Заголовок раздела «Передача class дочернему компоненту»В Astro HTML-атрибуты, такие как class, не передаются дочерним компонентам автоматически.
Вместо этого необходимо:
- Принять проп
classв дочернем компоненте - Применить его к корневому элементу
- При деструктуризации переименовать его, так как
class— зарезервированное слово в JavaScript.
При использовании стратегии локальных стилей по умолчанию необходимо также передавать атрибут data-astro-cid-*. Это можно сделать, передав остальные пропсы (...rest) в компонент. Если вы изменили scopedStyleStrategy на 'class' или 'where', передача ...rest не требуется.
---const { class: className, ...rest } = Astro.props;---<div class={className} {...rest}> <slot/></div>---import MyComponent from "../components/MyComponent.astro"---<style> .red { color: red; }</style><MyComponent class="red">Этот текст будет красным!</MyComponent>Поскольку атрибут data-astro-cid-* включает дочерний компонент в область видимости родителя, стили могут наследоваться от родителя к потомку. Чтобы избежать нежелательных побочных эффектов, используйте уникальные имена классов в дочернем компоненте.
Встроенные стили
Заголовок раздела «Встроенные стили»Вы можете задавать стили HTML-элементам напрямую через атрибут style, используя CSS-строку или объект со свойствами CSS:
// Эти примеры эквивалентны:<p style={{ color: "brown", textDecoration: "underline" }}>Мой текст</p><p style="color: brown; text-decoration: underline;">Мой текст</p>Внешние стили
Заголовок раздела «Внешние стили»Подключение глобальных внешних стилей возможно двумя способами:
- Импорт через ESM для файлов в исходном коде проекта
- Абсолютная ссылка для файлов в директории
public/или внешних ресурсов
public/ или src/.
Импорт локальной таблицы стилей
Заголовок раздела «Импорт локальной таблицы стилей»Возможно, вам потребуется обновить astro.config при импорте стилей из npm-пакетов. См. раздел Импорт стилей из npm-пакета ниже.
Вы можете импортировать таблицы стилей в метаданных Astro-компонента, используя синтаксис ESM-импорта. Импорт CSS работает аналогично другим ESM-импортам в Astro-компоненте и должен:
- Указываться относительно компонента
- Располагаться в верхней части скрипта компонента
- Быть объявлен вместе с другими импортами
---// Astro автоматически соберет и оптимизирует этот CSS за вас// Это работает и с файлами препроцессоров: .scss, .styl и др.import '../styles/utils.css';---<html><!-- Здесь ваша страница --></html>Импорт CSS через ESM поддерживается в любом JavaScript-файле, включая JSX-компоненты (React, Preact и др.). Это особенно полезно для создания детализированных стилей отдельных компонентов React.
Импорт стилей из npm-пакета
Заголовок раздела «Импорт стилей из npm-пакета»Возможно, вам потребуется загрузить стили из внешнего npm-пакета. Это особенно актуально для таких утилит, как Open Props. Если пакет рекомендует указывать расширение файла (например, package-name/styles.css вместо package-name/styles), импорт будет работать так же, как с локальными стилями:
---import 'package-name/styles.css';---<html><!-- Здесь ваша страница --></html>Если ваш пакет не рекомендует указывать расширение файла (например, package-name/styles), сначала потребуется обновить конфигурацию Astro!
Допустим, вы импортируете CSS-файл normalize из пакета package-name (без указания расширения файла). Чтобы гарантировать корректный пререндеринг страницы, добавьте package-name в массив vite.ssr.noExternal:
import { defineConfig } from 'astro/config';
export default defineConfig({ vite: { ssr: { noExternal: ['package-name'], } }})Это специфичная настройка Vite, которая не связана (и не требует) с SSR в Astro.
Теперь вы можете свободно импортировать package-name/normalize. Astro обработает и оптимизирует этот файл, как и любую другую локальную таблицу стилей.
---import 'package-name/normalize';---<html><!-- Здесь ваша страница --></html>Подключение статической таблицы стилей через тег <link>
Заголовок раздела «Подключение статической таблицы стилей через тег <link>»Для загрузки CSS-файлов также можно использовать элемент <link>. Укажите в нём:
- Абсолютный путь к файлу в директории
/public - Или URL внешнего ресурса
Относительные пути в атрибуте href не поддерживаются.
<head> <!-- Локальная таблица стилей: /public/styles/global.css --> <link rel="stylesheet" href="/styles/global.css" /> <!-- Внешняя таблица стилей --> <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/prismjs@1.24.1/themes/prism-tomorrow.css" /></head>Поскольку этот метод использует директорию public/, он пропускает стандартную обработку CSS, сборку и оптимизацию, которые предоставляет Astro. Если вам нужны эти преобразования, используйте метод импорта стилей, описанный выше.
Порядок наследования
Заголовок раздела «Порядок наследования»Компоненты Astro иногда должны учитывать несколько источников CSS. Например, ваш компонент может:
- Импортировать внешнюю таблицу стилей
- Содержать собственный тег
<style> - И рендериться внутри макета, который тоже импортирует CSS
Когда конфликтующие CSS-правила применяются к одному элементу, браузеры сначала используют специфичность, а затем порядок появления для определения конечного стиля.
Если одно правило более специфично чем другое, его значение будет иметь приоритет — независимо от порядка расположения:
<style> h1 { color: red } div > h1 { color: purple }</style><div> <h1> Этот заголовок будет фиолетовым! </h1></div>Если два правила имеют одинаковую специфичность, приоритет определяется по порядку появления — будет применено значение последнего правила:
<style> h1 { color: purple } h1 { color: red }</style><div> <h1> Этот заголовок будет красным! </h1></div>Правила CSS в Astro применяются в следующем порядке:
- Теги
<link>в<head>(наименьший приоритет) - Импортированные стили
- Локальные стили (наибольший приоритет)
Локальные стили
Заголовок раздела «Локальные стили»В зависимости от значения scopedStyleStrategy (EN), локальные стили могут увеличивать специфичность класса, но не всегда.
Однако локальные стили всегда имеют самый поздний порядок появления. Поэтому они будут иметь приоритет над другими стилями с такой же специфичностью. Например, если импортированный стиль конфликтует с локальным стилем, будет применено значение локального стиля:
h1 { color: purple;}---import "./make-it-purple.css"---<style> h1 { color: red }</style><div> <h1> Этот заголовок будет красным! </h1></div>Локальные стили будут перезаписаны, если импортированный стиль имеет более высокую специфичность. В этом случае приоритет отдаётся стилю с наибольшей специфичностью:
#intro { color: purple;}---import "./make-it-purple.css"---<style> h1 { color: red }</style><div> <h1 id="intro"> Этот заголовок будет фиолетовым! </h1></div>Порядок импорта
Заголовок раздела «Порядок импорта»При импорте нескольких таблиц стилей в компоненте Astro CSS-правила обрабатываются в порядке их импорта. Более высокая специфичность всегда определяет, какие стили отображать, независимо от времени обработки CSS. Но если конфликтующие стили имеют одинаковую специфичность, побеждает последний импортированный:
div > h1 { color: purple;}div > h1 { color: green;}---import "./make-it-green.css"import "./make-it-purple.css"---<style> h1 { color: red }</style><div> <h1> Этот заголовок будет фиолетовым! </h1></div>Хотя теги <style> имеют ограниченную область видимости и применяются только к компоненту, который их объявляет, импортированный CSS может «просачиваться». Импорт компонента применяет любой CSS, который он импортирует, даже если компонент никогда не используется:
---import "./make-it-purple.css"---<div> <h1>Импортирую фиолетовый CSS.</h1></div>---import "./make-it-green.css"import PurpleComponent from "./PurpleComponent.astro";---<style> h1 { color: red }</style><div> <h1> Этот заголовок будет фиолетовым! </h1></div>В Astro распространён подход импорта глобального CSS внутри компонента Layout. Убедитесь, что импортируете компонент Layout до других импортов, чтобы он имел наименьший приоритет.
Подключение стилей через теги <link>
Заголовок раздела «Подключение стилей через теги <link>»Таблицы стилей, загруженные через теги <link>, обрабатываются в порядке их подключения, перед любыми другими стилями в Astro-файле. Следовательно, эти стили будут иметь более низкий приоритет, чем импортированные таблицы стилей и локальные стили:
---import "../components/make-it-purple.css"---
<html lang="ru"> <head> <meta charset="utf-8" /> <link rel="icon" type="image/svg+xml" href="/favicon.svg" /> <meta name="viewport" content="width=device-width" /> <meta name="generator" content={Astro.generator} /> <title>Astro</title> <link rel="stylesheet" href="/styles/make-it-blue.css" /> </head> <body> <div> <h1>Этот заголовок будет фиолетовым!</h1> </div> </body></html>