Module: Prawn::View

Defined in:
lib/prawn/view.rb

Overview

This mixin allows you to create modular Prawn code without the need to create subclasses of Prawn::Document.

 class Greeter
   include Prawn::View

   def initialize(name)
     @name = name
   end

   def say_hello
     text "Hello, #{@name}!"
   end

   def say_goodbye
     font("Courier") do
       text "Goodbye, #{@name}!"
     end
   end
end

greeter = Greeter.new("Gregory")

greeter.say_hello
greeter.say_goodbye

greeter.save_as("greetings.pdf")

The short story about why you should use this mixin rather than creating subclasses of Prawn::Document is that it helps prevent accidental conflicts between your code and Prawn's code.

Here's the slightly longer story…

By using composition rather than inheritance under the hood, this mixin allows you to keep your state separate from Prawn::Document's state, and also will prevent unexpected method name collisions due to late binding effects.

This mixin is mostly meant for extending Prawn's functionality with your own additions, but you can also use it to replace or wrap existing Prawn methods. Calling super will still work as expected, and alternatively you can explictly call document.some_method to delegate to Prawn where needed.

Experimental API (collapse)

Dynamic Method Handling

This class handles dynamic methods through the method_missing method

- (Object) method_missing(m, *a, &b)

Delegates all unhandled calls to object returned by document method. (which is an instance of Prawn::Document by default)



66
67
68
69
70
# File 'lib/prawn/view.rb', line 66

def method_missing(m, *a, &b)
  return super unless document.respond_to?(m)

  document.send(m, *a, &b)
end

Instance Method Details

- (Object) document

Lazily instantiates a Prawn::Document object.

You can also redefine this method in your own classes to use a custom document class.



60
61
62
# File 'lib/prawn/view.rb', line 60

def document
  @document ||= Prawn::Document.new
end

- (Object) save_as(filename)

Syntatic sugar that calls document.render_file under the hood.

greeter.save_as("greetings.pdf")


87
88
89
# File 'lib/prawn/view.rb', line 87

def save_as(filename)
  document.render_file(filename)
end

- (Object) update(&b)

Syntactic sugar that uses instance_eval under the hood to provide a block-based DSL.

greeter.update do
  say_hello
  say_goodbye
end


80
81
82
# File 'lib/prawn/view.rb', line 80

def update(&b)
  instance_eval(&b)
end