module Phlex::Elements
def register_element(method_name, tag: method_name.name.tr("_", "-"), deprecated: false)
- 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("_", "-"), deprecated: false) if deprecated deprecation = <<~RUBY Kernel.warn "#{deprecated}" RUBY else deprecation = "" end class_eval(<<-RUBY, __FILE__, __LINE__ + 1) # frozen_string_literal: true def #{method_name}(**attributes, &block) #{deprecation} context = @_context buffer = context.buffer fragment = context.fragments target_found = false 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 return nil end end end if attributes.length > 0 # with attributes if block # with content block buffer << "<#{tag}" << (Phlex::ATTRIBUTE_CACHE[respond_to?(:process_attributes) ? (attributes.hash + self.class.hash) : attributes.hash] || __attributes__(**attributes)) << ">" yield_content(&block) buffer << "</#{tag}>" else # without content block buffer << "<#{tag}" << (Phlex::ATTRIBUTE_CACHE[respond_to?(:process_attributes) ? (attributes.hash + self.class.hash) : attributes.hash] || __attributes__(**attributes)) << "></#{tag}>" end else # without attributes if block # with content block buffer << "<#{tag}>" yield_content(&block) buffer << "</#{tag}>" else # without content block 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("_", "-"), deprecated: false)
- Api: - private
def register_void_element(method_name, tag: method_name.name.tr("_", "-"), deprecated: false) if deprecated deprecation = <<~RUBY Kernel.warn "#{deprecated}" RUBY else deprecation = "" end class_eval(<<-RUBY, __FILE__, __LINE__ + 1) # frozen_string_literal: true def #{method_name}(**attributes) #{deprecation} 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[respond_to?(:process_attributes) ? (attributes.hash + self.class.hash) : attributes.hash] || __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
- Api: - private
def registered_elements @registered_elements ||= {} end