module Phlex::Elements
def register_element(method_name, tag: nil)
- 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("_", "-"))
- 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
- Api: - private
def registered_elements @registered_elements ||= Concurrent::Map.new end