phlex 1.6.1 → 1.8.0

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.

This version of phlex might be problematic. Click here for more details.

Files changed (24) hide show
  1. checksums.yaml +4 -4
  2. data/.ruby-version +1 -1
  3. data/.yardopts +1 -0
  4. data/CHANGELOG.md +32 -0
  5. data/Gemfile +1 -0
  6. data/README.md +3 -43
  7. data/lib/phlex/black_hole.rb +1 -0
  8. data/lib/phlex/callable.rb +1 -0
  9. data/lib/phlex/context.rb +1 -0
  10. data/lib/phlex/deferred_render.rb +24 -0
  11. data/lib/phlex/element_clobbering_guard.rb +7 -8
  12. data/lib/phlex/elements.rb +38 -11
  13. data/lib/phlex/helpers.rb +21 -4
  14. data/lib/phlex/html/standard_elements.rb +193 -103
  15. data/lib/phlex/html/void_elements.rb +13 -12
  16. data/lib/phlex/html.rb +4 -6
  17. data/lib/phlex/overrides/symbol/name.rb +1 -0
  18. data/lib/phlex/sgml.rb +175 -64
  19. data/lib/phlex/svg/standard_elements.rb +128 -64
  20. data/lib/phlex/svg.rb +0 -4
  21. data/lib/phlex/unbuffered.rb +1 -0
  22. data/lib/phlex/version.rb +1 -1
  23. data/lib/phlex.rb +19 -6
  24. metadata +9 -7
data/lib/phlex/html/standard_elements.rb CHANGED
@@ -1,588 +1,678 @@
1
1
  # frozen_string_literal: true
2
2
 
3
+ # Standard HTML elements accept content and always have a closing tag.
3
4
  module Phlex::HTML::StandardElements
4
5
  extend Phlex::Elements
5
6
 
6
7
  # @!method a(**attributes, &content)
7
- # Outputs an <code>a</code> tag
8
+ # Outputs an `<a>` tag.
8
9
  # @return [nil]
10
+ # @yieldparam component [self]
9
11
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/a
10
12
  register_element :a, tag: "a"
11
13
 
12
14
  # @!method abbr(**attributes, &content)
13
- # Outputs an <code>abbr</code> tag
15
+ # Outputs an `<abbr>` tag.
14
16
  # @return [nil]
17
+ # @yieldparam component [self]
15
18
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/abbr
16
19
  register_element :abbr, tag: "abbr"
17
20
 
18
21
  # @!method address(**attributes, &content)
19
- # Outputs an <code>address</code> tag
22
+ # Outputs an `<address>` tag.
20
23
  # @return [nil]
24
+ # @yieldparam component [self]
21
25
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/address
22
26
  register_element :address, tag: "address"
23
27
 
24
28
  # @!method article(**attributes, &content)
25
- # Outputs an <code>article</code> tag
29
+ # Outputs an `<article>` tag.
26
30
  # @return [nil]
31
+ # @yieldparam component [self]
27
32
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/article
28
33
  register_element :article, tag: "article"
29
34
 
30
35
  # @!method aside(**attributes, &content)
31
- # Outputs an <code>aside</code> tag
36
+ # Outputs an `<aside>` tag.
32
37
  # @return [nil]
38
+ # @yieldparam component [self]
33
39
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/aside
34
40
  register_element :aside, tag: "aside"
35
41
 
36
42
  # @!method b(**attributes, &content)
37
- # Outputs a <code>b</code> tag
43
+ # Outputs a `<b>` tag.
38
44
  # @return [nil]
45
+ # @yieldparam component [self]
39
46
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/b
40
47
  register_element :b, tag: "b"
41
48
 
42
49
  # @!method bdi(**attributes, &content)
43
- # Outputs a <code>bdi</code> tag
50
+ # Outputs a `<bdi>` tag.
44
51
  # @return [nil]
52
+ # @yieldparam component [self]
45
53
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/bdi
46
54
  register_element :bdi, tag: "bdi"
47
55
 
48
56
  # @!method bdo(**attributes, &content)
