-
Notifications
You must be signed in to change notification settings - Fork 706
Добавляет доки про псевдоклассы :past, :current & :future
#6028
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
Open
DrakesBot12
wants to merge
7
commits into
doka-guide:main
Choose a base branch
from
DrakesBot12:css/past-current-future
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
Show all changes
7 commits
Select commit
Hold shift + click to select a range
b8f4524
docs: past-current-future
DrakesBot12 ecc652d
add
DrakesBot12 64c1c49
Merge remote-tracking branch 'origin/main' into HEAD
solarrust 8293937
Обновляет ветку для прогона проверок
solarrust 3bc1836
Merge remote-tracking branch 'origin/main' into fix/6028
solarrust 19e6714
Merge branch 'main' into css/past-current-future
vitya-ne ee3d6da
Добавляет конфиги baseline
vitya-ne 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 hidden or 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,110 @@ | ||
| --- | ||
| title: "`:current`" | ||
| description: "Выбирает элемент, который сейчас активен или отображается в последовательности, например текущие субтитры или результат поиска." | ||
| authors: | ||
| - drakesbot12 | ||
| keywords: | ||
| - current | ||
| - псевдокласс | ||
| - WebVTT | ||
| - субтитры | ||
| - поиск по странице | ||
| related: | ||
| - css/current | ||
| - css/past | ||
| - html/video | ||
| tags: | ||
| - doka | ||
| --- | ||
|
|
||
| ## Кратко | ||
|
|
||
| Псевдокласс `:current` выбирает элемент, который **сейчас находится в активном состоянии отображения или выделения**. | ||
|
|
||
| Он используется в так называемых **time-dimensional selectors*- и других сценариях, где есть “текущий элемент” в последовательности. | ||
|
|
||
| Чаще всего встречается в контекстах: | ||
| - WebVTT субтитров | ||
| - поиска по странице (Find in Page) | ||
| - выделенных элементов в последовательностях | ||
|
|
||
| ## Пример | ||
|
|
||
| ### Стили для текущих субтитров | ||
|
|
||
| ```css | ||
| :current(p, span) { | ||
| background-color: #ffe600; | ||
| } | ||
| ``` | ||
|
|
||
| ```html | ||
| <video controls> | ||
| <source src="video.mp4" type="video/mp4" /> | ||
| <track | ||
| label="English" | ||
| kind="subtitles" | ||
| srclang="en" | ||
| src="subtitles.vtt" | ||
| default> | ||
| </video> | ||
| ``` | ||
|
|
||
| ### Стили для поиска по странице | ||
|
|
||
| ```css | ||
| p::search-text { | ||
| background-color: purple; | ||
| color: white; | ||
| } | ||
|
|
||
| p::search-text:current { | ||
| background-color: crimson; | ||
| text-decoration: underline; | ||
| } | ||
| ``` | ||
|
|
||
| ## Как пишется | ||
|
|
||
| Псевдокласс `:current` используется как обычный селектор: | ||
|
|
||
| ```css | ||
| :current { | ||
| /* стили для текущего элемента */ | ||
| } | ||
| ``` | ||
|
|
||
| Также может принимать уточнение через селектор: | ||
|
|
||
| ```css | ||
| :current(<selector-list>) { | ||
| /* стили для текущего элемента */ | ||
| } | ||
| ``` | ||
|
|
||
| --- | ||
|
|
||
| ## Как понять | ||
|
|
||
| `:current` обозначает элемент, который **в данный момент активен в своей последовательности**. | ||
|
|
||
| Это может означать: | ||
| - текущий отображаемый фрагмент субтитров | ||
| - активный результат поиска в браузере | ||
| - выделенный элемент в последовательности контента | ||
|
|
||
| Он часто используется вместе с: | ||
| - [`:past`](/css/past/) | ||
| - [`:future`](/css/future/) | ||
|
|
||
| <aside> | ||
|
|
||
| ⚠️ На данный момент свойство является экспериментальным свойством. не поддерживается ни одним браузером. | ||
|
|
||
| </aside> | ||
|
|
||
| ## Подсказки | ||
|
|
||
| 💡 `:current` особенно полезен для стилизации временных медиа (субтитров), где есть активный момент воспроизведения. | ||
| 💡 Может применяться не только к видео, но и к поисковым результатам через `::search-text`. | ||
| 💡 Почти всегда используется в паре с [`:past`](/css/past/) и [`:future`](/css/future/) для создания полного временного UX. |
This file contains hidden or 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,94 @@ | ||
| --- | ||
| title: "`:future`" | ||
| description: "Выбирает элементы, которые находятся в будущем относительно текущего состояния, например в субтитрах или временных треках." | ||
| baseline: | ||
| - group: time-relative-selectors | ||
| features: | ||
| - css.selectors.future | ||
| authors: | ||
| - drakesbot12 | ||
| keywords: | ||
| - future | ||
| - псевдокласс | ||
| - WebVTT | ||
| - субтитры | ||
| - видео | ||
| related: | ||
| - css/current | ||
| - css/past | ||
| - html/video | ||
| tags: | ||
| - doka | ||
| --- | ||
|
|
||
| ## Кратко | ||
|
|
||
| Псевдокласс `:future` выбирает элементы, которые находятся **после текущего активного состояния** в временной последовательности. | ||
|
|
||
| Он относится к так называемым **time-dimensional selectors** — селекторам, работающим с временными потоками (например, субтитрами или медиа). | ||
|
|
||
| Чаще всего используется в контексте: | ||
| - [`<video>`](/html/video/) | ||
| - WebVTT субтитров | ||
| - временных треков | ||
|
|
||
| ## Пример | ||
|
|
||
| В этом примере скрываются ещё не показанные субтитры: | ||
|
|
||
| ```css | ||
| :future { | ||
| opacity: 0.3; | ||
| } | ||
| ``` | ||
|
|
||
| ```html | ||
| <video controls> | ||
| <source src="video.mp4" type="video/mp4" /> | ||
| <track | ||
| label="English" | ||
| kind="subtitles" | ||
| srclang="en" | ||
| src="subtitles.vtt" | ||
| default> | ||
| </video> | ||
| ``` | ||
|
|
||
| ## Как пишется | ||
|
|
||
| Псевдокласс `:future` используется как обычный CSS-селектор: | ||
|
|
||
| ```css | ||
| :future { | ||
| /* стили для элементов в будущем */ | ||
| } | ||
| ``` | ||
|
|
||
| Также может комбинироваться с другими селекторами: | ||
|
|
||
| ```css | ||
| video::cue(:future) { | ||
| opacity: 0.2; | ||
| } | ||
| ``` | ||
|
|
||
| ## Как понять | ||
|
|
||
| Временные медиапотоки (например, субтитры) делятся на три состояния: | ||
|
|
||
| - [`:past`](/css/past/) — уже было показано | ||
| - [`:current`](/css/current/) — показывается сейчас | ||
| - `:future` — ещё не достигнуто | ||
|
|
||
| `:future` позволяет стилизовать элементы, которые **ещё не появились в текущем времени воспроизведения**. | ||
|
|
||
| Это полезно для: | ||
| - визуального “приглушения” будущих субтитров | ||
| - создания эффекта прогресса текста | ||
| - интерфейсов с временной навигацией | ||
|
|
||
| ## Подсказки | ||
|
|
||
| 💡 `:future` почти всегда используется вместе с [`:current`](/css/current/) и [`:past`](/css/past/), чтобы визуально разделять временные состояния. | ||
| 💡 Подходит для эффектов “кинематографичных” субтитров — когда текст постепенно появляется. | ||
| 💡 Работает только в ограниченных контекстах (в основном WebVTT и медиа-потоки), а не в обычной вёрстке HTML. | ||
This file contains hidden or 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
This file contains hidden or 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,92 @@ | ||
| --- | ||
| title: "`:past`" | ||
| description: "Выбирает элементы, которые находятся в прошлом относительно текущего состояния, например в субтитрах или временных треках." | ||
| baseline: | ||
| - group: time-relative-selectors | ||
| features: | ||
| - css.selectors.past | ||
| authors: | ||
| - drakesbot12 | ||
| keywords: | ||
| - past | ||
| - псевдокласс | ||
| - WebVTT | ||
| - субтитры | ||
| - видео | ||
| related: | ||
| - css/current | ||
| - css/future | ||
| - html/video | ||
| tags: | ||
| - doka | ||
| --- | ||
|
|
||
| ## Кратко | ||
|
|
||
| Псевдокласс `:past` выбирает элементы, которые находятся **до текущего активного состояния** в временной последовательности. | ||
|
|
||
| Он используется в так называемых **time-dimensional selectors** — селекторах, которые работают с временем (например, в субтитрах или медиа). | ||
|
|
||
| Чаще всего встречается в контексте: | ||
| - [`<video>`](/html/video/) | ||
| - WebVTT субтитров | ||
| - временных треков | ||
|
|
||
| ## Пример | ||
|
|
||
| В этом примере скрываются уже “проигранные” субтитры: | ||
|
|
||
| ```css | ||
| :past(p, span) { | ||
| display: none; | ||
| } | ||
| ``` | ||
|
|
||
| ```html | ||
| <video controls> | ||
| <track | ||
| label="English" | ||
| kind="subtitles" | ||
| srclang="en" | ||
| src="subtitles.vtt" | ||
| default> | ||
| </video> | ||
| ``` | ||
|
|
||
| ## Как пишется | ||
|
|
||
| Псевдокласс `:past` используется как обычный селектор: | ||
|
|
||
| ```css | ||
| :past { | ||
| /* стили для элементов в прошлом */ | ||
| } | ||
| ``` | ||
|
|
||
| Также может комбинироваться с другими селекторами: | ||
|
|
||
| ```css | ||
| video::cue(:past) { | ||
| opacity: 0.5; | ||
| } | ||
| ``` | ||
|
|
||
|
Contributor
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Тут тоже стоит добавить описание варианта со скобками: |
||
| ## Как понять | ||
|
|
||
| Временные медиапотоки (например, субтитры) делятся на состояния: | ||
| - [`:future`](/css/future/) — ещё не показано | ||
| - [`:current`](/css/current/) — показывается сейчас | ||
| - `:past` — уже было показано | ||
|
|
||
| `:past` позволяет стилизовать элементы, которые **уже прошли в потоке воспроизведения**. | ||
|
|
||
| Это полезно для: | ||
| - затемнения уже прочитанных субтитров | ||
| - визуализации прогресса текста | ||
| - создания эффектов “истории воспроизведения” | ||
|
|
||
| ## Подсказки | ||
|
|
||
| 💡 Чаще всего `:past` используется вместе с [`:current`](/css/current/) и [`:future`](/css/future/), чтобы создать визуальную шкалу времени. | ||
| 💡 Работает только в специфических контекстах (например, WebVTT), а не для обычных HTML-элементов. | ||
| 💡 Поддержка ограничена — многие браузеры не реализуют time-dimensional pseudo-classes полностью. | ||
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.
не хватает описания варианта с доп. селекторами в скобках: