Skip to content

Commit 20166c7

Browse files
committed
fix: standardize capitalization of "Level" in documentation
1 parent ac87105 commit 20166c7

3 files changed

Lines changed: 9 additions & 8 deletions

File tree

src/content/docs/basics/levels.mdx

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,18 +9,19 @@ head:
99
---
1010
The (preliminary) View Transition API's specification comes in two parts:
1111

12-
1312
* Level 1: *CSS View Transitions Module Level 1* (Editor's Draft) [https://drafts.csswg.org/css-view-transitions-1/](https://drafts.csswg.org/css-view-transitions-1/)
1413

1514
* Level 2: *CSS View Transitions Module Level 2* (Editor's Draft) [https://drafts.csswg.org/css-view-transitions-2/](https://drafts.csswg.org/css-view-transitions-2/)
1615

17-
Splitting the specification into two parts allows browser vendors to roll out the API incrementally.
16+
Nowadays, the Level 1 document is frozen, while the Level 2 document is still in development.
17+
18+
Splitting the specification into two parts allowed browser vendors to roll out the API incrementally.
1819

1920
You might often hear that
2021
* Level 1 is _same-document_ view transitions and
2122
* Level 2 defines _cross-document_ view transitions
2223

23-
It is a neat, memorable way to explain it. Halftrue, slightly wrong, but sticky enough to spread. Just do not forget: the real implications still hide in the details.
24+
It is a neat, memorable way to explain it. Half-true, slightly wrong, but sticky enough to spread. Just do not forget: the real implications still hide in the details.
2425

2526
I prefer to think of Level 1 as the core and Level 2 as the extensions.
2627

@@ -57,7 +58,7 @@ Part two indeed adds extensions for cross-document view transitions, but also fe
5758

5859
The new features defined in Level 2 of the view transition API are in deed written as extensions to the Level 1 spec. They can easily be merged into one specification. But the interesting part here is not the document structure but the implication from incremental releasing of the two parts.
5960

60-
Up to now, all vendors have implemented and released Level 1 first before they went on to Level2. For Chrome and Edge there was a period of over 12 month before level 2 got released. For Safari, it had been 3 month. Firefox just released Level 1 of the API as it is part of Interop 2025. It's unclear when Level 2 will be released.
61+
Up to now, all vendors have implemented and released Level 1 first before they went on to Level 2. For Chrome and Edge there was a period of over 12 month before Level 2 got released. For Safari, it had been 3 month. Firefox released Level 1 of the API last year, as it was part of Interop 2025. It's unclear when Level 2 will be released.
6162

6263
For the Chromium based browsers, this was not a problem as when they released Level 1 support there where no other browsers that understood Level 2. When Safari came out, this was different, but it did not take that lon for them to deliver Level 2 after that.
6364

src/content/docs/basics/styling.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ import { Steps } from "@astrojs/starlight/components";
1212

1313
The animations introduced by the View Transition API are controlled by CSS rules. The way to make the animations fit your expectations is to alter the [default animation](/basics/default-animations/) by overriding the styles for the [pseudo elements](/basics/pseudos/).
1414

15-
To do this efficiently you should know what the View Transition API defines as defaults and how to easily change these styles if needed. To simplify styling, level 2 of the API introduced helpers in form of the `view-transition-class` property and the `:active-view-transition...` pseudo-classes.
15+
To do this efficiently you should know what the View Transition API defines as defaults and how to easily change these styles if needed. To simplify styling, Level 2 of the API introduced helpers in form of the `view-transition-class` property and the `:active-view-transition...` pseudo-classes.
1616

1717
## Styling Tasks for View Transitions
1818

src/content/docs/vtbag.mdx

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -74,16 +74,16 @@ Remember a tech-demo, but not where it is buried on this site? Open the _All Tec
7474

7575
@vtbag is all about the View Transition API. Find out [more about this browser API](/basics/api/).
7676

77-
The content part of this site is build with [Starlight](https://starlight.astro.build/). The view transitions featured on this site and tech demos are independent of Astro. They only use the View Transition API and require browsers with native support for it. Cross document effects need a [level 2 compliant browser](https://events-3bg.pages.dev/jotter/api/test-page/).
77+
The content part of this site is build with [Starlight](https://starlight.astro.build/). The view transitions featured on this site and tech demos are independent of Astro. They only use the View Transition API and require browsers with native support for it. Cross document effects need a [Level 2 compliant browser](https://events-3bg.pages.dev/jotter/api/test-page/).
7878

7979
## Relation to astro-vtbot
8080

81-
Some of you might be familiar with [astro-vtbot](https://events-3bg.pages.dev), the big sister, or at least the spiritual predecessor, of `@vtbag`: Even when the same-document (level 1) View Transition API in Chrome was only accessible behind a flag, the Astro project had already anticipated parts of the level 2 specification, enabling cross-document view transitions for MPAs. Of course, Astro's client-side router isn't technically comparable to level 2 view transitions and has its own challenges in handling scripts and state, but it allowed many users to experiment early and build expertise in view transitions.
81+
Some of you might be familiar with [astro-vtbot](https://events-3bg.pages.dev), the big sister, or at least the spiritual predecessor, of `@vtbag`: Even when the same-document (Level 1) View Transition API in Chrome was only accessible behind a flag, the Astro project had already anticipated parts of the Level 2 specification, enabling cross-document view transitions for MPAs. Of course, Astro's client-side router isn't technically comparable to Level 2 view transitions and has its own challenges in handling scripts and state, but it allowed many users to experiment early and build expertise in view transitions.
8282

8383
Astro-vtbot, as a community project, built on that foundation by offering technical demos, reusable components, and a wealth of tips and tricks for using view transitions in Astro projects.
8484

8585
## Another Bag of Tricks
86-
With the wider adoption of the view transition API and the introduction of level 2, cross-document transitions can now be defined purely with CSS, without the need for an additional client-side router. `@vtbag` is your go-to resource for framework-agnostic support around view transitions.
86+
With the wider adoption of the view transition API and the introduction of Level 2, cross-document transitions can now be defined purely with CSS, without the need for an additional client-side router. `@vtbag` is your go-to resource for framework-agnostic support around view transitions.
8787

8888
`@vtbag` inherits the concept of a Bag of Tricks from astro-vtbot: a diverse collection of tricks, tips, components, and tools. While astro-vtbot continues to focus on the specific needs of the Astro router, `@vtbag` aims at the view transition API in general, without being tied to any specific framework.
8989

0 commit comments

Comments
 (0)