49
- # Outputs a <code>bdo</code> tag
57
+ # Outputs a `<bdo>` tag.
50
58
  # @return [nil]
59
+ # @yieldparam component [self]
51
60
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/bdo
52
61
  register_element :bdo, tag: "bdo"
53
62
 
54
63
  # @!method blockquote(**attributes, &content)
55
- # Outputs a <code>blockquote</code> tag
64
+ # Outputs a `<blockquote>` tag.
56
65
  # @return [nil]
66
+ # @yieldparam component [self]
57
67
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/blockquote
58
68
  register_element :blockquote, tag: "blockquote"
59
69
 
60
70
  # @!method body(**attributes, &content)
61
- # Outputs a <code>body</code> tag
71
+ # Outputs a `<body>` tag.
62
72
  # @return [nil]
73
+ # @yieldparam component [self]
63
74
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/body
64
75
  register_element :body, tag: "body"
65
76
 
66
77
  # @!method button(**attributes, &content)
67
- # Outputs a <code>button</code> tag
78
+ # Outputs a `<button>` tag.
68
79
  # @return [nil]
80
+ # @yieldparam component [self]
69
81
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/button
70
82
  register_element :button, tag: "button"
71
83
 
72
84
  # @!method caption(**attributes, &content)
73
- # Outputs a <code>caption</code> tag
85
+ # Outputs a `<caption>` tag.
74
86
  # @return [nil]
87
+ # @yieldparam component [self]
75
88
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/caption
76
89
  register_element :caption, tag: "caption"
77
90
 
78
91
  # @!method cite(**attributes, &content)
79
- # Outputs a <code>cite</code> tag
92
+ # Outputs a `<cite>` tag.
80
93
  # @return [nil]
94
+ # @yieldparam component [self]
81
95
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/cite
82
96
  register_element :cite, tag: "cite"
83
97
 
84
98
  # @!method code(**attributes, &content)
85
- # Outputs a <code>code</code> tag
99
+ # Outputs a ``` tag.
86
100
  # @return [nil]
101
+ # @yieldparam component [self]
87
102
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/code
88
103
  register_element :code, tag: "code"
89
104
 
90
105
  # @!method colgroup(**attributes, &content)
91
- # Outputs a <code>colgroup</code> tag
106
+ # Outputs a `<colgroup>` tag.
92
107
  # @return [nil]
108
+ # @yieldparam component [self]
93
109
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/colgroup
94
110
  register_element :colgroup, tag: "colgroup"
95
111
 
96
112
  # @!method data(**attributes, &content)
97
- # Outputs a <code>data</code> tag
113
+ # Outputs a `<data>` tag.
98
114
  # @return [nil]
115
+ # @yieldparam component [self]
99
116
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/data
100
117
  register_element :data, tag: "data"
101
118
 
102
119
  # @!method datalist(**attributes, &content)
103
- # Outputs a <code>datalist</code> tag
120
+ # Outputs a `<datalist>` tag.
104
121
  # @return [nil]
122
+ # @yieldparam component [self]
105
123
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/datalist
106
124
  register_element :datalist, tag: "datalist"
107
125
 
108
126
  # @!method dd(**attributes, &content)
109
- # Outputs a <code>dd</code> tag
127
+ # Outputs a `<dd>` tag.
110
128
  # @return [nil]
129
+ # @yieldparam component [self]
111
130
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/dd
112
131
  register_element :dd, tag: "dd"
113
132
 
114
133
  # @!method del(**attributes, &content)
115
- # Outputs a <code>del</code> tag
134
+ # Outputs a `<del>` tag.
116
135
  # @return [nil]
136
+ # @yieldparam component [self]
117
137
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/del
118
138
  register_element :del, tag: "del"
119
139
 
120
140
  # @!method details(**attributes, &content)
121
- # Outputs a <code>details</code> tag
141
+ # Outputs a `<details>` tag.
122
142
  # @return [nil]
143
+ # @yieldparam component [self]
123
144
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/details
124
145
  register_element :details, tag: "details"
125
146
 
