Ruby on Rails 5.2 - ActionView::Template

क्लास एक्शन व्यू :: टेम्पलेट




ruby

क्लास एक्शन व्यू :: टेम्पलेट

जनक:
Object

एक्शन व्यू Template

गुण

प्रारूप [आरडब्ल्यू]
हैंडलर [आर]
पहचानकर्ता [आर]
स्थानीय लोग [आरडब्ल्यू]
original_encoding [R]
स्रोत [आर]
अद्यतन_त [आर]
वेरिएंट [RW]
virtual_path [RW]

पब्लिक क्लास के तरीके

नया (स्रोत, पहचानकर्ता, हैंडलर, विवरण) स्रोत दिखाएँ
# File actionview/lib/action_view/template.rb, line 128
def initialize(source, identifier, handler, details)
  format = details[:format] || (handler.default_format if handler.respond_to?(:default_format))

  @source            = source
  @identifier        = identifier
  @handler           = handler
  @compiled          = false
  @original_encoding = nil
  @locals            = details[:locals] || []
  @virtual_path      = details[:virtual_path]
  @updated_at        = details[:updated_at] || Time.now
  @formats           = Array(format).map { |f| f.respond_to?(:ref) ? f.ref : f  }
  @variants          = [details[:variant]]
  @compile_mutex     = Mutex.new
end

सार्वजनिक प्रवृत्ति के तरीके

सांकेतिक शब्दों में बदलना! () स्रोत दिखाएं
# File actionview/lib/action_view/template.rb, line 202
def encode!
  return unless source.encoding == Encoding::BINARY

  # Look for # encoding: *. If we find one, we'll encode the
  # String in that encoding, otherwise, we'll use the
  # default external encoding.
  if source.sub!(/\A#{ENCODING_FLAG}/, "")
    encoding = magic_encoding = $1
  else
    encoding = Encoding.default_external
  end

  # Tag the source with the default external encoding
  # or the encoding specified in the file
  source.force_encoding(encoding)

  # If the user didn't specify an encoding, and the handler
  # handles encodings, we simply pass the String as is to
  # the handler (with the default_external tag)
  if !magic_encoding && @handler.respond_to?(:handles_encoding?) && @handler.handles_encoding?
    source
  # Otherwise, if the String is valid in the encoding,
  # encode immediately to default_internal. This means
  # that if a handler doesn't handle encodings, it will
  # always get Strings in the default_internal
  elsif source.valid_encoding?
    source.encode!
  # Otherwise, since the String is invalid in the encoding
  # specified, raise an exception
  else
    raise WrongEncodingError.new(source, encoding)
  end
end

यह विधि स्रोत के एन्कोडिंग को ठीक से स्थापित करने के लिए जिम्मेदार है। इस बिंदु तक, हम मानते हैं कि स्रोत बायनेरी डेटा है। यदि कोई अतिरिक्त जानकारी नहीं दी जाती है, तो हम मान लेते हैं कि एन्कोडिंग Encoding.default_external के समान है।

उपयोगकर्ता टेम्पलेट की पहली पंक्ति (# एन्कोडिंग: NAME-OF-ENCODING) पर एक टिप्पणी के माध्यम से एन्कोडिंग को भी निर्दिष्ट कर सकता है। यह किसी भी टेम्पलेट इंजन के साथ काम करेगा, क्योंकि हम टेम्पलेट इंजन पर स्रोत को पारित करने से पहले एन्कोडिंग टिप्पणी को संसाधित करते हैं, इसके स्थान पर एक रिक्त लाइन छोड़ते हैं।

निरीक्षण () स्रोत दिखाएं
# File actionview/lib/action_view/template.rb, line 188
def inspect
  @inspect ||= defined?(Rails.root) ? identifier.sub("#{Rails.root}/", "".freeze) : identifier
end
# File actionview/lib/action_view/template.rb, line 104
eager_autoload do
  autoload :Error
  autoload :Handlers
  autoload :HTML
  autoload :Text
  autoload :Types
end

परिभाषित स्थानीय चर के साथ एक हैश लौटाता है।

इस उप खाका प्रतिपादन को देखते हुए:

<%= render "shared/header", { headline: "Welcome", person: person } %>

आप स्थानीय चर का उपयोग करने के लिए उप टेम्पलेट में local_assigns का उपयोग कर सकते हैं:

local_assigns[:headline] # => "Welcome"
ताज़ा (देखें) स्रोत दिखाएँ
# File actionview/lib/action_view/template.rb, line 177
def refresh(view)
  raise "A template needs to have a virtual path in order to be refreshed" unless @virtual_path
  lookup  = view.lookup_context
  pieces  = @virtual_path.split("/")
  name    = pieces.pop
  partial = !!name.sub!(/^_/, "")
  lookup.disable_cache do
    lookup.find_template(name, [ pieces.join("/") ], partial, @locals)
  end
end

एक दृश्य वस्तु प्राप्त करता है और @virtual_path का उपयोग करके स्वयं के समान एक टेम्पलेट लौटाता है।

यह विधि उपयोगी है यदि आपके पास एक टेम्प्लेट ऑब्जेक्ट है लेकिन इसमें उसका स्रोत नहीं है क्योंकि यह पहले से ही संकलित था। ऐसे मामलों में, आपको बस इतना करना है कि व्यू ऑब्जेक्ट में रिफ्रेश पासिंग को कॉल करें।

ध्यान दें कि यदि रीफ़्रेश किया जाने वाला टेम्पलेट वर्चुअल पथ सेट नहीं है (केवल इनलाइन टेम्प्लेट के लिए सत्य है) तो यह विधि एक त्रुटि उत्पन्न करती है।

रेंडर (देखें, स्थानीय लोग, बफर = नील, और ब्लॉक) दिखाएँ स्रोत
# File actionview/lib/action_view/template.rb, line 156
def render(view, locals, buffer = nil, &block)
  instrument_render_template do
    compile!(view)
    view.send(method_name, locals, buffer, &block)
  end
rescue => e
  handle_render_error(view, e)
end

एक टेम्पलेट रेंडर करें। यदि टेम्पलेट अभी तक संकलित नहीं किया गया था, तो यह प्रतिपादन से ठीक पहले किया जाता है।

इस पद्धति को "रेंडर -template.action_view" कहा जाता है। ध्यान दें कि हम इस इंस्ट्रूमेंटेशन में एक धमाके का उपयोग करते हैं क्योंकि आप उत्पादन में इसका उपभोग नहीं करना चाहते हैं। यह केवल तभी धीमा है जब इसे सुना जा रहा है।

# File actionview/lib/action_view/template.rb, line 146
def supports_streaming?
  handler.respond_to?(:supports_streaming?) && handler.supports_streaming?
end

वापस आता है कि अंतर्निहित हैंडलर स्ट्रीमिंग का समर्थन करता है या नहीं। यदि ऐसा है, तो एक स्ट्रीमिंग बफर पारित किया जा सकता है जब यह प्रतिपादन शुरू होता है।

# File actionview/lib/action_view/template.rb, line 165
def type
  @type ||= Types[@formats.first] if @formats.first
end

निजी उदाहरण तरीके

साधन (कार्रवाई, और ब्लॉक) दिखाएँ स्रोत
# File actionview/lib/action_view/template.rb, line 349
def instrument(action, &block) # :doc:
  ActiveSupport::Notifications.instrument("#{action}.action_view", instrument_payload, &block)
end