-
Notifications
You must be signed in to change notification settings - Fork 636
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
kazakov-al
wants to merge
4
commits into
doka-guide:main
Choose a base branch
from
kazakov-al:feature/add-article-container-queries
base: main
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Open
Changes from all commits
Commits
File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
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 | ||
--- | ||
|
||
Долгое время [медиазапросы](/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 { | ||
/* изменение стилей */ | ||
} | ||
} | ||
``` | ||
|
||
При запросе к конкретному контейнеру — стили применятся, если компонент находится именно в нём. Если не указывать имя контейнера, возьмётся ближайший, а если такового нет, выражение от контейнера не будет работать. |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Нужно будет добавить дескрипшен и связанные статьи (
related
).