126
147
  # @!method dfn(**attributes, &content)
127
- # Outputs a <code>dfn</code> tag
148
+ # Outputs a `<dfn>` tag.
128
149
  # @return [nil]
150
+ # @yieldparam component [self]
129
151
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/dfn
130
152
  register_element :dfn, tag: "dfn"
131
153
 
132
154
  # @!method dialog(**attributes, &content)
133
- # Outputs a <code>dialog</code> tag
155
+ # Outputs a `<dialog>` tag.
134
156
  # @return [nil]
157
+ # @yieldparam component [self]
135
158
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/dialog
136
159
  register_element :dialog, tag: "dialog"
137
160
 
138
161
  # @!method div(**attributes, &content)
139
- # Outputs a <code>div</code> tag
162
+ # Outputs a `<div>` tag.
140
163
  # @return [nil]
164
+ # @yieldparam component [self]
141
165
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/div
142
166
  register_element :div, tag: "div"
143
167
 
144
168
  # @!method dl(**attributes, &content)
145
- # Outputs a <code>dl</code> tag
169
+ # Outputs a `<dl>` tag.
146
170
  # @return [nil]
171
+ # @yieldparam component [self]
147
172
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/dl
148
173
  register_element :dl, tag: "dl"
149
174
 
150
175
  # @!method dt(**attributes, &content)
151
- # Outputs a <code>dt</code> tag
176
+ # Outputs a `<dt>` tag.
152
177
  # @return [nil]
178
+ # @yieldparam component [self]
153
179
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/dt
154
180
  register_element :dt, tag: "dt"
155
181
 
156
182
  # @!method em(**attributes, &content)
157
- # Outputs an <code>em</code> tag
183
+ # Outputs an `<em>` tag.
158
184
  # @return [nil]
185
+ # @yieldparam component [self]
159
186
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/em
160
187
  register_element :em, tag: "em"
161
188
 
162
189
  # @!method fieldset(**attributes, &content)
163
- # Outputs a <code>fieldset</code> tag
190
+ # Outputs a `<fieldset>` tag.
164
191
  # @return [nil]
192
+ # @yieldparam component [self]
165
193
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/fieldset
166
194
  register_element :fieldset, tag: "fieldset"
167
195
 
168
196
  # @!method figcaption(**attributes, &content)
169
- # Outputs a <code>figcaption</code> tag
197
+ # Outputs a `<figcaption>` tag.
170
198
  # @return [nil]
199
+ # @yieldparam component [self]
171
200
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/figcaption
172
201
  register_element :figcaption, tag: "figcaption"
173
202
 
174
203
  # @!method figure(**attributes, &content)
175
- # Outputs a <code>figure</code> tag
204
+ # Outputs a `<figure>` tag.
176
205
  # @return [nil]
206
+ # @yieldparam component [self]
177
207
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/figure
178
208
  register_element :figure, tag: "figure"
179
209
 
180
210
  # @!method footer(**attributes, &content)
181
- # Outputs a <code>footer</code> tag
211
+ # Outputs a `<footer>` tag.
182
212
  # @return [nil]
213
+ # @yieldparam component [self]
183
214
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/footer
184
215
  register_element :footer, tag: "footer"
185
216
 
186
217
  # @!method form(**attributes, &content)
187
- # Outputs a <code>form</code> tag
218
+ # Outputs a `<form>` tag.
188
219
  # @return [nil]
220
+ # @yieldparam component [self]
189
221
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/form
190
222
  register_element :form, tag: "form"
191
223
 
192
224
  # @!method h1(**attributes, &content)
193
- # Outputs an <code>h1</code> tag
225
+ # Outputs an `<h1>` tag.
194
226
  # @return [nil]
227
+ # @yieldparam component [self]
195
228
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/h1
196
229
  register_element :h1, tag: "h1"
197
230
 
198
231
  # @!method h2(**attributes, &content)
199
- # Outputs an <code>h2</code> tag
232
+ # Outputs an `<h2>` tag.
200
233
  # @return [nil]
