Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Добавляет статью про Container Queries #5543

Open
wants to merge 4 commits into
base: main
Choose a base branch
from
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
144 changes: 144 additions & 0 deletions css/container-queries/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,144 @@
---
title: Руководство по выражениям от контейнера
description:
cover:
author: kazakov-al
desktop:
mobile:
alt:
authors:
- kazakov-al
contributors:
-
editors:
-
keywords:
-
related:
-
tags:
- article
---
Comment on lines +1 to +21
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
---
title: Руководство по выражениям от контейнера
description:
cover:
author: kazakov-al
desktop:
mobile:
alt:
authors:
- kazakov-al
contributors:
-
editors:
-
keywords:
-
related:
-
tags:
- article
---
---
title: "Руководство по выражениям от контейнера"
description:
authors:
- kazakov-al
related:
-
tags:
- article
---

Нужно будет добавить дескрипшен и связанные статьи (related).


Долгое время [медиазапросы](/css/media/) были основой адаптивной вёрстки. Если для элемента дизайна не хватало места и разработчику надо было его скрыть, скорее всего писалось что-то подобное:

```css
.input__icon {
display: none;
}

@media (min-width: 580px) {
.input__icon {
display: block;
width: 32px;
height: 32px;
}
}
```

Такой код работает, но с нюансом. Если доступного пространства под элемент станет больше, а ширина области просмотра останется прежней — иконка по-прежнему будет скрыта. Было бы круто отвязаться от области просмотра и получить поведение, при котором внешний вид компонента будет меняться в зависимости от доступного для него пространства.

Здесь и приходят на помощь выражения от контейнера. Они позволяют автоматически менять внешний вид компонента в зависимости от стилей родителя. Чтобы начать использовать выражения от контейнер надо сначала объявить родитель компонента контейнером с помощью свойства `container-type`:

```css
.form__item {
container-type: inline-size;
}
```

У `container-type` есть три значения:
- `normal` — значение по умолчанию. Создаёт контейнер, который не позволяет запрашивать размеры, но разрешает запрос стилей.
- `inline-size` — создаёт контейнер, который позволяет запрашивать размер по строчному направлению оси.
- `size` — создаёт контейнер, который позволяет запрашивать размер по любой оси: и строчной, и блочной.


<aside>

⚠️ К сожалению, не существует способа создать контейнер, позволяющий запрашивать размер только по блочной оси, вместо этого придется использовать значение `size`.

</aside>

При объявлении контейнера с помощью `container-type` под капотом автоматически создаётся контекст, при котором дочерний компонент перестаёт влиять на элементы за пределами своего контейнера.

Рекомендуется давать контейнерам имена с помощью свойства `container-name`:

```css
.form__item {
container-type: inline-size;
container-name: form-item;
}
```

Так вы сможете обращаться к конкретному контейнеру, если их будет несколько. Для объявления контейнера с именем можно использовать и сокращённую запись:

```css
.form__item {
container: form-item / inline-size;
}
```

<aside>

⚠️ Имя обязательно должно идти первым.

</aside>

Когда контейнер объявлен, появляется возможность обращаться к его стилям и использовать новые единицы измерений зависящие от размеров контейнера:
- `cqw` — 1% от ширины контейнера.
- `cqh` — 1% от высоты контейнера.
- `cqi` — 1% от `inline-size` контейнера.
- `cqb` — 1% от `block-size` контейнера.
- `cqmin` — меньшее из `cqi` и `cqb`.
- `cqmax` — большее из `cqi` и `cqb`.

Синтаксис запроса к контейнеру во многом похож на медиавыражения, но вместо директивы `@media` используется `@container`:

```css
@container (inline-size >= 300px) {
.input__icon {
/* Изменение стилей компонента */
}
}
```

Можно запрашивать не только размеры контейнера, а любые его вычисленные стили. Для этого используется функция `style()`.

```css
@container style([свойство]: [значение свойства]) {
/* Новые стили */
}
```

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

```css
@container (inline-size >= 300px) and style(--bg-color: #fff) {
/* Новые стили */
}
```

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

```css
.form__item {
container-type: inline-size;
container-name: form-item;
}

.input {
container-type: inline-size;
container-name: input;
}

.input__icon {
/* стили иконки поля ввода */
}

@container form-item (inline-size >= 300px) {
.input__icon {
/* изменение стилей */
}
}
```

При запросе к конкретному контейнеру — стили применятся, если компонент находится именно в нём. Если не указывать имя контейнера, возьмётся ближайший, а если такового нет, выражение от контейнера не будет работать.
Loading