module Phlex::Elements

def register_element(method_name, tag: nil)

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: nil)
	tag ||= method_name.name.tr("_", "-")
	class_eval(<<-RUBY, __FILE__, __LINE__ + 1)
		# frozen_string_literal: true
		def #{method_name}(**attributes, &block)
			target = @_context.target
			if attributes.length > 0 # with attributes
				if block_given? # with content block
					target << "<#{tag}" << (Phlex::ATTRIBUTE_CACHE[respond_to?(:process_attributes) ? (attributes.hash + self.class.hash) : attributes.hash] || __attributes__(**attributes)) << ">"
					yield_content(&block)
					target << "</#{tag}>"
				else # without content block
					target << "<#{tag}" << (Phlex::ATTRIBUTE_CACHE[respond_to?(:process_attributes) ? (attributes.hash + self.class.hash) : attributes.hash] || __attributes__(**attributes)) << "></#{tag}>"
				end
			else # without attributes
				if block_given? # with content block
					target << "<#{tag}>"
					yield_content(&block)
					target << "</#{tag}>"
				else # without content block
					target << "<#{tag}></#{tag}>"
				end
			end
			#{'flush' if tag == 'head'}
			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)
			target = @_context.target
			if attributes.length > 0 # with attributes
				target << "<#{tag}" << (Phlex::ATTRIBUTE_CACHE[respond_to?(:process_attributes) ? (attributes.hash + self.class.hash) : attributes.hash] || __attributes__(**attributes)) << ">"
			else # without attributes
				target << "<#{tag}>"
			end
			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 ||= Concurrent::Map.new
end