234
+ # @yieldparam component [self]
201
235
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/h2
202
236
  register_element :h2, tag: "h2"
203
237
 
204
238
  # @!method h3(**attributes, &content)
205
- # Outputs an <code>h3</code> tag
239
+ # Outputs an `<h3>` tag.
206
240
  # @return [nil]
241
+ # @yieldparam component [self]
207
242
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/h3
208
243
  register_element :h3, tag: "h3"
209
244
 
210
245
  # @!method h4(**attributes, &content)
211
- # Outputs an <code>h4</code> tag
246
+ # Outputs an `<h4>` tag.
212
247
  # @return [nil]
248
+ # @yieldparam component [self]
213
249
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/h4
214
250
  register_element :h4, tag: "h4"
215
251
 
216
252
  # @!method h5(**attributes, &content)
217
- # Outputs an <code>h5</code> tag
253
+ # Outputs an `<h5>` tag.
218
254
  # @return [nil]
255
+ # @yieldparam component [self]
219
256
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/h5
220
257
  register_element :h5, tag: "h5"
221
258
 
222
259
  # @!method h6(**attributes, &content)
223
- # Outputs an <code>h6</code> tag
260
+ # Outputs an `<h6>` tag.
224
261
  # @return [nil]
262
+ # @yieldparam component [self]
225
263
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/h6
226
264
  register_element :h6, tag: "h6"
227
265
 
228
266
  # @!method head(**attributes, &content)
229
- # Outputs a <code>head</code> tag
267
+ # Outputs a `<head>` tag.
230
268
  # @return [nil]
269
+ # @yieldparam component [self]
231
270
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/head
232
271
  register_element :head, tag: "head"
233
272
 
234
273
  # @!method header(**attributes, &content)
235
- # Outputs a <code>header</code> tag
274
+ # Outputs a `<header>` tag.
236
275
  # @return [nil]
276
+ # @yieldparam component [self]
237
277
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/header
238
278
  register_element :header, tag: "header"
239
279
 
240
280
  # @!method hgroup(**attributes, &content)
241
- # Outputs a <code>hgroup</code> tag
281
+ # Outputs a `<hgroup>` tag.
242
282
  # @return [nil]
283
+ # @yieldparam component [self]
243
284
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/hgroup
244
285
  register_element :hgroup, tag: "hgroup"
245
286
 
246
287
  # @!method html(**attributes, &content)
247
- # Outputs a <code>html</code> tag
288
+ # Outputs a `<html>` tag.
248
289
  # @return [nil]
290
+ # @yieldparam component [self]
249
291
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/html
250
292
  register_element :html, tag: "html"
251
293
 
252
294
  # @!method i(**attributes, &content)
253
- # Outputs an <code>i</code> tag
295
+ # Outputs an `<i>` tag.
254
296
  # @return [nil]
297
+ # @yieldparam component [self]
255
298
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/i
256
299
  register_element :i, tag: "i"
257
300
 
258
301
  # @!method iframe(**attributes, &content)
259
- # Outputs an <code>iframe</code> tag
302
+ # Outputs an `<iframe>` tag.
260
303
  # @return [nil]
304
+ # @yieldparam component [self]
261
305
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/iframe
262
306
  register_element :iframe, tag: "iframe"
263
307
 
264
308
  # @!method ins(**attributes, &content)
265
- # Outputs an <code>ins</code> tag
309
+ # Outputs an `<ins>` tag.
266
310
  # @return [nil]
311
+ # @yieldparam component [self]
267
312
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/ins
268
313
  register_element :ins, tag: "ins"
269
314
 
270
315
  # @!method kbd(**attributes, &content)
271
- # Outputs a <code>kbd</code> tag
316
+ # Outputs a `<kbd>` tag.
272
317
  # @return [nil]
318
+ # @yieldparam component [self]
273
319
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/kbd
274
320
  register_element :kbd, tag: "kbd"
275
321
 
276
322
  # @!method label(**attributes, &content)
277
- # Outputs a <code>label</code> tag
323
+ # Outputs a `<label>` tag.
278
324
  # @return [nil]
