module Phlex::Elements

def register_element(method_name, tag: method_name.name.tr("_", "-"))

Other tags:
    Example: Register the custom element `` -

Other tags:
    Note: - The methods defined by this macro depend on other methods from {SGML} so they should always be mixed into an {HTML} or {SVG} component.

Returns:
  • (Symbol) - the name of the method created

Parameters:
  • tag (String) -- the name of the tag, otherwise this will be the method name with underscores replaced with dashes.
  • method_name (Symbol) --
def register_element(method_name, tag: method_name.name.tr("_", "-"))
	class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
		# frozen_string_literal: true
		def #{method_name}(**attributes)
			context = @_context
			buffer = context.buffer
			fragment = context.fragments
			target_found = false
			block_given = block_given?
			if fragment
				return if fragment.length == 0 # we found all our fragments already
				id = attributes[:id]
				if !context.in_target_fragment
				  if fragment[id]
						context.begin_target(id)
						target_found = true
					else
						yield(self) if block_given
						return nil
					end
				end
			end
			if attributes.length > 0 # with attributes
				if block_given # with content block
					buffer << "<#{tag}" << (Phlex::ATTRIBUTE_CACHE[attributes] ||= __attributes__(attributes)) << ">"
					original_length = buffer.bytesize
					content = yield(self)
					if original_length == buffer.bytesize
						case content
						when String
							buffer << Phlex::Escape.html_escape(content)
						when Symbol
							buffer << Phlex::Escape.html_escape(content.name)
						when nil
							nil
						when Phlex::SGML::SafeObject
							buffer << content.to_s
						else
							if (formatted_object = format_object(content))
								buffer << Phlex::Escape.html_escape(formatted_object)
							end
						end
					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}>"
					original_length = buffer.bytesize
					content = yield(self)
					if original_length == buffer.bytesize
						case content
						when String
							buffer << Phlex::Escape.html_escape(content)
						when Symbol
							buffer << Phlex::Escape.html_escape(content.name)
						when nil
							nil
						when Phlex::SGML::SafeObject
							buffer << content.to_s
						else
							if (formatted_object = format_object(content))
								buffer << Phlex::Escape.html_escape(formatted_object)
							end
						end
					end
					buffer << "</#{tag}>"
				else # without content
					buffer << "<#{tag}></#{tag}>"
				end
			end
			#{'flush' if tag == 'head'}
			context.end_target if target_found
			nil
		end
		alias_method :_#{method_name}, :#{method_name}
	RUBY
	registered_elements[method_name] = tag
	method_name
end

def register_void_element(method_name, tag: method_name.name.tr("_", "-"))

Other tags:
    Api: - private
def register_void_element(method_name, tag: method_name.name.tr("_", "-"))
	class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
		# frozen_string_literal: true
		def #{method_name}(**attributes)
			context = @_context
			buffer = context.buffer
			fragment = context.fragments
			if fragment
				return if fragment.length == 0 # we found all our fragments already
				id = attributes[:id]
				if !context.in_target_fragment
				  if fragment[id]
						context.begin_target(id)
						target_found = true
					else
						return nil
					end
				end
			end
			if attributes.length > 0 # with attributes
				buffer << "<#{tag}" << (Phlex::ATTRIBUTE_CACHE[attributes] ||= __attributes__(attributes)) << ">"
			else # without attributes
				buffer << "<#{tag}>"
			end
			context.end_target if target_found
			nil
		end
		alias_method :_#{method_name}, :#{method_name}
	RUBY
	registered_elements[method_name] = tag
	method_name
end

def registered_elements

Other tags:
    Api: - private
def registered_elements
	@registered_elements ||= {}
end