Module: ActionView::Template::Handlers

Included in:
ActionView::Template
Defined in:
lib/action_view/template/handler.rb,
lib/action_view/template/handlers.rb,
lib/action_view/template/handlers/erb.rb,
lib/action_view/template/handlers/rjs.rb,
lib/action_view/template/handlers/builder.rb

Overview

:nodoc:

Defined Under Namespace

Modules: Compilable Classes: Builder, ERB, Erubis, RJS

Constant Summary collapse

@@template_handlers =
{}
@@default_template_handlers =
nil

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.extended(base) ⇒ Object



9
10
11
12
13
14
15
16
17
# File 'lib/action_view/template/handlers.rb', line 9

def self.extended(base)
  base.register_default_template_handler :erb, ERB
  base.register_template_handler :rjs, RJS
  base.register_template_handler :builder, Builder

  # TODO: Depreciate old template extensions
  base.register_template_handler :rhtml, ERB
  base.register_template_handler :rxml, Builder
end

.extensionsObject



22
23
24
# File 'lib/action_view/template/handlers.rb', line 22

def self.extensions
  @@template_extensions ||= @@template_handlers.keys
end

Instance Method Details

#handler_class_for_extension(extension) ⇒ Object



50
51
52
# File 'lib/action_view/template/handlers.rb', line 50

def handler_class_for_extension(extension)
  (extension && registered_template_handler(extension.to_sym)) || @@default_template_handlers
end

#register_default_template_handler(extension, klass) ⇒ Object



45
46
47
48
# File 'lib/action_view/template/handlers.rb', line 45

def register_default_template_handler(extension, klass)
  register_template_handler(extension, klass)
  @@default_template_handlers = klass
end

#register_template_handler(extension, klass) ⇒ Object

Register a class that knows how to handle template files with the given extension. This can be used to implement new template types. The constructor for the class must take the ActiveView::Base instance as a parameter, and the class must implement a render method that takes the contents of the template to render as well as the Hash of local assigns available to the template. The render method ought to return the rendered template as a string.



33
34
35
# File 'lib/action_view/template/handlers.rb', line 33

def register_template_handler(extension, klass)
  @@template_handlers[extension.to_sym] = klass
end

#registered_template_handler(extension) ⇒ Object



41
42
43
# File 'lib/action_view/template/handlers.rb', line 41

def registered_template_handler(extension)
  extension && @@template_handlers[extension.to_sym]
end

#template_handler_extensionsObject



37
38
39
# File 'lib/action_view/template/handlers.rb', line 37

def template_handler_extensions
  @@template_handlers.keys.map {|key| key.to_s }.sort
end