325
+ # @yieldparam component [self]
279
326
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/label
280
327
  register_element :label, tag: "label"
281
328
 
282
329
  # @!method legend(**attributes, &content)
283
- # Outputs a <code>legend</code> tag
330
+ # Outputs a `<legend>` tag.
284
331
  # @return [nil]
332
+ # @yieldparam component [self]
285
333
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/legend
286
334
  register_element :legend, tag: "legend"
287
335
 
288
336
  # @!method li(**attributes, &content)
289
- # Outputs a <code>li</code> tag
337
+ # Outputs a `<li>` tag.
290
338
  # @return [nil]
339
+ # @yieldparam component [self]
291
340
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/li
292
341
  register_element :li, tag: "li"
293
342
 
294
343
  # @!method main(**attributes, &content)
295
- # Outputs a <code>main</code> tag
344
+ # Outputs a `<main>` tag.
296
345
  # @return [nil]
346
+ # @yieldparam component [self]
297
347
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/main
298
348
  register_element :main, tag: "main"
299
349
 
300
350
  # @!method map(**attributes, &content)
301
- # Outputs a <code>map</code> tag
351
+ # Outputs a `<map>` tag.
302
352
  # @return [nil]
353
+ # @yieldparam component [self]
303
354
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/map
304
355
  register_element :map, tag: "map"
305
356
 
306
357
  # @!method mark(**attributes, &content)
307
- # Outputs a <code>mark</code> tag
358
+ # Outputs a `<mark>` tag.
308
359
  # @return [nil]
360
+ # @yieldparam component [self]
309
361
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/mark
310
362
  register_element :mark, tag: "mark"
311
363
 
312
- # @!method menuitem(**attributes, &content)
313
- # Outputs a <code>menuitem</code> tag
314
- # @return [nil]
315
- # @see https://developer.mozilla.org/docs/Web/HTML/Element/menuitem
316
- # @deprecated
317
- register_element :menuitem, tag: "menuitem"
318
-
319
364
  # @!method meter(**attributes, &content)
320
- # Outputs a <code>meter</code> tag
365
+ # Outputs a `<meter>` tag.
321
366
  # @return [nil]
367
+ # @yieldparam component [self]
322
368
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/meter
323
369
  register_element :meter, tag: "meter"
324
370
 
325
371
  # @!method nav(**attributes, &content)
326
- # Outputs a <code>nav</code> tag
372
+ # Outputs a `<nav>` tag.
327
373
  # @return [nil]
374
+ # @yieldparam component [self]
328
375
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/nav
329
376
  register_element :nav, tag: "nav"
330
377
 
331
378
  # @!method noscript(**attributes, &content)
332
- # Outputs a <code>noscript</code> tag
379
+ # Outputs a `<noscript>` tag.
333
380
  # @return [nil]
381
+ # @yieldparam component [self]
334
382
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/noscript
335
383
  register_element :noscript, tag: "noscript"
336
384
 
337
385
  # @!method object(**attributes, &content)
338
- # Outputs an <code>object</code> tag
386
+ # Outputs an `<object>` tag.
339
387
  # @return [nil]
388
+ # @yieldparam component [self]
340
389
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/object
341
390
  register_element :object, tag: "object"
342
391
 
343
392
  # @!method ol(**attributes, &content)
344
- # Outputs an <code>ol</code> tag
393
+ # Outputs an `<ol>` tag.
345
394
  # @return [nil]
395
+ # @yieldparam component [self]
346
396
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/ol
347
397
  register_element :ol, tag: "ol"
348
398
 
349
399
  # @!method optgroup(**attributes, &content)
350
- # Outputs an <code>optgroup</code> tag
400
+ # Outputs an `<optgroup>` tag.
351
401
  # @return [nil]
402
+ # @yieldparam component [self]
352
403
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/optgroup
353
404
  register_element :optgroup, tag: "optgroup"
354
405
 
355
406
  # @!method option(**attributes, &content)
356
- # Outputs an <code>option</code> tag
407
+ # Outputs an `<option>` tag.
357
408
  # @return [nil]
