Sha256: dad5c32b7d85f1389b49319be1d38e71a7743222dbb03b855888221bea5de439

Contents?: true

Size: 1.63 KB

Versions: 12

Compression:

Stored size: 1.63 KB

Contents

# encoding: utf-8

# span.rb : Implements text columns
#
# Copyright September 2008, Gregory Brown. All Rights Reserved.
#
# This is free software. Please see the LICENSE and COPYING files for details.

module Prawn
  class Document
    # A span is a special purpose bounding box that allows a column of 
    # elements to be positioned relative to the margin_box.  
    #
    # Arguments:
    # +width+:: The width of the column in PDF points
    #
    # Options:
    # <tt>:position</tt>:: One of :left, :center, :right or an x offset
    #
    # This method is typically used for flowing a column of text from one 
    # page to the next.
    #
    #  span(350, :position => :center) do
    #    text "Here's some centered text in a 350 point column. " * 100
    #  end
    #  
    def span(width, options={})
      Prawn.verify_options [:position], options
      original_position = self.y      
     
      # FIXME: Any way to move this upstream?
      left_boundary = case(options[:position] || :left)
      when :left
        margin_box.absolute_left
      when :center
        margin_box.absolute_left + margin_box.width / 2.0 - width /2.0
      when :right
        margin_box.absolute_right - width
      when Numeric
        margin_box.absolute_left + options[:position]
      else
        raise ArgumentError, "Invalid option for :position"
      end
      
      # we need to bust out of whatever nested bounding boxes we're in.
      canvas do
        bounding_box([left_boundary, 
                      margin_box.absolute_top], :width => width) do
          self.y = original_position
          yield
        end
      end          
    end
  end
end

Version data entries

12 entries across 12 versions & 5 rubygems

Version Path
prawn-1.0.0.rc2 lib/prawn/document/span.rb
nurettin-prawn-1.0.0.rc1 lib/prawn/document/span.rb
prawn-1.0.0.rc1 lib/prawn/document/span.rb
prawn-0.12.0 lib/prawn/document/span.rb
prawn-0.11.1 lib/prawn/document/span.rb
davebenvenuti-prawn-0.11.1.pre lib/prawn/document/span.rb
prawn-0.11.1.pre lib/prawn/document/span.rb
prawn-core-0.8.4 lib/prawn/document/span.rb
prawn-graph-0.0.2 vendor/prawn-core/lib/prawn/document/span.rb
prawn-graph-0.0.1 vendor/prawn-core/lib/prawn/document/span.rb
prawn-core-0.7.2 lib/prawn/document/span.rb
prawn-core-0.7.1 lib/prawn/document/span.rb