Основы Sass
Переменные и вложенность
Переменные Sass используют префикс $. Вложенность повторяет структуру HTML. & ссылается на родительский селектор. Для работы с цветом используйте lighten()/darken().
// SCSS syntax ($var)
$primary-color: #3498db;
$font-stack: -apple-system, sans-serif;
body {
font-family: $font-stack;
color: $primary-color;
a {
color: lighten($primary-color, 20%);
&:hover {
color: darken($primary-color, 10%);
}
}
}SCSS против синтаксиса с отступами
SCSS (.scss) — надмножество CSS: каждый валидный CSS-файл валиден в SCSS. Sass (.sass) убирает скобки и точки с запятой, полагаясь на отступы. SCSS популярнее и проще для миграции. Выберите одно и будьте последовательны в проекте.
// SCSS (.scss) - uses braces and semicolons
.box {
width: 100px;
height: 100px;
}
// Sass (.sass) - indentation-based, no braces/semicolons
.box
width: 100px
height: 100px
// Both compile to the same CSS
// .box { width: 100px; height: 100px; }Комментарии
Комментарии // тихие (удаляются в выводе). /* */ сохраняются в скомпилированном CSS. /*! */ сохраняются даже в сжатом/production режиме — для лицензий и важных уведомлений. // используйте для внутренней документации.
// Single-line comment - NOT compiled to CSS
/* Multi-line comment - compiled to CSS */
/*! Important comment - always kept even in compressed mode */
// Silent comment for developers
$base-font: 16px;
/*! Keep this copyright notice */
body { font-size: $base-font; }Компиляция
Sass компилирует .scss/.sass в .css. --watch пересобирает автоматически при сохранении. Стили вывода: expanded (по умолчанию, читаемый), nested (с отступами), compact (одно правило на строку), compressed (минифицированный для production). В production используйте compressed, чтобы уменьшить размер.
// Compile a single file
// $ sass input.scss output.css
// Watch for changes
// $ sass --watch input.scss:output.css
// Watch a directory
// $ sass --watch scss/:css/
// Compressed output
// $ sass --style=compressed input.scss output.css
// Four output styles: expanded, nested, compact, compressed
$width: 100px;
.box { width: $width; }Обзор возможностей
Sass — препроцессор CSS, добавляющий переменные, вложенность, миксины, наследование, функции и управляющие конструкции. Они снижают повторение (принцип DRY) и делают большие таблицы стилей управляемыми. Все возможности Sass компилируются в стандартный CSS.
// Sass adds programming features to CSS:
// 1. Variables ($var)
// 2. Nesting
// 3. Mixins (@mixin / @include)
// 4. Inheritance (@extend)
// 5. Functions (@function)
// 6. Control directives (@if, @for, @each, @while)
// 7. Partials & Modules (@use, @forward)
// These features help keep stylesheets DRY and maintainable.
$radius: 4px;
.card { border-radius: $radius; }Переменные и типы данных
Объявление и область видимости
Переменные вне блоков глобальны. Переменные внутри блока локальны для него. Локальные затеняют глобальные с тем же именем. Используйте локальные, чтобы не засорять глобальное пространство имён.
$color: #333; // global scope
$padding: 10px; // global
.block {
$local-color: #fff; // local to .block
color: $local-color;
padding: $padding; // can read globals
}
// $local-color is NOT available here
// .other { color: $local-color; } // ERRORФлаг !default
!default присваивает значение, только если переменная null или не определена. Это позволяет пользователям переопределять умолчания библиотеки, задавая переменные ДО её импорта. Критично для настраиваемых Sass-библиотек и дизайн-систем.
// Only assign if the variable is not already defined
$base-color: #333 !default;
$base-color: #fff; // this wins (already? no - assigned above first)
// Useful in libraries/partials for user overrides
// _theme.scss
$primary: blue !default;
.button { background: $primary; }
// User config BEFORE importing
// $primary: red;
// @use 'theme'; -> button is redФлаг !global
!global явно присваивает в глобальную область изнутри блока (миксина, функции, управляющей директивы). С Sass 3+ присваивание внутри блоков локально по умолчанию. Используйте !global редко: глобальная мутация усложняет понимание кода.
$count: 0;
@for $i from 1 through 3 {
$count: $count + $i !global;
}
// $count is now 6 (1+2+3)
.total { content: "#{$count}"; }
// Without !global, the assignment inside @for
// would create a local variable insteadТипы данных
В Sass 7 типов данных: числа (с единицами), строки, цвета, boolean, null, списки и словари. type-of() возвращает тип строкой. Понимание типов необходимо для правильного использования функций и управляющих директив.
// Sass has 7 data types:
$number: 16px; // number (with optional unit)
$string: "Helvetica"; // string (quoted or unquoted)
$color: #3498db; // color
$boolean: true; // boolean (true/false)
$null: null; // null (no value)
$list: 10px 20px 30px; // list (space or comma separated)
$map: (key: value); // map (key-value pairs)
// Type checking
type-of($number) // number
type-of($list) // list
type-of($map) // mapИнтерполяция #{}
Интерполяция #{} вставляет переменные в селекторы, имена свойств, строки и другие места, где обычные переменные недопустимы. В отличие от $var, который работает только в значениях, #{} работает почти везде. Он преобразует любое значение в строковое представление.
$name: "user";
$version: 2;
// Use #{} to insert variables into selectors and strings
.#{$name}-avatar { background: url("/img/#{$name}.png"); }
// In property names and values
.icon-#{$name} {
content: "v#{$version}";
}
// Interpolation in @media and @include
@media (max-width: #{$version * 100}px) {
body { font-size: 14px; }
}Вложенность
Базовая вложенность
Вложенность позволяет писать селекторы, повторяющие иерархию HTML, избегая повторения родительских селекторов. Скомпилированный CSS создаёт селекторы потомков. Это улучшает читаемость, но злоупотребление даёт слишком специфичные селекторы — держите вложенность до 3-4 уровней.
// SCSS nesting mirrors HTML structure
.nav {
background: #333;
ul {
list-style: none;
margin: 0;
li {
display: inline-block;
}
}
a {
color: white;
text-decoration: none;
}
}
// Compiles to: .nav {...} .nav ul {...} .nav ul li {...} .nav a {...}Глубокая вложенность (антипаттерн)
Глубокая вложенность создаёт длинные, слишком специфичные селекторы, которые трудно переопределить и медленнее сопоставляются браузером. Правило: не вкладывайте больше 3-4 уровней. Упрощайте глубокие структуры явными классами в стиле BEM.
// AVOID: overly deep nesting
.header {
.nav {
> ul {
li {
a {
span { // 5 levels deep!
color: red;
}
}
}
}
}
}
// Compiles to: .header .nav > ul li a span
// Too specific - hard to override, slow to match
// BETTER: flatten with classes
.header-nav-link-text { color: red; }Вложенные свойства
Вложенные свойства используют двоеточие после пространства имён свойства (font:, border:, margin:) для группировки связанных под-свойств. Это избавляет от повторения префикса и является чистым синтаксическим сахаром. Компилируется в стандартные свойства вроде font-family, border-top и т. д.
.icon {
// Shorthand for font-family, font-size, font-weight...
font: {
family: "Arial";
size: 14px;
weight: bold;
}
// border-top, border-right, etc.
border: {
top: 1px solid #ccc;
bottom: 2px dashed #999;
}
}
// Compiles to: font-family, font-size, font-weight, border-top, border-bottomВложенные media queries
Вложенность @media внутри правил держит адаптивные стили рядом с компонентом, улучшая поддержку. Скомпилированный CSS поднимает @media на верхний уровень. Это большой выигрыш в читаемости по сравнению с разбросанными по файлам media queries.
.container {
width: 100%;
// Media query nested inside the rule
@media (min-width: 768px) {
width: 720px;
}
@media (min-width: 1024px) {
width: 960px;
}
}
// Compiles to:
// .container { width: 100%; }
// @media (min-width: 768px) { .container { width: 720px; } }
// @media (min-width: 1024px) { .container { width: 960px; } }Списки селекторов во вложенности
При вложении списка селекторов через запятую Sass комбинирует каждый элемент с родителем. Это чище, чем вручную писать каждую комбинацию. & также можно использовать внутри вложенных списков, чтобы добавить классы/модификаторы нескольким родителям сразу.
.btn {
// Comma creates a selector list
.icon,
.label {
color: white;
}
}
// Compiles to:
// .btn .icon, .btn .label { color: white; }
// Nesting a list with &
.card,
.panel {
&.active { border-color: blue; }
}
// .card.active, .panel.active { border-color: blue; }Родительский селектор (&)
Базовый родительский селектор
& ссылается на родительский селектор, позволяя вкладывать псевдоклассы (:hover, :focus), псевдоэлементы (::before) и модификаторы. Это держит связанные стили вместе. &:hover компилируется в .button:hover. Без & получился бы селектор потомка.
.button {
background: blue;
color: white;
// & refers to the parent (.button)
&:hover {
background: darkblue;
}
&:focus {
outline: 2px solid blue;
}
&::after {
content: "→";
}
}
// Compiles to: .button, .button:hover, .button:focus, .button::afterBEM с &
& позволяет компактно реализовать именование BEM (Block Element Modifier). &__title дописывает __title к родителю, со здавая .card__title. &--featured создаёт классы-модификаторы. Это делает генерацию BEM-классов DRY и согласованной внутри определения блока.
// BEM methodology with parent selector
.card {
background: white;
&__title { // .card__title
font-size: 18px;
}
&__body { // .card__body
padding: 16px;
}
&--featured { // .card--featured
border-color: gold;
}
&--featured &__title { // .card--featured .card__title
color: gold;
}
}Суффикс родительского селектора
Размещение & в начале вложенного селектора дописывает суффикс к родителю, создавая составные селекторы вроде .button-primary. Это удобно для вариантов. Осторожно: злоупотребление суффиксами затемняет генерируемые имена классов при чтении исходника.
.button {
background: blue;
// Append suffix to parent
&-primary { background: darkblue; } // .button-primary
&-secondary { background: gray; } // .button-secondary
&-danger { background: red; } // .button-danger
// Combining with state
&-primary.is-active { font-weight: bold; }
}
// Generates: .button, .button-primary, .button-secondary, .button-dangerОбратная вложенность
Размещение & в конце вложенного селектора меняет порядок: родитель становится потомком. Это идеально для контекстных и тематических стилей вроде .dark-theme .modal, где компонент адаптируется к предку, а контекстные переопределения остаются рядом с компонентом.
.modal {
// & at the end - parent as descendant
.dark-theme & {
background: #222;
color: #eee;
}
.sidebar & {
width: 200px;
}
}
// Compiles to:
// .dark-theme .modal { background: #222; color: #eee; }
// .sidebar .modal { width: 200px; }
// Useful when parent is styled differently in a contextНесколько & в одном селекторе
Можно использовать & несколько раз в одном селекторе. & + & генерирует .button + .button для стилизации соседей. Это м ощно для отступов между повторяющимися элементами и сложных селекторов по состоянию. Каждый & заменяется полным родительским селектором.
.button {
// Multiple & references in one selector
& + & { // .button + .button (adjacent sibling)
margin-left: 8px;
}
& ~ & { // .button ~ .button (general sibling)
margin-top: 4px;
}
&.active &__icon { // .button.active .button__icon
color: white;
}
.parent &.is-open &__content {
display: block;
}
}Партиалы (файлы _partial)
Создание партиалов
Партиалы — файлы Sass с ведущим подчёркиванием (например, _variables.scss). Подчёркивание говорит Sass не компилировать их в отдельный CSS. Партиалы предназначены для импорта в основной файл. Это модуляризует код для поддержки.
// _variables.scss - partial file (underscore prefix)
$primary: #3498db;
$secondary: #2ecc71;
$font-base: 16px;
// _buttons.scss
.button {
background: $primary;
padding: $font-base / 2;
}
// Partials are NOT compiled to their own CSS file.
// The underscore tells Sass this is a partial.
// Import them into a main file:
// main.scss: @use 'variables'; @use 'buttons';Соглашения об именовании партиалов
Партиалы используют описательные имена с ведущим подчёркиванием. В @use или @import подчёркивание и расширение опускаются: Sass сам сопоставит 'variables' с _variables.scss. Последовательные имена помогают команде быстро находить код.
// Common partial naming patterns:
// _variables.scss - variables
// _mixins.scss - mixins
// _functions.scss - functions
// _reset.scss - CSS reset
// _base.scss - base styles
// _typography.scss - typography
// _buttons.scss - button component
// _header.scss - header component
// _footer.scss - footer component
// _mediaqueries.scss - media queries
// Import without the underscore or extension:
// @use 'variables';
// @use 'mixins';Паттерн архитектуры 7-1
Паттерн 7-1 — широко принятая архитектура Sass: 7 папок (abstracts, base, components, layout, pages, themes, vendors) плюс точка входа main.scss. Он хорошо масштабируется на большие проекты, разделяя ответственность. В каждой папке партиалы, импортируемые в main.scss.
// 7-1 architecture: 7 folders, 1 main file
// sass/
// abstracts/ - variables, functions, mixins
// base/ - reset, typography, base styles
// components/ - buttons, cards, nav
// layout/ - header, footer, grid
// pages/ - home, about specific styles
// themes/ - theme definitions
// vendors/ - third-party
// main.scss - imports everything
// main.scss
// @use 'abstracts/variables';
// @use 'base/reset';
// @use 'components/buttons';
// @use 'layout/header';Индексные партиалы (_index.scss)
Партиал _index.scss (или _all.scss) работает как публичный API папки, реэкспортируя все её партиалы. Это позволяет импортировать целую папку одним @use. Добавив новый партиал, обновляете только индекс — основной файл не меняется. Это паттерн модульной системы Sass.
// sass/components/_index.scss
// Forward all component partials from one entry point
@forward 'buttons';
@forward 'cards';
@forward 'nav';
@forward 'modal';
// Now in main.scss, one line imports everything:
// @use 'components';
// (resolves to components/_index.scss)
// This keeps the main file clean and lets
// you reorganize partials without touching main.scssЛучшие практики партиалов
Лучшие практики: одна ответственность на партиал, небольшие файлы (50-200 строк), @use для явного управления зависимостями и избегание циклических импортов. Партиал ы улучшают поддержку и переиспользование. @use делает зависимости явными, в отличие от старого @import.
// 1. One concern per partial
// _buttons.scss -> only buttons
// _forms.scss -> only forms
// 2. Keep partials small and focused
// (50-200 lines is a good target)
// 3. Use @use (not @import) for explicit dependencies
// _card.scss
@use '../abstracts/variables' as *;
@use '../abstracts/mixins' as *;
.card {
background: $white;
@include card-shadow;
}
// 4. Avoid circular dependencies@import и @use
@import (устарел)
@import устарел: он засоряет глобальное пространство имён, может выполнять файлы многократно и не даёт приватности и пространств имён. Sass рекомендует миграцию на @use и @forward. Существующий код с @import работает, но новые проекты должны мигрировать.
// @import - the OLD way (deprecated in Sass 1.80+)
@import 'variables';
@import 'mixins';
@import 'buttons';
// Problems with @import:
// 1. Globals leak across files (no namespacing)
// 2. Each @import of the same file runs it again
// 3. No way to make members private
// 4. Extends and mixins can conflict
// Use @use instead (the modern module system)
$primary: blue;Основы @use (пространства имён)
@use загружает модуль один раз и открывает его члены через пространство имён (по умолчанию — имя файла). Доступ через namespace.$var или namespace.mixin-name(). Это предотвращает глобальное загрязнение и конфликты имён. Каждый модуль загружается только раз, сколько бы раз ни встречался @use.
// _variables.scss
$primary: #3498db;
$radius: 4px;
// main.scss - @use creates a namespace (filename by default)
@use 'variables';
.button {
// Access via namespace::member
background: variables.$primary;
border-radius: variables.$radius;
}
// The namespace prevents naming collisions
// and makes dependencies explicit@use с as
'as v' переименовывает пространство имён короче. 'as *' загружает члены в текущую область без префикса — удобно, но рискованно из-за коллизий, поэтому редко. Именованные пространства безопаснее и показывают, откуда пришёл каждый член при чтении кода.
// _variables.scss
$primary: blue;
$secondary: green;
// Rename the namespace with 'as'
@use 'variables' as v;
.btn {
background: v.$primary;
color: v.$secondary;
}
// Or remove the namespace entirely (use with caution)
@use 'variables' as *;
.card {
background: $primary; // direct access, no prefix
}
// 'as *' can cause collisions - prefer named namespaces@use с конфигурацией (with)
'with (...)' настраивает !default-переменные модуля при загрузке. Это заменяет паттерн глобальной настройки через @import. Предложение with должно идти до любого другого использования модуля. Это стандартный способ настройки тем библиотек и дизайн-токенов.
// _theme.scss
$primary: blue !default;
$radius: 4px !default;
.button {
background: $primary;
border-radius: $radius;
}
// main.scss - configure variables on import
@use 'theme' with (
$primary: red,
$radius: 8px
);
// The 'with' clause sets variables marked !default
// This is how libraries are configured by users@use против @import
Миграция с @import на @use: члены становятся в пространствах имён, файлы загружаются один раз, а члены с префиксом - или _ приватны (не экспортируются). @use делает зависимости явными и предотвращает случайное глобальное загрязнение. Для автоматизации миграции больших кодовых баз используйте sass-migrator.
// @import (old) - global, no namespace
@import 'variables';
.button { background: $primary; } // global $primary
// @use (new) - namespaced, loaded once
@use 'variables';
.button { background: variables.$primary; }
// Key differences:
// @import: global scope, runs multiple times, no privacy
// @use: namespaced, runs once, supports private (-prefix)
// _mixins.scss with a private member
@mixin -internal { /* private - not exposed */ }
@mixin public { @include -internal; }
// @use only exposes non-private (no dash prefix) membersМиксины (@mixin / @include)
Определение и использование
@mixin определяет переиспользуемый блок объявлений (и даже правил). @include вставляет содержимое миксина в месте использования. Миксины идеальны для вендорных префиксов, clearfix и повторяющихся групп объявлений. В отличие от @extend, миксины дублируют объявления при каждом включении.
// Define a mixin with @mixin
@mixin center {
display: flex;
justify-content: center;
align-items: center;
}
@mixin card-shadow {
box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
}
// Use with @include
.hero {
@include center;
height: 200px;
}
.modal {
@include center;
@include card-shadow;
}Аргументы миксинов
Миксины принимают аргументы как функции. Передавайте по позиции (порядок важен) или по имени (независимо от порядка, понятнее). Именованные аргументы полезны для миксинов с множеством необязательных параметров. Аргументы делают миксины гибкими и переиспользуемыми.
@mixin button($bg, $color) {
background: $bg;
color: $color;
padding: 8px 16px;
border: none;
border-radius: 4px;
}
// Pass arguments by position
.btn-primary { @include button(blue, white); }
.btn-danger { @include button(red, white); }
// Pass arguments by name (clearer, order-independent)
.btn-info { @include button($color: white, $bg: teal); }Аргументы по умолчанию
Значения по умолчанию делают миксины гибкими: вызывающий может опустить аргументы. Именованные аргументы позволяют переопределить конкретные параметры, оставив остальные по умолчанию. Значения по умолчанию вычисляются при каждом включении миксина, а не один раз при определении.
@mixin border($width: 1px, $style: solid, $color: #ccc) {
border: $width $style $color;
}
// Use all defaults
.box { @include border; }
// border: 1px solid #ccc;
// Override one - use named args to skip earlier ones
.card { @include border($color: blue); }
// border: 1px solid blue;
// Override by position
.banner { @include border(2px, dashed); }
// border: 2px dashed #ccc;Миксин с @content
@content вставляет блок стилей, переданный в @include. Это крайне мощно для миксинов media query, keyframes и обёрток контекста. Включённый блок вычисляется в вызывающей области, поэтому может использовать переменные вызывающего. О передаче аргументов см. раздел @content.
// @content lets you pass a block of styles to a mixin
@mixin respond-to($breakpoint) {
@media (min-width: $breakpoint) {
@content; // injected styles go here
}
}
.sidebar {
width: 100%;
@include respond-to(768px) {
width: 250px; // this block replaces @content
float: left;
}
}
// Compiles to:
// .sidebar { width: 100%; }
// @media (min-width: 768px) { .sidebar { width: 250px; float: left; } }Вариативные аргументы (...)
Оператор ... служит двум целям: в определении миксина собирает лишние аргументы в список (вариативность); в месте вызова разворачивает список в отдельные аргументы. Это необходимо для миксинов, оборачивающих CSS-свойства с переменным числом значений, например box-shadow и transition.
// ... captures multiple args into a list (or expands a list)
@mixin box-shadow($shadows...) {
box-shadow: $shadows;
}
.card { @include box-shadow(0 1px 2px black, 0 4px 8px gray); }
// box-shadow: 0 1px 2px black, 0 4px 8px gray;
// Expanding a list into arguments
$shadows: 0 1px 2px black, 0 4px 8px gray;
.modal { @include box-shadow($shadows...); }
// Also works for @include with maps as keyword args
@mixin theme($colors) { /* ... */ }
@include theme(("bg": red, "fg": white)...);@extend и наследование
Базовый @extend
@extend заставляет один селектор наследовать все стили другого, разделяя правило, а не дублируя его. Скомпилированный CSS группирует селекторы. Для общих базовых стилей @extend более DRY, чем миксин, но может создавать неожиданные цепочки селекторов — используйте осторожно.
.message {
padding: 10px;
border: 1px solid #ccc;
border-radius: 4px;
}
// .success inherits all .message styles
.success {
@extend .message;
background: #d4edda;
border-color: #c3e6cb;
}
.error {
@extend .message;
background: #f8d7da;
border-color: #f5c6cb;
}
// Compiles to: .message, .success, .error { padding: 10px; ... }Расширение сложных селекторов
@extend работает с любым селектором: классами, селекторами элементов, псевдоклассами, составными селекторами. Расширение .icon.large наследует правила, совпадающие и с .icon, и с .icon.large. Осторожно расширяйте сложные селекторы: сгенерированный CSS может каскадироваться неожиданно и раздуваться.
// You can extend any selector, not just classes
a:hover {
text-decoration: underline;
}
.link-card:hover {
@extend a:hover; // inherits :hover rule
color: blue;
}
// Extending with compound selectors
.icon {
display: inline-block;
}
.icon.large {
font-size: 24px;
}
.icon-x { @extend .icon.large; } // extends BOTH rulesЦепочки @extend
@extend образует цепочки: если B расширяет A, а C расширяет B, C наследует от об оих. Скомпилированный CSS соответствующим образом группирует селекторы. Глубокие цепочки дают большие списки селекторов и неожиданную специфичность. Для большинства случаев переиспользования миксин предсказуемее цепочек @extend.
.base {
display: block;
padding: 8px;
}
.intermediate {
@extend .base;
background: #eee;
}
.final {
@extend .intermediate;
color: red;
}
// .final inherits from .intermediate which inherits from .base
// Compiles to: .base, .intermediate, .final { display: block; padding: 8px; }
// .intermediate, .final { background: #eee; }
// .final { color: red; }@extend !optional
Добавление !optional к @extend молча пропускает расширение, если целевого селектора нет, вместо ошибки. Это полезно при расширении необязательных или условно загружаемых селекторов. Без !optional @extend ломает компиляцию при отсутствии цели.
// !optional prevents errors if the selector doesn't exist
.fluent {
@extend .nonexistent !optional; // no error, just skipped
color: blue;
}
// Without !optional, extending a missing selector throws:
// ".nonexistent failed to @extend"
// Use !optional when the extension target may or may not exist
// (e.g., optional theme classes from a third-party library)@extend против @include
@extend группирует селекторы (меньше CSS при частом переиспользовании), но создаёт скрытую связанность. @include дублирует объявления (больше CSS), но самодостаточен и настраиваем. Для нового кода предпочитайте миксины: они предсказуемы. @extend используйте в основном для смысловых связей в одном файле.
// @extend - shares one rule, groups selectors
.btn { padding: 8px; }
.primary { @extend .btn; background: blue; }
// -> .btn, .primary { padding: 8px; }
// @mixin - duplicates declarations each use
@mixin btn { padding: 8px; }
.primary { @include btn; background: blue; }
// -> .primary { padding: 8px; background: blue; }
// When to use which:
// @extend: share base styles semantically (DRY selectors)
// @mixin: configurable repeated declarations (with args)
// Avoid @extend across module boundaries (can cause side effects)Placeholder-селекторы (%placeholder)
Основы %placeholder
Placeholder-селекторы (например, %base-message) — правила, существующие только для расширения: сами по себе они не выводятся в CSS. Это избегает проблемы неиспользуемого базового класса, которую может вызвать @extend реального класса. Placeholders — самый чистый способ делить стили только для наследования.
// %placeholder selectors are NOT output in CSS
// They only appear when @extended
%base-message {
padding: 10px;
border-radius: 4px;
}
.success { @extend %base-message; background: green; }
.error { @extend %base-message; background: red; }
// Compiles to (notice %base-message is gone):
// .success, .error { padding: 10px; border-radius: 4px; }
// .success { background: green; }
// .error { background: red; }Placeholder против класса
При @extend реального класса этот класс попадает в вывод, даже если не используется в HTML. Placeholders решают это: %base выводится только там, где расширен. Используйте реальные классы, когда база применяется и напрямую в HTML; placeholders — когда база нужна только для наследования.
// Class as extend target - the class IS output
.message { padding: 10px; } // appears in CSS even if unused
.success { @extend .message; }
// Placeholder as extend target - NOT output
%message { padding: 10px; } // never appears in CSS
.success { @extend %message; }
// Result is identical for .success, but the placeholder
// version doesn't pollute the CSS with an unused .message rule.
// Use placeholders for internal/inheritance-only base styles.Placeholder с @extend
Селектор мо жет расширять несколько placeholders, комбинируя общие наборы стилей. Это собирает переиспользуемые блоки без вывода неиспользуемых базовых классов. Placeholders хороши для примитивов дизайн-системы (карточки, кнопки, поля), общих для многих конкретных компонентов.
%card-base {
background: white;
border: 1px solid #eee;
border-radius: 8px;
padding: 16px;
}
%card-shadow {
box-shadow: 0 2px 8px rgba(0, 0, 0, 0.1);
}
// Combine multiple placeholders
.featured-card {
@extend %card-base;
@extend %card-shadow;
border-color: gold;
}Несколько placeholders
Когда несколько селекторов расширяют один placeholder, Sass группирует их в выводе, давая компактный CSS. Это самая эффективная форма обмена стилями в Sass. Placeholders дают подобие наследования и композиции без раздувания классов в рантайме.
%button { padding: 8px 16px; border: none; cursor: pointer; }
%rounded { border-radius: 4px; }
%shadow { box-shadow: 0 1px 3px rgba(0,0,0,0.2); }
// Many components share the same placeholders
.btn-primary { @extend %button; @extend %rounded; @extend %shadow; background: blue; }
.btn-secondary { @extend %button; @extend %rounded; background: gray; }
.btn-ghost { @extend %button; background: transparent; }
// Sass deduplicates: %button's rule is shared across all threeСценарии placeholders
Placeholders идеальны для переиспользуемых утилит: центрирование, clearfix, доступность (visually-hidden) и примитивы дизайн-системы. Они держат эти паттерны в одном месте и не выводят их без использования. Это чистый способ делить неконфигурируемые утилитарные стили.
// 1. Design system primitives
%abs-center {
position: absolute;
top: 50%; left: 50%;
transform: translate(-50%, -50%);
}
// 2. Clearfix
%clearfix::after {
content: "";
display: table;
clear: both;
}
// 3. Visually hidden (accessibility)
%visually-hidden {
position: absolute;
width: 1px; height: 1px;
overflow: hidden;
clip: rect(0 0 0 0);
}
.modal { @extend %abs-center; }
.container { @extend %clearfix; }
.sr-only { @extend %visually-hidden; }Функции (@function)
Определение функций
@function определяет переиспользуемое вычисление, возвращающее значение через @return. Функции вызываются в значениях свойств (в отличие от миксинов, выводящих объявления). Используйте функции для расчётов: конвертации единиц, цветовой математики, адаптивного масштаба. Возврат может быть любого типа Sass.
// @function defines a function that returns a value
@function rem($px) {
$base: 16px;
@return ($px / $base) * 1rem;
}
// Use it like a CSS function
body { font-size: rem(16); } // 1rem
h1 { font-size: rem(32); } // 2rem
.small { font-size: rem(12); } // 0.75rem
// Functions return values; mixins output CSS rulesАргументы и умолчания функций
Функции поддерживают аргументы по умолчанию, именованные и вариативные (...), как миксины. Умолчания делают вызов удобным. Именованные аргументы улучшают читаемость функций с множеством необязательных параметров. Вариативные позволяют принимать любое число значений.
@function spacing($factor: 1, $base: 8px) {
@return $base * $factor;
}
// Use defaults
.card { padding: spacing(); } // 8px
.card-lg { padding: spacing(2); } // 16px
// Override by name
.section { padding: spacing($base: 10px); } // 10px
.hero { padding: spacing(3, 10px); } // 30px
// Variable arguments work too
@function max-of($nums...) {
@return ...; // implement with reduce
}Обзор встроенных функций
Sass включает богатые встроенные функции для цветов, математики, строк, списков и словарей. Современный Sass организует их в модули (sass:math, sass:color, sass:string, sass:list, sass:map, sass:meta), загружаемые через @use. Глобальные имена ещё работают, но устарели в пользу модульных функций с пространством имён.
// Color functions
lighten(#000, 50%) // gray
rgba(#fff, 0.5) // semi-transparent white
mix(red, blue) // purple
// Math functions
percentage(0.5) // 50%
round(3.6) // 4
min(10px, 20px) // 10px
// String functions
to-upper-case("abc") // "ABC"
str-length("hello") // 5
// List/Map functions
length(1 2 3) // 3
map-get(("a": 1), "a") // 1
// Modern Sass uses modules: @use 'sass:math'; math.div(10, 2)Практические примеры функций
Функции отлично инкапсулируют переиспользуемые расчёты: конвертацию единиц (px/em/rem), управление z-index через словарь, поиск дизайн-токенов. Централизация в функциях обеспечивает согласованность и автоматически распространяет изменения (например, базовый размер шрифта) везде.
// Convert px to em relative to a context
@function em($px, $context: 16px) {
@return ($px / $context) * 1em;
}
// Generate a z-index from a scale map
$z-indexes: (
"base": 0,
"dropdown": 100,
"modal": 200,
"toast": 300,
);
@function z($name) {
@return map-get($z-indexes, $name);
}
// Usage
body { font-size: em(18px); } // 1.125em
.modal { z-index: z("modal"); } // 200
.toast { z-index: z("toast"); } // 300Рекурсивные функции
Функции Sass поддерживают рекурсию через @if и самовызов. Это позволяет факториал, числа Фибоначчи и другие вычисляемые последовательности. Однако в Sass нет оптимизации хвостовых вызовов, и рекурсия медленна: избегайте глубокой рекурсии в реальных таблицах стилей. Для итераций предпочитайте циклы (@for).
// Functions can call themselves (recursion)
@function factorial($n) {
@if $n <= 1 {
@return 1;
} @else {
@return $n * factorial($n - 1);
}
}
.power { width: factorial(5) * 1px; } // 120px
// Fibonacci
@function fib($n) {
@if $n < 2 { @return $n; }
@return fib($n - 1) + fib($n - 2);
}
// Note: deep recursion is slow in Sass - use sparinglyУправляющие директивы
@if / @else if / @else
@if/@else if/@else условно выводят стили по сравнениям. Sass использует == и != для равенства (не ===). Логические операторы — 'and', 'or', 'not' (не &&, ||, !). Полезно для переключения тем, feature flags и адаптивной логики в миксинах и функциях.