409
+ # @yieldparam component [self]
358
410
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/option
359
411
  register_element :option, tag: "option"
360
412
 
361
413
  # @!method output(**attributes, &content)
362
- # Outputs an <code>output</code> tag
414
+ # Outputs an `<output>` tag.
363
415
  # @return [nil]
416
+ # @yieldparam component [self]
364
417
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/output
365
418
  register_element :output, tag: "output"
366
419
 
367
420
  # @!method p(**attributes, &content)
368
- # Outputs a <code>p</code> tag
421
+ # Outputs a `<p>` tag.
369
422
  # @return [nil]
423
+ # @yieldparam component [self]
370
424
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/p
371
425
  register_element :p, tag: "p"
372
426
 
373
427
  # @!method picture(**attributes, &content)
374
- # Outputs a <code>picture</code> tag
428
+ # Outputs a `<picture>` tag.
375
429
  # @return [nil]
430
+ # @yieldparam component [self]
376
431
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/picture
377
432
  register_element :picture, tag: "picture"
378
433
 
379
434
  # @!method pre(**attributes, &content)
380
- # Outputs a <code>pre</code> tag
435
+ # Outputs a `<pre>` tag.
381
436
  # @return [nil]
437
+ # @yieldparam component [self]
382
438
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/pre
383
439
  register_element :pre, tag: "pre"
384
440
 
385
441
  # @!method progress(**attributes, &content)
386
- # Outputs a <code>progress</code> tag
442
+ # Outputs a `<progress>` tag.
387
443
  # @return [nil]
444
+ # @yieldparam component [self]
388
445
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/progress
389
446
  register_element :progress, tag: "progress"
390
447
 
391
448
  # @!method q(**attributes, &content)
392
- # Outputs a <code>q</code> tag
449
+ # Outputs a `<q>` tag.
393
450
  # @return [nil]
451
+ # @yieldparam component [self]
394
452
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/q
395
453
  register_element :q, tag: "q"
396
454
 
397
455
  # @!method rp(**attributes, &content)
398
- # Outputs a <code>rp</code> tag
456
+ # Outputs a `<rp>` tag.
399
457
  # @return [nil]
458
+ # @yieldparam component [self]
400
459
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/rp
401
460
  register_element :rp, tag: "rp"
402
461
 
403
462
  # @!method rt(**attributes, &content)
404
- # Outputs a <code>rt</code> tag
463
+ # Outputs a `<rt>` tag.
405
464
  # @return [nil]
465
+ # @yieldparam component [self]
406
466
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/rt
407
467
  register_element :rt, tag: "rt"
408
468
 
409
469
  # @!method ruby(**attributes, &content)
410
- # Outputs a <code>ruby</code> tag
470
+ # Outputs a `<ruby>` tag.
411
471
  # @return [nil]
472
+ # @yieldparam component [self]
412
473
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/ruby
413
474
  register_element :ruby, tag: "ruby"
414
475
 
415
476
  # @!method s(**attributes, &content)
416
- # Outputs a <code>s</code> tag
477
+ # Outputs a `<s>` tag.
417
478
  # @return [nil]
479
+ # @yieldparam component [self]
418
480
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/s
419
481
  register_element :s, tag: "s"
420
482
 
421
483
  # @!method samp(**attributes, &content)
422
- # Outputs a <code>samp</code> tag
484
+ # Outputs a `<samp>` tag.
423
485
  # @return [nil]
486
+ # @yieldparam component [self]
424
487
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/samp
425
488
  register_element :samp, tag: "samp"
426
489
 
427
490
  # @!method script(**attributes, &content)
428
- # Outputs a <code>script</code> tag
491
+ # Outputs a `<script>` tag.
429
492
  # @return [nil]
493
+ # @yieldparam component [self]
430
494
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/script
431
495
  register_element :script, tag: "script"
432
496
 
433
497
  # @!method section(**attributes, &content)
434
- # Outputs a <code>section</code> tag
498
+ # Outputs a `<section>` tag.
435
499
  # @return [nil]
