Class: ActionView::Helpers::TagHelper::TagBuilder

Inherits:
Object
  • Object
show all
Includes:
CaptureHelper, OutputSafetyHelper
Defined in:
lib/action_view/helpers/tag_helper.rb

Overview

:nodoc:

Constant Summary collapse

VOID_ELEMENTS = 
%i(area base br col embed hr img input keygen link meta param source track wbr).to_set

Instance Method Summary collapse

Methods included from OutputSafetyHelper

#raw, #safe_join, #to_sentence

Methods included from CaptureHelper

#capture, #content_for, #content_for?, #provide, #with_output_buffer

Constructor Details

#initialize(view_context) ⇒ TagBuilder

Returns a new instance of TagBuilder.



40
41
42
 
# File 'lib/action_view/helpers/tag_helper.rb', line 40

def initialize(view_context)
  @view_context = view_context
end

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

#method_missing(called, *args, **options, &block) ⇒ Object (private) 



139
140
141
 
# File 'lib/action_view/helpers/tag_helper.rb', line 139

def method_missing(called, *args, **options, &block)
  tag_string(called, *args, **options, &block)
end

Instance Method Details

#boolean_tag_option(key) ⇒ Object 



90
91
92
 
# File 'lib/action_view/helpers/tag_helper.rb', line 90

def boolean_tag_option(key)
  %(#{key}="#{key}")
end

#content_tag_string(name, content, options, escape = true) ⇒ Object 



55
56
57
58
59
60
61
62
63
64
 
# File 'lib/action_view/helpers/tag_helper.rb', line 55

def content_tag_string(name, content, options, escape = true)
  tag_options = tag_options(options, escape) if options

  if escape
    name = ERB::Util.xml_name_escape(name)
    content = ERB::Util.unwrapped_html_escape(content)
  end

  "<#{name}#{tag_options}>#{PRE_CONTENT_STRINGS[name]}#{content}</#{name}>".html_safe
end

#tag_option(key, value, escape) ⇒ Object 



94
95
96
97
98
99
100
101
102
103
 
# File 'lib/action_view/helpers/tag_helper.rb', line 94

def tag_option(key, value, escape)
  key = ERB::Util.xml_name_escape(key) if escape

  if value.is_a?(Array)
    value = escape ? safe_join(value, " ".freeze) : value.join(" ".freeze)
  else
    value = escape ? ERB::Util.unwrapped_html_escape(value) : value.to_s
  end
  %(#{key}="#{value.gsub('"'.freeze, '&quot;'.freeze)}")
end

#tag_options(options, escape = true) ⇒ Object 



66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
 
# File 'lib/action_view/helpers/tag_helper.rb', line 66

def tag_options(options, escape = true)
  return if options.blank?
  output = "".dup
  sep    = " "
  options.each_pair do |key, value|
    if TAG_PREFIXES.include?(key) && value.is_a?(Hash)
      value.each_pair do |k, v|
        next if v.nil?
        output << sep
        output << prefix_tag_option(key, k, v, escape)
      end
    elsif BOOLEAN_ATTRIBUTES.include?(key)
      if value
        output << sep
        output << boolean_tag_option(key)
      end
    elsif !value.nil?
      output << sep
      output << tag_option(key, value, escape)
    end
  end
  output unless output.empty?
end

#tag_string(name, content = nil, **options, &block) ⇒ Object 



44
45
46
47
48
49
50
51
52
53
 
# File 'lib/action_view/helpers/tag_helper.rb', line 44

def tag_string(name, content = nil, **options, &block)
  escape = handle_deprecated_escape_options(options)
  content = @view_context.capture(self, &block) if block_given?

  if VOID_ELEMENTS.include?(name) && content.nil?
    "<#{name.to_s.dasherize}#{tag_options(options, escape)}>".html_safe
  else
    content_tag_string(name.to_s.dasherize, content || "", options, escape)
  end
end