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.

[View source]

48
49
50
 
# File 'lib/action_view/helpers/tag_helper.rb', line 48

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)

[View source]

142
143
144
 
# File 'lib/action_view/helpers/tag_helper.rb', line 142

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

Instance Method Details

#boolean_tag_option(key) ⇒ Object

[View source]

113
114
115
 
# File 'lib/action_view/helpers/tag_helper.rb', line 113

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

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

[View source]

65
66
67
68
69
 
# File 'lib/action_view/helpers/tag_helper.rb', line 65

def content_tag_string(name, content, options, escape = true)
  tag_options = tag_options(options, escape) if options
  content     = ERB::Util.unwrapped_html_escape(content) if escape
  "<#{name}#{tag_options}>#{PRE_CONTENT_STRINGS[name]}#{content}</#{name}>".html_safe
end

#p(*arguments, **options, &block) ⇒ Object

[View source]

52
53
54
 
# File 'lib/action_view/helpers/tag_helper.rb', line 52

def p(*arguments, **options, &block)
  tag_string(:p, *arguments, **options, &block)
end

#tag_option(key, value, escape) ⇒ Object

[View source]

117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/action_view/helpers/tag_helper.rb', line 117

def tag_option(key, value, escape)
  case value
  when Array, Hash
    value = TagHelper.build_tag_values(value) if key.to_s == "class"
    value = escape ? safe_join(value, " ") : value.join(" ")
  else
    value = escape ? ERB::Util.unwrapped_html_escape(value) : value.to_s
  end
  value = value.gsub('"', "&quot;") if value.include?('"')
  %(#{key}="#{value}")
end

#tag_options(options, escape = true) ⇒ Object

[View source]

71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/action_view/helpers/tag_helper.rb', line 71

def tag_options(options, escape = true)
  return if options.blank?
  output = +""
  sep    = " "
  options.each_pair do |key, value|
    type = TAG_TYPES[key]
    if type == :data && 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 type == :aria && value.is_a?(Hash)
      value.each_pair do |k, v|
        next if v.nil?

        case v
        when Array, Hash
          tokens = TagHelper.build_tag_values(v)
          next if tokens.none?

          v = safe_join(tokens, " ")
        else
          v = v.to_s
        end

        output << sep
        output << prefix_tag_option(key, k, v, escape)
      end
    elsif type == :boolean
      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, escape_attributes: true, **options, &block) ⇒ Object

[View source]

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

def tag_string(name, content = nil, escape_attributes: true, **options, &block)
  content = @view_context.capture(self, &block) if block_given?
  if VOID_ELEMENTS.include?(name) && content.nil?
    "<#{name.to_s.dasherize}#{tag_options(options, escape_attributes)}>".html_safe
  else
    content_tag_string(name.to_s.dasherize, content || "", options, escape_attributes)
  end
end