500
+ # @yieldparam component [self]
436
501
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/section
437
502
  register_element :section, tag: "section"
438
503
 
439
504
  # @!method select(**attributes, &content)
440
- # Outputs a <code>select</code> tag
505
+ # Outputs a `<select>` tag.
441
506
  # @return [nil]
507
+ # @yieldparam component [self]
442
508
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/select
443
509
  register_element :select, tag: "select"
444
510
 
445
511
  # @!method slot(**attributes, &content)
446
- # Outputs a <code>slot</code> tag
512
+ # Outputs a `<slot>` tag.
447
513
  # @return [nil]
514
+ # @yieldparam component [self]
448
515
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/slot
449
516
  register_element :slot, tag: "slot"
450
517
 
451
518
  # @!method small(**attributes, &content)
452
- # Outputs a <code>small</code> tag
519
+ # Outputs a `<small>` tag.
453
520
  # @return [nil]
521
+ # @yieldparam component [self]
454
522
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/small
455
523
  register_element :small, tag: "small"
456
524
 
457
525
  # @!method span(**attributes, &content)
458
- # Outputs a <code>span</code> tag
526
+ # Outputs a `<span>` tag.
459
527
  # @return [nil]
528
+ # @yieldparam component [self]
460
529
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/span
461
530
  register_element :span, tag: "span"
462
531
 
463
532
  # @!method strong(**attributes, &content)
464
- # Outputs a <code>strong</code> tag
533
+ # Outputs a `<strong>` tag.
465
534
  # @return [nil]
535
+ # @yieldparam component [self]
466
536
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/strong
467
537
  register_element :strong, tag: "strong"
468
538
 
469
539
  # @!method style(**attributes, &content)
470
- # Outputs a <code>style</code> tag
540
+ # Outputs a `<style>` tag.
471
541
  # @return [nil]
542
+ # @yieldparam component [self]
472
543
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/style
473
544
  register_element :style, tag: "style"
474
545
 
475
546
  # @!method sub(**attributes, &content)
476
- # Outputs a <code>sub</code> tag
547
+ # Outputs a `<sub>` tag.
477
548
  # @return [nil]
549
+ # @yieldparam component [self]
478
550
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/sub
479
551
  register_element :sub, tag: "sub"
480
552
 
481
553
  # @!method summary(**attributes, &content)
482
- # Outputs a <code>summary</code> tag
554
+ # Outputs a `<summary>` tag.
483
555
  # @return [nil]
556
+ # @yieldparam component [self]
484
557
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/summary
485
558
  register_element :summary, tag: "summary"
486
559
 
487
560
  # @!method sup(**attributes, &content)
488
- # Outputs a <code>sup</code> tag
561
+ # Outputs a `<sup>` tag.
489
562
  # @return [nil]
563
+ # @yieldparam component [self]
490
564
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/sup
491
565
  register_element :sup, tag: "sup"
492
566
 
493
567
  # @!method svg(**attributes, &content)
494
- # Outputs a <code>svg</code> tag
568
+ # Outputs an `<svg>` tag.
495
569
  # @return [nil]
570
+ # @yieldparam component [self]
496
571
  # @see https://developer.mozilla.org/en-US/docs/Web/SVG/Element/svg
497
572
  register_element :svg, tag: "svg"
498
573
 
499
574
  # @!method table(**attributes, &content)
500
- # Outputs a <code>table</code> tag
575
+ # Outputs a `<table>` tag.
501
576
  # @return [nil]
577
+ # @yieldparam component [self]
502
578
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/table
503
579
  register_element :table, tag: "table"
504
580
 
505
581
  # @!method tbody(**attributes, &content)
506
- # Outputs a <code>tbody</code> tag
582
+ # Outputs a `<tbody>` tag.
507
583
  # @return [nil]
584
+ # @yieldparam component [self]
508
585
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/tbody
509
586
  register_element :tbody, tag: "tbody"
510
587
 
511
588
  # @!method td(**attributes, &content)
