.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
. ds C` ""
. ds C' ""
'br\}
.el\{\
. ds C`
. ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD. Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
. if \nF \{\
. de IX
. tm Index:\\$1\t\\n%\t"\\$2"
..
. if !\nF==2 \{\
. nr % 0
. nr F 2
. \}
. \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "Mojo::DOM::HTML 3pm"
.TH Mojo::DOM::HTML 3pm 2024-05-15 "perl v5.38.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification. Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH NAME
Mojo::DOM::HTML \- HTML/XML engine
.SH SYNOPSIS
.IX Header "SYNOPSIS"
.Vb 1
\& use Mojo::DOM::HTML;
\&
\& # Turn HTML into DOM tree
\& my $html = Mojo::DOM::HTML\->new;
\& $html\->parse(\*(Aq
\*(Aq);
\& my $tree = $html\->tree;
.Ve
.SH DESCRIPTION
.IX Header "DESCRIPTION"
Mojo::DOM::HTML is the HTML/XML engine used by Mojo::DOM, based on the HTML Living
Standard and the Extensible Markup Language (XML) 1.0 .
.SH FUNCTIONS
.IX Header "FUNCTIONS"
Mojo::DOM::HTML implements the following functions, which can be imported individually.
.SS tag_to_html
.IX Subsection "tag_to_html"
.Vb 1
\& my $str = tag_to_html \*(Aqdiv\*(Aq, id => \*(Aqfoo\*(Aq, \*(Aqsafe content\*(Aq;
.Ve
.PP
Generate HTML/XML tag and render it right away. This is a significantly faster alternative to "tag" for template
systems that have to generate a lot of tags.
.SH ATTRIBUTES
.IX Header "ATTRIBUTES"
Mojo::DOM::HTML implements the following attributes.
.SS tree
.IX Subsection "tree"
.Vb 2
\& my $tree = $html\->tree;
\& $html = $html\->tree([\*(Aqroot\*(Aq]);
.Ve
.PP
Document Object Model. Note that this structure should only be used very carefully since it is very dynamic.
.SS xml
.IX Subsection "xml"
.Vb 2
\& my $bool = $html\->xml;
\& $html = $html\->xml($bool);
.Ve
.PP
Disable HTML semantics in parser and activate case-sensitivity, defaults to auto-detection based on XML declarations.
.SH METHODS
.IX Header "METHODS"
Mojo::DOM::HTML inherits all methods from Mojo::Base and implements the following new ones.
.SS parse
.IX Subsection "parse"
.Vb 1
\& $html = $html\->parse(\*(AqI ♥ Mojolicious!\*(Aq);
.Ve
.PP
Parse HTML/XML fragment.
.SS render
.IX Subsection "render"
.Vb 1
\& my $str = $html\->render;
.Ve
.PP
Render DOM to HTML/XML.
.SS tag
.IX Subsection "tag"
.Vb 1
\& $html = $html\->tag(\*(Aqdiv\*(Aq, id => \*(Aqfoo\*(Aq, \*(Aqsafe content\*(Aq);
.Ve
.PP
Generate HTML/XML tag.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
Mojolicious, Mojolicious::Guides, .