mirror of
https://github.com/classilla/tenfourfox.git
synced 2024-07-06 19:29:27 +00:00
89 lines
2.3 KiB
Markdown
89 lines
2.3 KiB
Markdown
Some test may require special user style sheets to be applied in order
|
|
for the case to be verified. In order for proper indications and
|
|
prerequisite to be displayed every user style sheet should contain the
|
|
following rules.
|
|
|
|
``` css
|
|
#user-stylesheet-indication
|
|
{
|
|
/* Used by the harness to display an indication there is a user
|
|
style sheet applied */
|
|
display: block!important;
|
|
}
|
|
```
|
|
|
|
The rule ```#user-stylesheet-indication``` is to be used by any
|
|
harness running the test suite.
|
|
|
|
A harness should identify test that need a user style sheet by
|
|
looking at their flags meta tag. It then should display appropriate
|
|
messages indicating if a style sheet is applied or if a style sheet
|
|
should not be applied.
|
|
|
|
Harness style sheet rules:
|
|
|
|
``` css
|
|
#userstyle
|
|
{
|
|
color: green;
|
|
display: none;
|
|
}
|
|
#nouserstyle
|
|
{
|
|
color: red;
|
|
display: none;
|
|
}
|
|
```
|
|
|
|
Harness userstyle flag found:
|
|
|
|
``` html
|
|
<p id="user-stylesheet-indication" class="userstyle">A user style
|
|
sheet is applied.</p>
|
|
```
|
|
|
|
Harness userstyle flag NOT found:
|
|
|
|
``` html
|
|
<p id="user-stylesheet-indication" class="nouserstyle">A user style
|
|
sheet is applied.</p>
|
|
```
|
|
|
|
Within the test case it is recommended that the case itself indicate
|
|
the necessary user style sheet that is required.
|
|
|
|
Examples: (code for the [`cascade.css`][cascade-css] file)
|
|
|
|
``` css
|
|
#cascade /* ID name should match user style sheet file name */
|
|
{
|
|
/* Used by the test to hide the prerequisite */
|
|
display: none;
|
|
}
|
|
```
|
|
|
|
The rule ```#cascade``` in the example above is used by the test
|
|
page to hide the prerequisite text. The rule name should match the
|
|
user style sheet CSS file name in order to keep this orderly.
|
|
|
|
Examples: (code for [the `cascade-###.xht` files][cascade-xht])
|
|
|
|
``` html
|
|
<p id="cascade">
|
|
PREREQUISITE: The <a href="support/cascade.css">
|
|
"cascade.css"</a> file is enabled as the user agent's user style
|
|
sheet.
|
|
</p>
|
|
```
|
|
|
|
The id value should match the user style sheet CSS file name and the
|
|
user style sheet rule that is used to hide this text when the style
|
|
sheet is properly applied.
|
|
|
|
Please flag test that require user style sheets with the userstyle
|
|
flag so people running the tests know that a user style sheet is
|
|
required.
|
|
|
|
[cascade-css]: https://github.com/w3c/csswg-test/blob/master/css21/cascade/support/cascade.css
|
|
[cascade-xht]: https://github.com/w3c/csswg-test/blob/master/css21/cascade/cascade-001.xht
|