512
- # Outputs a <code>td</code> tag
589
+ # Outputs a `<td>` tag.
513
590
  # @return [nil]
591
+ # @yieldparam component [self]
514
592
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/td
515
593
  register_element :td, tag: "td"
516
594
 
517
595
  # @!method template_tag(**attributes, &content)
518
- # Outputs a <code>template</code> tag
596
+ # Outputs a `<template>` tag.
519
597
  # @return [nil]
598
+ # @yieldparam component [self]
520
599
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/template
521
600
  register_element :template_tag, tag: "template"
522
601
 
523
602
  # @!method textarea(**attributes, &content)
524
- # Outputs a <code>textarea</code> tag
603
+ # Outputs a `<textarea>` tag.
525
604
  # @return [nil]
605
+ # @yieldparam component [self]
526
606
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/textarea
527
607
  register_element :textarea, tag: "textarea"
528
608
 
529
609
  # @!method tfoot(**attributes, &content)
530
- # Outputs a <code>tfoot</code> tag
610
+ # Outputs a `<tfoot>` tag.
531
611
  # @return [nil]
612
+ # @yieldparam component [self]
532
613
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/tfoot
533
614
  register_element :tfoot, tag: "tfoot"
534
615
 
535
616
  # @!method th(**attributes, &content)
536
- # Outputs a <code>th</code> tag
617
+ # Outputs a `<th>` tag.
537
618
  # @return [nil]
619
+ # @yieldparam component [self]
538
620
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/th
539
621
  register_element :th, tag: "th"
540
622
 
541
623
  # @!method thead(**attributes, &content)
542
- # Outputs a <code>thead</code> tag
624
+ # Outputs a `<thead>` tag.
543
625
  # @return [nil]
626
+ # @yieldparam component [self]
544
627
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/thead
545
628
  register_element :thead, tag: "thead"
546
629
 
547
630
  # @!method time(**attributes, &content)
548
- # Outputs a <code>time</code> tag
631
+ # Outputs a `<time>` tag.
549
632
  # @return [nil]
633
+ # @yieldparam component [self]
550
634
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/time
551
635
  register_element :time, tag: "time"
552
636
 
553
637
  # @!method title(**attributes, &content)
554
- # Outputs a <code>title</code> tag
638
+ # Outputs a `<title>` tag.
555
639
  # @return [nil]
640
+ # @yieldparam component [self]
556
641
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/title
557
642
  register_element :title, tag: "title"
558
643
 
559
644
  # @!method tr(**attributes, &content)
560
- # Outputs a <code>tr</code> tag
645
+ # Outputs a `<tr>` tag.
561
646
  # @return [nil]
647
+ # @yieldparam component [self]
562
648
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/tr
563
649
  register_element :tr, tag: "tr"
564
650
 
565
651
  # @!method u(**attributes, &content)
566
- # Outputs an <code>u</code> tag
652
+ # Outputs a `<u>` tag.
567
653
  # @return [nil]
654
+ # @yieldparam component [self]
568
655
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/u
569
656
  register_element :u, tag: "u"
570
657
 
571
658
  # @!method ul(**attributes, &content)
572
- # Outputs an <code>ul</code> tag
659
+ # Outputs a `<ul>` tag.
573
660
  # @return [nil]
661
+ # @yieldparam component [self]
574
662
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/ul
575
663
  register_element :ul, tag: "ul"
576
664
 
577
665
  # @!method video(**attributes, &content)
578
- # Outputs a <code>video</code> tag
666
+ # Outputs a `<video>` tag.
579
667
  # @return [nil]
668
+ # @yieldparam component [self]
580
669
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/video
581
670
  register_element :video, tag: "video"
582
671
 
583
672
  # @!method wbr(**attributes, &content)
584
- # Outputs a <code>wbr</code> tag
673
+ # Outputs a `<wbr>` tag.
585
674
  # @return [nil]
675
+ # @yieldparam component [self]
586
676
  # @see https://developer.mozilla.org/docs/Web/HTML/Element/wbr
587
677
  register_element :wbr, tag: "wbr"
588
678
  end