blib/lib/Mojo/DOM.pm | |||
---|---|---|---|
Criterion | Covered | Total | % |
statement | 226 | 226 | 100.0 |
branch | 119 | 122 | 97.5 |
condition | 63 | 71 | 88.7 |
subroutine | 75 | 75 | 100.0 |
pod | 43 | 43 | 100.0 |
total | 526 | 537 | 97.9 |
line | stmt | bran | cond | sub | pod | time | code |
---|---|---|---|---|---|---|---|
1 | package Mojo::DOM; | ||||||
2 | 61 | 61 | 65112 | use Mojo::Base -strict; | |||
61 | 165 | ||||||
61 | 435 | ||||||
3 | use overload | ||||||
4 | 4 | 4 | 13 | '@{}' => sub { shift->child_nodes }, | |||
5 | 100 | 100 | 245 | '%{}' => sub { shift->attr }, | |||
6 | 387 | 387 | 6927 | bool => sub {1}, | |||
7 | 142 | 142 | 15900 | '""' => sub { shift->to_string }, | |||
8 | 61 | 61 | 497 | fallback => 1; | |||
61 | 162 | ||||||
61 | 931 | ||||||
9 | |||||||
10 | # "Fry: This snow is beautiful. I'm glad global warming never happened. | ||||||
11 | # Leela: Actually, it did. But thank God nuclear winter canceled it out." | ||||||
12 | 61 | 61 | 8315 | use Mojo::Collection; | |||
61 | 195 | ||||||
61 | 2784 | ||||||
13 | 61 | 61 | 31443 | use Mojo::DOM::CSS; | |||
61 | 478 | ||||||
61 | 539 | ||||||
14 | 61 | 61 | 28748 | use Mojo::DOM::HTML; | |||
61 | 249 | ||||||
61 | 3798 | ||||||
15 | 61 | 61 | 504 | use Scalar::Util qw(blessed weaken); | |||
61 | 157 | ||||||
61 | 3119 | ||||||
16 | 61 | 61 | 42340 | use Storable qw(dclone); | |||
61 | 205611 | ||||||
61 | 303423 | ||||||
17 | |||||||
18 | 28 | 28 | 1 | 81 | sub all_text { _text(_nodes($_[0]->tree), $_[0]->xml, 1) } | ||
19 | |||||||
20 | 15 | 15 | 1 | 53 | sub ancestors { _select($_[0]->_collect([_ancestors($_[0]->tree)]), $_[1]) } | ||
21 | |||||||
22 | 9 | 9 | 1 | 42 | sub append { shift->_add(1, @_) } | ||
23 | 13 | 13 | 1 | 52 | sub append_content { shift->_content(1, 0, @_) } | ||
24 | |||||||
25 | sub at { | ||||||
26 | 762 | 762 | 1 | 2324 | my $self = shift; | ||
27 | 762 | 100 | 1868 | return undef unless my $result = $self->_css->select_one(@_); | |||
28 | 692 | 4040 | return $self->_build($result, $self->xml); | ||||
29 | } | ||||||
30 | |||||||
31 | sub attr { | ||||||
32 | 181 | 181 | 1 | 324 | my $self = shift; | ||
33 | |||||||
34 | # Hash | ||||||
35 | 181 | 314 | my $tree = $self->tree; | ||||
36 | 181 | 100 | 528 | my $attrs = $tree->[0] ne 'tag' ? {} : $tree->[2]; | |||
37 | 181 | 100 | 1048 | return $attrs unless @_; | |||
38 | |||||||
39 | # Get | ||||||
40 | 48 | 100 | 100 | 391 | return $attrs->{$_[0]} unless @_ > 1 || ref $_[0]; | ||
41 | |||||||
42 | # Set | ||||||
43 | 4 | 100 | 24 | my $values = ref $_[0] ? $_[0] : {@_}; | |||
44 | 4 | 18 | @$attrs{keys %$values} = values %$values; | ||||
45 | |||||||
46 | 4 | 19 | return $self; | ||||
47 | } | ||||||
48 | |||||||
49 | 59 | 59 | 1 | 155 | sub child_nodes { $_[0]->_collect(_nodes($_[0]->tree)) } | ||
50 | |||||||
51 | 13 | 13 | 1 | 1925 | sub children { _select($_[0]->_collect(_nodes($_[0]->tree, 1)), $_[1]) } | ||
52 | |||||||
53 | sub content { | ||||||
54 | 59 | 59 | 1 | 126 | my $self = shift; | ||
55 | |||||||
56 | 59 | 126 | my $type = $self->type; | ||||
57 | 59 | 100 | 100 | 243 | if ($type eq 'root' || $type eq 'tag') { | ||
58 | 28 | 100 | 113 | return $self->_content(0, 1, @_) if @_; | |||
59 | 7 | 19 | my $html = Mojo::DOM::HTML->new(xml => $self->xml); | ||||
60 | 7 | 15 | return join '', map { $html->tree($_)->render } @{_nodes($self->tree)}; | ||||
12 | 28 | ||||||
7 | 16 | ||||||
61 | } | ||||||
62 | |||||||
63 | 31 | 100 | 79 | return $self->tree->[1] unless @_; | |||
64 | 3 | 9 | $self->tree->[1] = shift; | ||||
65 | 3 | 13 | return $self; | ||||
66 | } | ||||||
67 | |||||||
68 | 13 | 13 | 1 | 40 | sub descendant_nodes { $_[0]->_collect(_all(_nodes($_[0]->tree))) } | ||
69 | |||||||
70 | sub find { | ||||||
71 | 444 | 444 | 1 | 2608 | my $self = shift; | ||
72 | 444 | 1122 | return $self->_collect($self->_css->select(@_)); | ||||
73 | } | ||||||
74 | |||||||
75 | 8 | 8 | 1 | 27 | sub following { _select($_[0]->_collect(_siblings($_[0]->tree, 1, 1)), $_[1]) } | ||
76 | 7 | 7 | 1 | 19 | sub following_nodes { $_[0]->_collect(_siblings($_[0]->tree, 0, 1)) } | ||
77 | |||||||
78 | 44 | 44 | 1 | 103 | sub matches { shift->_css->matches(@_) } | ||
79 | |||||||
80 | sub namespace { | ||||||
81 | 18 | 18 | 1 | 49 | my $self = shift; | ||
82 | |||||||
83 | 18 | 100 | 38 | return undef if (my $tree = $self->tree)->[0] ne 'tag'; | |||
84 | |||||||
85 | # Extract namespace prefix and search parents | ||||||
86 | 16 | 100 | 79 | my $ns = $tree->[1] =~ /^(.*?):/ ? "xmlns:$1" : undef; | |||
87 | 16 | 36 | for my $node ($tree, _ancestors($tree)) { | ||||
88 | |||||||
89 | # Namespace for prefix | ||||||
90 | 35 | 56 | my $attrs = $node->[2]; | ||||
91 | 35 | 100 | 100 | 85 | if ($ns) { $_ eq $ns and return $attrs->{$_} for keys %$attrs } | ||
13 | 100 | 81 | |||||
92 | |||||||
93 | # Namespace attribute | ||||||
94 | 10 | 67 | elsif (defined $attrs->{xmlns}) { return $attrs->{xmlns} } | ||||
95 | } | ||||||
96 | |||||||
97 | 1 | 10 | return undef; | ||||
98 | } | ||||||
99 | |||||||
100 | sub new { | ||||||
101 | 2394 | 2394 | 1 | 336233 | my $class = shift; | ||
102 | 2394 | 66 | 5952 | my $self = bless \Mojo::DOM::HTML->new, ref $class || $class; | |||
103 | 2394 | 100 | 7706 | return @_ ? $self->parse(@_) : $self; | |||
104 | } | ||||||
105 | |||||||
106 | sub new_tag { | ||||||
107 | 11 | 11 | 1 | 2548 | my $self = shift; | ||
108 | 11 | 28 | my $new = $self->new; | ||||
109 | 11 | 48 | $$new->tag(@_); | ||||
110 | 11 | 100 | 31 | $$new->xml($$self->xml) if ref $self; | |||
111 | 11 | 50 | return $new; | ||||
112 | } | ||||||
113 | |||||||
114 | 13 | 13 | 1 | 30 | sub next { $_[0]->_maybe(_siblings($_[0]->tree, 1, 1, 0)) } | ||
115 | 5 | 5 | 1 | 14 | sub next_node { $_[0]->_maybe(_siblings($_[0]->tree, 0, 1, 0)) } | ||
116 | |||||||
117 | sub parent { | ||||||
118 | 48 | 48 | 1 | 91 | my $self = shift; | ||
119 | 48 | 50 | 94 | return undef if (my $tree = $self->tree)->[0] eq 'root'; | |||
120 | 48 | 106 | return $self->_build(_parent($tree), $self->xml); | ||||
121 | } | ||||||
122 | |||||||
123 | 260 | 50 | 260 | 1 | 447 | sub parse { ${$_[0]}->parse($_[1]) and return $_[0] } | |
260 | 1635 | ||||||
124 | |||||||
125 | 5 | 5 | 1 | 14 | sub preceding { _select($_[0]->_collect(_siblings($_[0]->tree, 1, 0)), $_[1]) } | ||
126 | 7 | 7 | 1 | 18 | sub preceding_nodes { $_[0]->_collect(_siblings($_[0]->tree, 0)) } | ||
127 | |||||||
128 | 11 | 11 | 1 | 39 | sub prepend { shift->_add(0, @_) } | ||
129 | 6 | 6 | 1 | 27 | sub prepend_content { shift->_content(0, 0, @_) } | ||
130 | |||||||
131 | 7 | 7 | 1 | 24 | sub previous { $_[0]->_maybe(_siblings($_[0]->tree, 1, 0, -1)) } | ||
132 | 5 | 5 | 1 | 14 | sub previous_node { $_[0]->_maybe(_siblings($_[0]->tree, 0, 0, -1)) } | ||
133 | |||||||
134 | 6 | 6 | 1 | 22 | sub remove { shift->replace('') } | ||
135 | |||||||
136 | sub replace { | ||||||
137 | 24 | 24 | 1 | 73 | my ($self, $new) = @_; | ||
138 | 24 | 100 | 52 | return $self->parse($new) if (my $tree = $self->tree)->[0] eq 'root'; | |||
139 | 16 | 49 | return $self->_replace(_parent($tree), $tree, _nodes($self->_parse($new))); | ||||
140 | } | ||||||
141 | |||||||
142 | sub root { | ||||||
143 | 14 | 14 | 1 | 27 | my $self = shift; | ||
144 | 14 | 100 | 34 | return $self unless my $tree = _ancestors($self->tree, 1); | |||
145 | 11 | 36 | return $self->_build($tree, $self->xml); | ||||
146 | } | ||||||
147 | |||||||
148 | sub selector { | ||||||
149 | 13 | 100 | 13 | 1 | 31 | return undef unless (my $tree = shift->tree)->[0] eq 'tag'; | |
150 | 11 | 28 | return join ' > ', reverse map { $_->[1] . ':nth-child(' . (@{_siblings($_, 1)} + 1) . ')' } $tree, _ancestors($tree); | ||||
31 | 65 | ||||||
31 | 56 | ||||||
151 | } | ||||||
152 | |||||||
153 | sub strip { | ||||||
154 | 9 | 9 | 1 | 19 | my $self = shift; | ||
155 | 9 | 100 | 21 | return $self if (my $tree = $self->tree)->[0] ne 'tag'; | |||
156 | 7 | 20 | return $self->_replace($tree->[3], $tree, _nodes($tree)); | ||||
157 | } | ||||||
158 | |||||||
159 | sub tag { | ||||||
160 | 101 | 101 | 1 | 256 | my ($self, $tag) = @_; | ||
161 | 101 | 100 | 176 | return undef if (my $tree = $self->tree)->[0] ne 'tag'; | |||
162 | 99 | 100 | 535 | return $tree->[1] unless $tag; | |||
163 | 1 | 2 | $tree->[1] = $tag; | ||||
164 | 1 | 6 | return $self; | ||||
165 | } | ||||||
166 | |||||||
167 | 1 | 1 | 1 | 7 | sub tap { shift->Mojo::Base::tap(@_) } | ||
168 | |||||||
169 | 838 | 838 | 1 | 2163 | sub text { _text(_nodes(shift->tree), 0, 0) } | ||
170 | |||||||
171 | 152 | 152 | 1 | 274 | sub to_string { ${shift()}->render } | ||
152 | 492 | ||||||
172 | |||||||
173 | 5082 | 100 | 50 | 5082 | 1 | 9881 | sub tree { @_ > 1 ? (${$_[0]}->tree($_[1]) and return $_[0]) : ${$_[0]}->tree } |
2955 | 8048 | ||||||
174 | |||||||
175 | 82 | 82 | 1 | 153 | sub type { shift->tree->[0] } | ||
176 | |||||||
177 | sub val { | ||||||
178 | 32 | 32 | 1 | 63 | my $self = shift; | ||
179 | |||||||
180 | # "option" | ||||||
181 | 32 | 100 | 66 | 71 | return $self->{value} // $self->text if (my $tag = $self->tag) eq 'option'; | ||
182 | |||||||
183 | # "input" ("type=checkbox" and "type=radio") | ||||||
184 | 22 | 100 | 65 | my $type = $self->{type} // ''; | |||
185 | 22 | 100 | 100 | 100 | return $self->{value} // 'on' if $tag eq 'input' && ($type eq 'radio' || $type eq 'checkbox'); | ||
100 | |||||||
100 | |||||||
186 | |||||||
187 | # "textarea", "input" or "button" | ||||||
188 | 17 | 100 | 59 | return $tag eq 'textarea' ? $self->text : $self->{value} if $tag ne 'select'; | |||
100 | |||||||
189 | |||||||
190 | # "select" | ||||||
191 | 6 | 6 | 21 | my $v = $self->find('option:checked:not([disabled])')->grep(sub { !$_->ancestors('optgroup[disabled]')->size }) | |||
192 | 5 | 15 | ->map('val'); | ||||
193 | 5 | 100 | 32 | return exists $self->{multiple} ? $v->size ? $v->to_array : undef : $v->last; | |||
100 | |||||||
194 | } | ||||||
195 | |||||||
196 | 1 | 1 | 1 | 739 | sub with_roles { shift->Mojo::Base::with_roles(@_) } | ||
197 | |||||||
198 | 9 | 9 | 1 | 73 | sub wrap { shift->_wrap(0, @_) } | ||
199 | 7 | 7 | 1 | 22 | sub wrap_content { shift->_wrap(1, @_) } | ||
200 | |||||||
201 | 3609 | 100 | 50 | 3609 | 1 | 6915 | sub xml { @_ > 1 ? (${$_[0]}->xml($_[1]) and return $_[0]) : ${$_[0]}->xml } |
1463 | 4946 | ||||||
202 | |||||||
203 | sub _add { | ||||||
204 | 20 | 20 | 49 | my ($self, $offset, $new) = @_; | |||
205 | |||||||
206 | 20 | 100 | 42 | return $self if (my $tree = $self->tree)->[0] eq 'root'; | |||
207 | |||||||
208 | 16 | 45 | my $parent = _parent($tree); | ||||
209 | 16 | 42 | splice @$parent, _offset($parent, $tree) + $offset, 0, @{_link($parent, _nodes($self->_parse($new)))}; | ||||
16 | 47 | ||||||
210 | |||||||
211 | 16 | 80 | return $self; | ||||
212 | } | ||||||
213 | |||||||
214 | sub _all { | ||||||
215 | 21 | 21 | 32 | my $nodes = shift; | |||
216 | 21 | 100 | 36 | @$nodes = map { $_->[0] eq 'tag' ? ($_, @{_all(_nodes($_))}) : ($_) } @$nodes; | |||
60 | 133 | ||||||
8 | 13 | ||||||
217 | 21 | 56 | return $nodes; | ||||
218 | } | ||||||
219 | |||||||
220 | sub _ancestors { | ||||||
221 | 56 | 56 | 140 | my ($tree, $root) = @_; | |||
222 | |||||||
223 | 56 | 100 | 116 | return () unless $tree = _parent($tree); | |||
224 | 53 | 139 | my @ancestors; | ||||
225 | 53 | 66 | 73 | do { push @ancestors, $tree } while ($tree->[0] eq 'tag') && ($tree = $tree->[3]); | |||
141 | 497 | ||||||
226 | 53 | 100 | 279 | return $root ? $ancestors[-1] : @ancestors[0 .. $#ancestors - 1]; | |||
227 | } | ||||||
228 | |||||||
229 | 2127 | 2127 | 4146 | sub _build { shift->new->tree(shift)->xml(shift) } | |||
230 | |||||||
231 | sub _collect { | ||||||
232 | 570 | 50 | 570 | 1768 | my ($self, $nodes) = (shift, shift // []); | ||
233 | 570 | 1101 | my $xml = $self->xml; | ||||
234 | 570 | 1202 | return Mojo::Collection->new(map { $self->_build($_, $xml) } @$nodes); | ||||
1356 | 2431 | ||||||
235 | } | ||||||
236 | |||||||
237 | sub _content { | ||||||
238 | 40 | 40 | 100 | my ($self, $start, $offset, $new) = @_; | |||
239 | |||||||
240 | 40 | 69 | my $tree = $self->tree; | ||||
241 | 40 | 100 | 100 | 233 | unless ($tree->[0] eq 'root' || $tree->[0] eq 'tag') { | ||
242 | 2 | 6 | my $old = $self->content; | ||||
243 | 2 | 100 | 13 | return $self->content($start ? $old . $new : $new . $old); | |||
244 | } | ||||||
245 | |||||||
246 | 38 | 100 | 115 | $start = $start ? ($#$tree + 1) : _start($tree); | |||
247 | 38 | 100 | 89 | $offset = $offset ? $#$tree : 0; | |||
248 | 38 | 64 | splice @$tree, $start, $offset, @{_link($tree, _nodes($self->_parse($new)))}; | ||||
38 | 96 | ||||||
249 | |||||||
250 | 38 | 199 | return $self; | ||||
251 | } | ||||||
252 | |||||||
253 | 1250 | 1250 | 3170 | sub _css { Mojo::DOM::CSS->new(tree => shift->tree) } | |||
254 | |||||||
255 | 1 | 1 | 7 | sub _fragment { _link(my $r = ['root', @_], [@_]); $r } | |||
1 | 3 | ||||||
256 | |||||||
257 | sub _link { | ||||||
258 | 102 | 102 | 199 | my ($parent, $children) = @_; | |||
259 | |||||||
260 | # Link parent to children | ||||||
261 | 102 | 196 | for my $node (@$children) { | ||||
262 | 106 | 100 | 241 | my $offset = $node->[0] eq 'tag' ? 3 : 2; | |||
263 | 106 | 189 | $node->[$offset] = $parent; | ||||
264 | 106 | 281 | weaken $node->[$offset]; | ||||
265 | } | ||||||
266 | |||||||
267 | 102 | 339 | return $children; | ||||
268 | } | ||||||
269 | |||||||
270 | 30 | 100 | 30 | 148 | sub _maybe { $_[1] ? $_[0]->_build($_[1], $_[0]->xml) : undef } | ||
271 | |||||||
272 | sub _nodes { | ||||||
273 | 1317 | 50 | 1317 | 2931 | return () unless my $tree = shift; | ||
274 | 1317 | 2902 | my @nodes = @$tree[_start($tree) .. $#$tree]; | ||||
275 | 1317 | 100 | 4194 | return shift() ? [grep { $_->[0] eq 'tag' } @nodes] : \@nodes; | |||
84 | 271 | ||||||
276 | } | ||||||
277 | |||||||
278 | sub _offset { | ||||||
279 | 46 | 46 | 92 | my ($parent, $child) = @_; | |||
280 | 46 | 82 | my $i = _start($parent); | ||||
281 | 46 | 100 | 277 | $_ eq $child ? last : $i++ for @$parent[$i .. $#$parent]; | |||
282 | 46 | 102 | return $i; | ||||
283 | } | ||||||
284 | |||||||
285 | 225 | 100 | 225 | 769 | sub _parent { $_[0]->[$_[0][0] eq 'tag' ? 3 : 2] } | ||
286 | |||||||
287 | sub _parse { | ||||||
288 | 84 | 84 | 153 | my ($self, $input) = @_; | |||
289 | 84 | 100 | 66 | 416 | return Mojo::DOM::HTML->new(xml => $self->xml)->parse($input)->tree unless blessed $input && $input->isa('Mojo::DOM'); | ||
290 | 21 | 54 | my $tree = dclone $input->tree; | ||||
291 | 21 | 100 | 108 | return $tree->[0] eq 'root' ? $tree : _fragment($tree); | |||
292 | } | ||||||
293 | |||||||
294 | sub _replace { | ||||||
295 | 30 | 30 | 71 | my ($self, $parent, $child, $nodes) = @_; | |||
296 | 30 | 71 | splice @$parent, _offset($parent, $child), 1, @{_link($parent, $nodes)}; | ||||
30 | 61 | ||||||
297 | 30 | 80 | return $self->parent; | ||||
298 | } | ||||||
299 | |||||||
300 | 41 | 100 | 41 | 255 | sub _select { $_[1] ? $_[0]->grep(matches => $_[1]) : $_[0] } | ||
301 | |||||||
302 | sub _siblings { | ||||||
303 | 88 | 88 | 182 | my ($tree, $tags, $tail, $i) = @_; | |||
304 | |||||||
305 | 88 | 100 | 218 | return defined $i ? undef : [] if $tree->[0] eq 'root'; | |||
100 | |||||||
306 | |||||||
307 | 82 | 145 | my $nodes = _nodes(_parent($tree)); | ||||
308 | 82 | 115 | my $match = -1; | ||||
309 | 82 | 66 | 648 | defined($match++) and $_ eq $tree and last for @$nodes; | |||
100 | |||||||
310 | |||||||
311 | 82 | 100 | 162 | if ($tail) { splice @$nodes, 0, $match + 1 } | |||
30 | 63 | ||||||
312 | 52 | 115 | else { splice @$nodes, $match, ($#$nodes + 1) - $match } | ||||
313 | |||||||
314 | 82 | 100 | 188 | @$nodes = grep { $_->[0] eq 'tag' } @$nodes if $tags; | |||
171 | 367 | ||||||
315 | |||||||
316 | 82 | 100 | 100 | 424 | return defined $i ? $i == -1 && !@$nodes ? undef : $nodes->[$i] : $nodes; | ||
100 | |||||||
317 | } | ||||||
318 | |||||||
319 | 1394 | 100 | 1394 | 4599 | sub _start { $_[0][0] eq 'root' ? 1 : 4 } | ||
320 | |||||||
321 | sub _text { | ||||||
322 | 866 | 866 | 1644 | my ($nodes, $xml, $all) = @_; | |||
323 | |||||||
324 | 866 | 1356 | my $text = ''; | ||||
325 | 866 | 2015 | while (my $node = shift @$nodes) { | ||||
326 | 1225 | 1834 | my $type = $node->[0]; | ||||
327 | |||||||
328 | # Text | ||||||
329 | 1225 | 100 | 100 | 3916 | if ($type eq 'text' || $type eq 'cdata' || $type eq 'raw') { $text .= $node->[1] } | ||
1007 | 100 | 100 | 2971 | ||||
100 | |||||||
330 | |||||||
331 | # Nested tag | ||||||
332 | elsif ($type eq 'tag' && $all) { | ||||||
333 | 155 | 100 | 100 | 591 | unshift @$nodes, @{_nodes($node)} if $xml || ($node->[1] ne 'script' && $node->[1] ne 'style'); | ||
143 | 100 | 218 | |||||
334 | } | ||||||
335 | } | ||||||
336 | |||||||
337 | 866 | 4682 | return $text; | ||||
338 | } | ||||||
339 | |||||||
340 | sub _wrap { | ||||||
341 | 16 | 16 | 45 | my ($self, $content, $new) = @_; | |||
342 | |||||||
343 | 16 | 100 | 100 | 31 | return $self if (my $tree = $self->tree)->[0] eq 'root' && !$content; | ||
344 | 15 | 100 | 100 | 82 | return $self if $tree->[0] ne 'root' && $tree->[0] ne 'tag' && $content; | ||
100 | |||||||
345 | |||||||
346 | # Find innermost tag | ||||||
347 | 14 | 23 | my $current; | ||||
348 | 14 | 34 | my $first = $new = $self->_parse($new); | ||||
349 | 14 | 50 | $current = $first while $first = _nodes($first, 1)->[0]; | ||||
350 | 14 | 100 | 47 | return $self unless $current; | |||
351 | |||||||
352 | # Wrap content | ||||||
353 | 12 | 100 | 30 | if ($content) { | |||
354 | 5 | 10 | push @$current, @{_link($current, _nodes($tree))}; | ||||
5 | 14 | ||||||
355 | 5 | 18 | splice @$tree, _start($tree), $#$tree, @{_link($tree, _nodes($new))}; | ||||
5 | 11 | ||||||
356 | 5 | 27 | return $self; | ||||
357 | } | ||||||
358 | |||||||
359 | # Wrap element | ||||||
360 | 7 | 19 | $self->_replace(_parent($tree), $tree, _nodes($new)); | ||||
361 | 7 | 22 | push @$current, @{_link($current, [$tree])}; | ||||
7 | 16 | ||||||
362 | 7 | 32 | return $self; | ||||
363 | } | ||||||
364 | |||||||
365 | 1; | ||||||
366 | |||||||
367 | =encoding utf8 | ||||||
368 | |||||||
369 | =head1 NAME | ||||||
370 | |||||||
371 | Mojo::DOM - Minimalistic HTML/XML DOM parser with CSS selectors | ||||||
372 | |||||||
373 | =head1 SYNOPSIS | ||||||
374 | |||||||
375 | use Mojo::DOM; | ||||||
376 | |||||||
377 | # Parse | ||||||
378 | my $dom = Mojo::DOM->new(' Test 123 |
||||||
379 | |||||||
380 | # Find | ||||||
381 | say $dom->at('#b')->text; | ||||||
382 | say $dom->find('p')->map('text')->join("\n"); | ||||||
383 | say $dom->find('[id]')->map(attr => 'id')->join("\n"); | ||||||
384 | |||||||
385 | # Iterate | ||||||
386 | $dom->find('p[id]')->reverse->each(sub { say $_->{id} }); | ||||||
387 | |||||||
388 | # Loop | ||||||
389 | for my $e ($dom->find('p[id]')->each) { | ||||||
390 | say $e->{id}, ':', $e->text; | ||||||
391 | } | ||||||
392 | |||||||
393 | # Modify | ||||||
394 | $dom->find('div p')->last->append(' 456 '); |
||||||
395 | $dom->at('#c')->prepend($dom->new_tag('p', id => 'd', '789')); | ||||||
396 | $dom->find(':not(p)')->map('strip'); | ||||||
397 | |||||||
398 | # Render | ||||||
399 | say "$dom"; | ||||||
400 | |||||||
401 | =head1 DESCRIPTION | ||||||
402 | |||||||
403 | L |
||||||
404 | broken HTML and XML, so you should not use it for validation. | ||||||
405 | |||||||
406 | =head1 NODES AND ELEMENTS | ||||||
407 | |||||||
408 | When we parse an HTML/XML fragment, it gets turned into a tree of nodes. | ||||||
409 | |||||||
410 | |||||||
411 | |||||||
412 | |
||||||
413 | World! | ||||||
414 | |||||||
415 | |||||||
416 | There are currently eight different kinds of nodes, C |
||||||
417 | and C |
||||||
418 | |||||||
419 | root | ||||||
420 | |- doctype (html) | ||||||
421 | +- tag (html) | ||||||
422 | |- tag (head) | ||||||
423 | | +- tag (title) | ||||||
424 | | +- raw (Hello) | ||||||
425 | +- tag (body) | ||||||
426 | +- text (World!) | ||||||
427 | |||||||
428 | While all node types are represented as L |
||||||
429 | apply to elements. | ||||||
430 | |||||||
431 | =head1 HTML AND XML | ||||||
432 | |||||||
433 | L |
||||||
434 | be lowercase as well. | ||||||
435 | |||||||
436 | # HTML semantics | ||||||
437 | my $dom = Mojo::DOM->new(' Hi! '); |
||||||
438 | say $dom->at('p[id]')->text; | ||||||
439 | |||||||
440 | If an XML declaration is found, the parser will automatically switch into XML mode and everything becomes | ||||||
441 | case-sensitive. | ||||||
442 | |||||||
443 | # XML semantics | ||||||
444 | my $dom = Mojo::DOM->new(' Hi! '); |
||||||
445 | say $dom->at('P[ID]')->text; | ||||||
446 | |||||||
447 | HTML or XML semantics can also be forced with the L"xml"> method. | ||||||
448 | |||||||
449 | # Force HTML semantics | ||||||
450 | my $dom = Mojo::DOM->new->xml(0)->parse(' Hi! '); |
||||||
451 | say $dom->at('p[id]')->text; | ||||||
452 | |||||||
453 | # Force XML semantics | ||||||
454 | my $dom = Mojo::DOM->new->xml(1)->parse(' Hi! '); |
||||||
455 | say $dom->at('P[ID]')->text; | ||||||
456 | |||||||
457 | =head1 METHODS | ||||||
458 | |||||||
459 | L |
||||||
460 | |||||||
461 | =head2 all_text | ||||||
462 | |||||||
463 | my $text = $dom->all_text; | ||||||
464 | |||||||
465 | Extract text content from all descendant nodes of this element. For HTML documents C |