Skip to content

[css-navigation-1] Add notes about redirects and with links to issues. #13181

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.

Sign up for GitHub

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
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

[css-navigation-1] Add notes about redirects and with links to issues. #13181

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
18 changes: 18 additions & 0 deletions css-navigation-1/Overview.bs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,8 @@ url: https://html.spec.whatwg.org/multipage/nav-history-apis.html#navigation-act
type: dfn; spec: html; text: activation;
url: https://html.spec.whatwg.org/multipage/browsing-the-web.html#has-been-revealed
type: dfn; spec: html; text: has been revealed;
url: https://drafts.csswg.org/css-view-transitions-1/#capture-the-image
type: dfn; spec: css-view-transitions-1; text: capture the image;
</pre>

<h2 id="at-route">Declaring named URL patterns: the ''@route'' rule</h2>
Expand Down Expand Up @@ -107,6 +109,9 @@ with the URL <code>"/movie-list"</code> resolved relative to the style sheet.

NOTE: The bracing syntax also allows for future expansion if needed.

NOTE: Some of the design discussion for this feature has been in
<a href="https://github.com/w3c/csswg-drafts/issues/12594">w3c/csswg-drafts#12594</a>.

<h2 id="conditional-navigation-queries">Conditional rules for navigation queries</h2>

<h3 id="at-navigation">Navigation queries: the ''@navigation'' rule</h3>
Expand Down Expand Up @@ -290,6 +295,11 @@ the result of the following steps on <var>document</var>:
The condition of the ''@navigation'' rule
is the result of the <<navigation-condition>> in its prelude.

NOTE: Some of the design discussion for this feature has been in
<a href="https://github.com/w3c/csswg-drafts/issues/12594">w3c/csswg-drafts#12594</a>
and
<a href="https://github.com/w3c/csswg-drafts/issues/8209">w3c/csswg-drafts#8209</a>.

<h3 id="navigation-when-function">The ''@when/navigation()'' function for ''@when''</h3>

This specification defines an additional function for the ''@when'' rule:
Expand Down Expand Up @@ -479,6 +489,9 @@ if the following steps return true:
the provided URL pattern,
and the from or to URL of the current navigation.

NOTE: Some of the design discussion for this feature has been in
<a href="https://github.com/w3c/csswg-drafts/issues/13163">w3c/csswg-drafts#13163</a>.

<h2 id="current-nav-urls">Current navigation URLs</h2>

Both the ''@navigation'' rule and the '':link-to()'' pseudo-class
Expand Down Expand Up @@ -525,6 +538,11 @@ It is defined as follows:

NOTE: This part <em>does</em> expose the result of redirects.

NOTE: This part is not relevant to normal page rendering.
However, it can be relevant to what is rendered
when [=capturing the image=]
for a [[css-view-transitions-2#cross-document-view-transitions|cross-document view transition]].

ISSUE: Is the final "non-null" check needed?

1. otherwise, the [=ongoing navigate event=]'s
Expand Down