blob: aacc868d48d438d1ed03986e3dec57c4d41385f6 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
|
CSS tests have some additional requirements for metadata.
### Specification Links
Specification Links
``` html
<link rel="help" href="RELEVANT_SPEC_SECTION" />
```
The specification link elements provide a way to align the test with
information in the specification being tested.
* Links should link to relevant sections within the specification
* Use the anchors from the specification's Table of Contents
* A test can have multiple specification links
* Always list the primary section that is being tested as the
first item in the list of specification links
* Order the list from the most used/specific to least used/specific
* There is no need to list common incidental features like the
color green if it is being used to validate the test unless the
case is specifically testing the color green
* If the test is part of multiple test suites, link to the relevant
sections of each spec.
Example 1:
``` html
<link rel="help"
href="http://www.w3.org/TR/CSS21/text.html#alignment-prop" />
```
Example 2:
``` html
<link rel="help"
href="http://www.w3.org/TR/CSS21/text.html#alignment-prop" />
<link rel="help" href="http://www.w3.org/TR/CSS21/visudet.html#q7" />
<link rel="help"
href="http://www.w3.org/TR/CSS21/visudet.html#line-height" />
<link rel="help"
href="http://www.w3.org/TR/CSS21/colors.html#background-properties" />
```
### Requirement Flags
<table>
<tr>
<th>Token</th>
<th>Description</th>
</tr>
<tr>
<td>ahem</td>
<td>Test requires
<a href="http://www.w3.org/Style/CSS/Test/Fonts/Ahem">Ahem font</a>
</td>
</tr>
<tr>
<td>animated</td>
<td>Test is animated in final state. (Cannot be verified using
reftests/screenshots.)</td>
</tr>
<tr>
<td>asis</td>
<td>The test has particular markup formatting requirements and
cannot be re-serialized.</td>
</tr>
<tr>
<td>combo</td>
<td>Test, which must have an unsuffixed filename number, is
strictly the union of all the suffixed tests with the same name
and number. (See File name format, below.)</td>
</tr>
<tr>
<td>dom</td>
<td>Requires support for JavaScript and the Document Object Model (
DOM)</td>
</tr>
<tr>
<td>font</td>
<td>Requires a specific font to be installed. (Details must be
provided and/or the font linked to in the test description)</td>
</tr>
<tr>
<td>history</td>
<td>User agent session history is required. Testing :visited is a
good example where this may be used.</td>
</tr>
<tr>
<td>HTMLonly</td>
<td>Test case is only valid for HTML</td>
</tr>
<tr>
<td>http</td>
<td>Requires HTTP headers</td>
</tr>
<tr>
<td>image</td>
<td>Requires support for bitmap graphics and the graphic to load
</td>
</tr>
<tr>
<td>interact</td>
<td>Requires human interaction (such as for testing scrolling
behavior)</td>
</tr>
<tr>
<td>invalid</td>
<td>Tests handling of invalid CSS. Note: This case contains CSS
properties and syntax that may not validate.</td>
</tr>
<tr>
<td>may</td>
<td>Behavior tested is preferred but OPTIONAL.
<a href="http://www.ietf.org/rfc/rfc2119.txt">[RFC2119]</a></td>
</tr>
<tr>
<td>namespace</td>
<td>Requires support for XML Namespaces</td>
</tr>
<tr>
<td>nonHTML</td>
<td>Test case is only valid for formats besides HTML (e.g. XHTML
or arbitrary XML)</td>
</tr>
<tr>
<td>paged</td>
<td>Only valid for paged media</td>
</tr>
<tr>
<td>scroll</td>
<td>Only valid for continuous (scrolling) media</td>
</tr>
<tr>
<td>should</td>
<td>Behavior tested is RECOMMENDED, but not REQUIRED. <a
href="http://www.ietf.org/rfc/rfc2119.txt">[RFC2119]</a></td>
</tr>
<tr>
<td>speech</td>
<td>Device supports audio output. Text-to-speech (TTS) engine
installed</td>
</tr>
<tr>
<td>svg</td>
<td>Requires support for vector graphics (SVG)</td>
</tr>
<tr>
<td>userstyle</td>
<td>Requires a user style sheet to be set</td>
</tr>
<tr>
<td>32bit</td>
<td>Assumes a 32-bit integer as the minimum (-2147483648) or
maximum (2147483647) value</td>
</tr>
<tr>
<td>96dpi</td>
<td>Assumes 96dpi display</td>
</tr>
</table>
Example 1 (one token applies):
``` html
<meta name="flags" content="invalid" />
```
Example 2 (multiple tokens apply):
``` html
<meta name="flags" content="ahem image scroll" />
```
Example 3 (no tokens apply):
``` html
<meta name="flags" content="" />
```
### Test Assertions
``` html
<meta name="assert" content="TEST ASSERTION" />
```
This element should contain a complete detailed statement expressing
what specifically the test is attempting to prove. If the assertion
is only valid in certain cases, those conditions should be described
in the statement.
The assertion should not be:
* A copy of the title text
* A copy of the test verification instructions
* A duplicate of another assertion in the test suite
* A line or reference from the CSS specification unless that line is
a complete assertion when taken out of context.
The test assertion is **optional**. It helps the reviewer understand
the goal of the test so that he or she can make sure it is being
tested correctly. Also, in case a problem is found with the test
later, the testing method (e.g. using `color` to determine pass/fail)
can be changed (e.g. to using `background-color`) while preserving
the intent of the test (e.g. testing support for ID selectors).
Examples of good test assertions:
* "This test checks that a background image with no intrinsic size
covers the entire padding box."
* "This test checks that 'word-spacing' affects each space (U+0020)
and non-breaking space (U+00A0)."
* "This test checks that if 'top' and 'bottom' offsets are specified
on an absolutely-positioned replaced element, then any remaining
space is split amongst the 'auto' vertical margins."
* "This test checks that 'text-indent' affects only the first line
of a block container if that line is also the first formatted line
of an element."
|
