Skip to content

Commit 4df32e3

Browse files
authored
[css-navigation-1] Drop non-useful descriptors and note possible future changes. (#13249)
1 parent 59281cf commit 4df32e3

File tree

1 file changed

+17
-2
lines changed

1 file changed

+17
-2
lines changed

css-navigation-1/Overview.bs

Lines changed: 17 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -57,8 +57,8 @@ based on the following definitions:
5757
<dfn><<pattern-descriptor>></dfn> = pattern : <<url-pattern()>>
5858
<dfn><<init-descriptors>></dfn> = ;* <<init-descriptor>> [ ;+ <<init-descriptor>> ]* ;*
5959
<dfn><<init-descriptor>></dfn> = <<init-descriptor-name>> : <<string>>
60-
<dfn><<init-descriptor-name>></dfn> = protocol | username | password | hostname | port
61-
pathname | search | hash | base-url
60+
<dfn><<init-descriptor-name>></dfn> = protocol | hostname | port | pathname |
61+
search | hash | base-url
6262
</pre>
6363

6464
This associates an author-defined keyword with a URL pattern,
@@ -89,6 +89,21 @@ for the route names?
8989
ISSUE: Is there value in being able to provide a list of <<url-pattern()>>
9090
rather than just one?
9191

92+
NOTE: The list of allowed init descriptors does not include <code>username</code>
93+
or <code>password</code> since they seem unlikely to be useful.
94+
95+
<div class="issue">
96+
It's possible that this syntax with init descriptors in the ''@route'' rule
97+
would make more sense as part of the ''urlpattern()'' function
98+
(that is, as an alternate syntax for what goes inside the function).
99+
100+
This would also give us the option to remove the braces from
101+
the syntax of the ''@route'' rule
102+
and make it more like ''@import'' or ''@namespace''.
103+
This does remove a potential future extensibility point,
104+
but it could also be added back later if we need it.
105+
</div>
106+
92107
<div class="example">
93108
Either this rule:
94109
<pre highlight=css>

0 commit comments

Comments
 (0)