class Phlex::HTML - phlex-2.3.1 Documentation

Source

# File lib/phlex/html.rb, line 34
def content_type
        "text/html"
end

Returns the string “text/html”

doctype ()

Source

# File lib/phlex/html.rb, line 8
def doctype
        state = @_state
        return unless state.should_render?

        state.buffer << "<!doctype html>"
        nil
end

Output an HTML doctype.

filename ()

Source

# File lib/phlex/html.rb, line 29
def filename
        nil
end

Override to provide a filename for the HTML file

svg (*, **, &)

Source

# File lib/phlex/html.rb, line 20
def svg(*, **, &)
        if block_given?
                super { render Phlex::SVG.new(&) }
        else
                super
        end
end

Outputs an ‘<svg>` tag.

[MDN Docs](developer.mozilla.org/docs/Web/SVG/Element/svg) [Spec](html.spec.whatwg.org/#the-svg-element)

Calls superclass method

tag (name, **attributes, &) { |self| ... }

Source

# File lib/phlex/html.rb, line 44
def tag(name, **attributes, &)
        state = @_state
        block_given = block_given?
        buffer = state.buffer

        unless state.should_render?
                yield(self) if block_given
                return nil
        end

        unless Symbol === name
                raise Phlex::ArgumentError.new("Expected the tag name to be a Symbol.")
        end

        if (tag = StandardElements.__registered_elements__[name]) || (tag = name.name.tr("_", "-")).include?("-")
                if attributes.length > 0 # with attributes
                        if block_given # with content block
                                buffer << "<#{tag}" << (Phlex::ATTRIBUTE_CACHE[attributes] ||= __attributes__(attributes)) << ">"
                                if tag == "svg"
                                        render Phlex::SVG.new(&)
                                else
                                        __yield_content__(&)
                                end
                                buffer << "</#{tag}>"
                        else # without content
                                buffer << "<#{tag}" << (::Phlex::ATTRIBUTE_CACHE[attributes] ||= __attributes__(attributes)) << "></#{tag}>"
                        end
                else # without attributes
                        if block_given # with content block
                                buffer << ("<#{tag}>")
                                if tag == "svg"
                                        render Phlex::SVG.new(&)
                                else
                                        __yield_content__(&)
                                end
                                buffer << "</#{tag}>"
                        else # without content
                                buffer << "<#{tag}></#{tag}>"
                        end
                end
        elsif (tag = VoidElements.__registered_elements__[name])
                if block_given
                        raise Phlex::ArgumentError.new("Void elements cannot have content blocks.")
                end

                if attributes.length > 0 # with attributes
                        buffer << "<#{tag}" << (::Phlex::ATTRIBUTE_CACHE[attributes] ||= __attributes__(attributes)) << ">"
                else # without attributes
                        buffer << "<#{tag}>"
                end

                nil
        else
                raise Phlex::ArgumentError.new("Invalid HTML tag: #{name}")
        end
end

Output an HTML tag dynamically, e.g:

“‘ruby @tag_name = :h1 tag(@tag_name, class: “title”) “`