prawn-table-continued 1.0.0.rc1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (47) hide show
  1. checksums.yaml +7 -0
  2. data/COPYING +2 -0
  3. data/GPLv2 +340 -0
  4. data/GPLv3 +674 -0
  5. data/Gemfile +3 -0
  6. data/LICENSE +56 -0
  7. data/lib/prawn/table/cell/image.rb +69 -0
  8. data/lib/prawn/table/cell/in_table.rb +33 -0
  9. data/lib/prawn/table/cell/span_dummy.rb +93 -0
  10. data/lib/prawn/table/cell/subtable.rb +66 -0
  11. data/lib/prawn/table/cell/text.rb +155 -0
  12. data/lib/prawn/table/cell.rb +787 -0
  13. data/lib/prawn/table/cells.rb +261 -0
  14. data/lib/prawn/table/column_width_calculator.rb +182 -0
  15. data/lib/prawn/table/version.rb +5 -0
  16. data/lib/prawn/table.rb +711 -0
  17. data/manual/contents.rb +13 -0
  18. data/manual/example_helper.rb +8 -0
  19. data/manual/images/prawn.png +0 -0
  20. data/manual/images/stef.jpg +0 -0
  21. data/manual/table/basic_block.rb +53 -0
  22. data/manual/table/before_rendering_page.rb +26 -0
  23. data/manual/table/cell_border_lines.rb +24 -0
  24. data/manual/table/cell_borders_and_bg.rb +31 -0
  25. data/manual/table/cell_dimensions.rb +36 -0
  26. data/manual/table/cell_text.rb +38 -0
  27. data/manual/table/column_widths.rb +30 -0
  28. data/manual/table/content_and_subtables.rb +39 -0
  29. data/manual/table/creation.rb +27 -0
  30. data/manual/table/filtering.rb +36 -0
  31. data/manual/table/flow_and_header.rb +17 -0
  32. data/manual/table/image_cells.rb +33 -0
  33. data/manual/table/position.rb +29 -0
  34. data/manual/table/row_colors.rb +20 -0
  35. data/manual/table/span.rb +30 -0
  36. data/manual/table/style.rb +33 -0
  37. data/manual/table/table.rb +52 -0
  38. data/manual/table/width.rb +27 -0
  39. data/prawn-table.gemspec +36 -0
  40. data/spec/cell_spec.rb +652 -0
  41. data/spec/extensions/encoding_helpers.rb +11 -0
  42. data/spec/extensions/file_fixture_helper.rb +15 -0
  43. data/spec/fixtures/files/prawn.png +0 -0
  44. data/spec/spec_helper.rb +50 -0
  45. data/spec/table/span_dummy_spec.rb +26 -0
  46. data/spec/table_spec.rb +1626 -0
  47. metadata +234 -0
@@ -0,0 +1,13 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Generates the Prawn by example manual.
4
+
5
+ require_relative "example_helper"
6
+
7
+ Encoding.default_external = Encoding::UTF_8
8
+
9
+ Prawn::ManualBuilder::Example.generate("manual.pdf",
10
+ :skip_page_creation => true, :page_size => "FOLIO") do
11
+
12
+ load_package "table"
13
+ end
@@ -0,0 +1,8 @@
1
+ # encoding: UTF-8
2
+
3
+ require "prawn"
4
+ require_relative "../lib/prawn/table"
5
+
6
+ require "prawn/manual_builder"
7
+
8
+ Prawn::ManualBuilder.manual_dir = File.dirname(__FILE__)
Binary file
Binary file
@@ -0,0 +1,53 @@
1
+ # encoding: utf-8
2
+ #
3
+ # All of the previous styling options we've seen deal with all the table cells
4
+ # at once.
5
+ #
6
+ # With initializer blocks we may deal with specific cells.
7
+ # A block passed to one of the table methods (<code>Prawn::Table.new</code>,
8
+ # <code>Prawn::Document#table</code>, <code>Prawn::Document#make_table</code>)
9
+ # will be called after cell setup but before layout. This is a very flexible way
10
+ # to specify styling and layout constraints.
11
+ #
12
+ # Just like the <code>Prawn::Document.generate</code> method, the table
13
+ # initializer blocks may be used with and without a block argument.
14
+ #
15
+ # The table class has three methods that are handy within an initializer block:
16
+ # <code>cells</code>, <code>rows</code> and <code>columns</code>. All three
17
+ # return an instance of <code>Prawn::Table::Cells</code> which represents
18
+ # a selection of cells.
19
+ #
20
+ # <code>cells</code> return all the table cells, while <code>rows</code> and
21
+ # <code>columns</code> accept a number or a range as argument which returns a
22
+ # single row/column or a range of rows/columns respectively. (<code>rows</code>
23
+ # and <code>columns</code> are also aliased as <code>row</code> and
24
+ # <code>column</code>)
25
+ #
26
+ # The <code>Prawn::Table::Cells</code> class also defines <code>rows</code> and
27
+ # <code>columns</code> so they may be chained to narrow the selection of cells.
28
+ #
29
+ # All of the cell styling options we've seen on previous examples may be set as
30
+ # properties of the selection of cells.
31
+ #
32
+ require File.expand_path(File.join(File.dirname(__FILE__),
33
+ %w[.. example_helper]))
34
+
35
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
36
+ Prawn::ManualBuilder::Example.generate(filename) do
37
+ data = [ ["Header", "A " * 5, "B"],
38
+ ["Data row", "C", "D " * 5],
39
+ ["Another data row", "E", "F"]]
40
+
41
+ table(data) do
42
+ cells.padding = 12
43
+ cells.borders = []
44
+
45
+ row(0).borders = [:bottom]
46
+ row(0).border_width = 2
47
+ row(0).font_style = :bold
48
+
49
+ columns(0..1).borders = [:right]
50
+
51
+ row(0).columns(0..1).borders = [:bottom, :right]
52
+ end
53
+ end
@@ -0,0 +1,26 @@
1
+ # encoding: utf-8
2
+ #
3
+ # <code>Prawn::Table#initialize</code> takes a
4
+ # <code>:before_rendering_page</code> argument, to adjust the way an entire page
5
+ # of table cells is styled. This allows you to do things like draw a border
6
+ # around the entire table as displayed on a page.
7
+ #
8
+ # The callback is passed a Cells object that is numbered based on the order of
9
+ # the cells on the page (e.g., the first row on the page is
10
+ # <code>cells.row(0)</code>).
11
+ #
12
+ require File.expand_path(File.join(File.dirname(__FILE__),
13
+ %w[.. example_helper]))
14
+
15
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
16
+ Prawn::ManualBuilder::Example.generate(filename) do
17
+ table([["foo", "bar", "baz"]] * 40) do |t|
18
+ t.cells.border_width = 1
19
+ t.before_rendering_page do |page|
20
+ page.row(0).border_top_width = 3
21
+ page.row(-1).border_bottom_width = 3
22
+ page.column(0).border_left_width = 3
23
+ page.column(-1).border_right_width = 3
24
+ end
25
+ end
26
+ end
@@ -0,0 +1,24 @@
1
+ # encoding: utf-8
2
+ #
3
+ # The <code>border_lines</code> option accepts an array with the styles of the
4
+ # border sides. The default is <code>[:solid, :solid, :solid, :solid]</code>.
5
+ #
6
+ # <code>border_lines</code> must be set to an array.
7
+ #
8
+ require File.expand_path(File.join(File.dirname(__FILE__),
9
+ %w[.. example_helper]))
10
+
11
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
12
+ Prawn::ManualBuilder::Example.generate(filename) do
13
+ data = [ ["Look at how the cell border lines can be mixed", "", ""],
14
+ ["dotted top border", "", ""],
15
+ ["solid right border", "", ""],
16
+ ["dotted bottom border", "", ""],
17
+ ["dashed left border", "", ""]
18
+ ]
19
+
20
+ text "Cell :border_lines => [:dotted, :solid, :dotted, :dashed]"
21
+
22
+ table(data, :cell_style =>
23
+ { :border_lines => [:dotted, :solid, :dotted, :dashed] })
24
+ end
@@ -0,0 +1,31 @@
1
+ # encoding: utf-8
2
+ #
3
+ # The <code>borders</code> option accepts an array with the border sides that
4
+ # will be drawn. The default is <code>[:top, :bottom, :left, :right]</code>.
5
+ #
6
+ # <code>border_width</code> may be set with a numeric value.
7
+ #
8
+ # Both <code>border_color</code> and <code>background_color</code> accept an
9
+ # HTML like RGB color string ("FF0000")
10
+ #
11
+ require File.expand_path(File.join(File.dirname(__FILE__),
12
+ %w[.. example_helper]))
13
+
14
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
15
+ Prawn::ManualBuilder::Example.generate(filename) do
16
+ data = [ ["Look at how the cells will look when styled", "", ""],
17
+ ["They probably won't look the same", "", ""]
18
+ ]
19
+
20
+ { :borders => [:top, :left],
21
+ :border_width => 3,
22
+ :border_color => "FF0000"}.each do |property, value|
23
+
24
+ text "Cell #{property}: #{value.inspect}"
25
+ table(data, :cell_style => {property => value})
26
+ move_down 20
27
+ end
28
+
29
+ text "Cell background_color: FFFFCC"
30
+ table(data, :cell_style => {:background_color => "FFFFCC"})
31
+ end
@@ -0,0 +1,36 @@
1
+ # encoding: utf-8
2
+ #
3
+ # To style all the table cells you can use the <code>:cell_style</code> option
4
+ # with the table methods. It accepts a hash with the cell style options.
5
+ #
6
+ # Some straightforward options are <code>width</code>, <code>height</code>,
7
+ # and <code>padding</code>. All three accept numeric values to set the property.
8
+ #
9
+ # <code>padding</code> also accepts a four number array that defines the padding
10
+ # in a CSS like syntax setting the top, right, bottom, left sequentially. The
11
+ # default is 5pt for all sides.
12
+ #
13
+ require File.expand_path(File.join(File.dirname(__FILE__),
14
+ %w[.. example_helper]))
15
+
16
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
17
+ Prawn::ManualBuilder::Example.generate(filename) do
18
+ data = [ ["Look at how the cells will look when styled", "", ""],
19
+ ["They probably won't look the same", "", ""]
20
+ ]
21
+
22
+ {:width => 160, :height => 50, :padding => 12}.each do |property, value|
23
+ text "Cell's #{property}: #{value}"
24
+ table(data, :cell_style => {property => value})
25
+ move_down 20
26
+ end
27
+
28
+ text "Padding can also be set with an array by specifying values for all sides: [0, 0, 0, 30]"
29
+ table(data, :cell_style => {:padding => [0, 0, 0, 30]}) # top, right, bottom, left
30
+
31
+ text "Padding can also be set by specifying only vertical and horizontal values: [0,30]"
32
+ table(data, :cell_style => {:padding => [0, 30]}) # vertical, horizontal
33
+
34
+ text "Padding can also be set by specifying top, horizontal and bottom values: [0,30,10]"
35
+ table(data, :cell_style => {:padding => [0, 30, 10]}) # top, horizontal, bottom
36
+ end
@@ -0,0 +1,38 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Text cells accept the following options: <code>align</code>,
4
+ # <code>font</code>, <code>font_style</code>, <code>inline_format</code>,
5
+ # <code>kerning</code>, <code>leading</code>, <code>min_font_size</code>,
6
+ # <code>overflow</code>, <code>rotate</code>, <code>rotate_around</code>,
7
+ # <code>single_line</code>, <code>size</code>, <code>text_color</code>,
8
+ # and <code>valign</code>.
9
+ #
10
+ # Most of these style options are direct translations from the text methods
11
+ # styling options.
12
+ #
13
+ require File.expand_path(File.join(File.dirname(__FILE__),
14
+ %w[.. example_helper]))
15
+
16
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
17
+ Prawn::ManualBuilder::Example.generate(filename) do
18
+ data = [ ["Look at how the cells will look when styled", "", ""],
19
+ ["They probably won't look the same", "", ""]
20
+ ]
21
+
22
+ table data, :cell_style => { :font => "Times-Roman", :font_style => :italic }
23
+ move_down 20
24
+
25
+ table data, :cell_style => { :size => 18, :text_color => "346842" }
26
+ move_down 20
27
+
28
+ table [["Just <font size='18'>some</font> <b><i>inline</i></b>", "", ""],
29
+ ["<color rgb='FF00FF'>styles</color> being applied here", "", ""]],
30
+ :cell_style => { :inline_format => true }
31
+ move_down 20
32
+
33
+ table [["1", "2", "3", "rotate"]], :cell_style => { :rotate => 30 }
34
+ move_down 20
35
+
36
+ table data, :cell_style => { :overflow => :shrink_to_fit, :min_font_size => 8,
37
+ :width => 60, :height => 30 }
38
+ end
@@ -0,0 +1,30 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Prawn will make its best attempt to identify the best width for the columns.
4
+ # If the end result isn't good, we can override it with some styling.
5
+ #
6
+ # Individual column widths can be set with the <code>:column_widths</code>
7
+ # option. Just provide an array with the sequential width values for the columns
8
+ # or a hash were each key-value pair represents the column 0-based index and its
9
+ # width.
10
+ #
11
+ require File.expand_path(File.join(File.dirname(__FILE__),
12
+ %w[.. example_helper]))
13
+
14
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
15
+ Prawn::ManualBuilder::Example.generate(filename) do
16
+ data = [ ["this is not quite as long as the others",
17
+ "here we have a line that is long but with smaller words",
18
+ "this is so very looooooooooooooooooooooooooooooong"] ]
19
+
20
+ text "Prawn trying to guess the column widths"
21
+ table(data)
22
+ move_down 20
23
+
24
+ text "Manually setting all the column widths"
25
+ table(data, :column_widths => [100, 200, 240])
26
+ move_down 20
27
+
28
+ text "Setting only the last column width"
29
+ table(data, :column_widths => {2 => 240})
30
+ end
@@ -0,0 +1,39 @@
1
+ # encoding: utf-8
2
+ #
3
+ # There are five kinds of objects which can be put in table cells:
4
+ # 1. String: produces a text cell (the most common usage)
5
+ # 2. <code>Prawn::Table::Cell</code>
6
+ # 3. <code>Prawn::Table</code>
7
+ # 4. Array
8
+ # 5. Images
9
+ #
10
+ # Whenever a table or an array is provided as a cell, a subtable will be created
11
+ # (a table within a cell).
12
+ #
13
+ # If you'd like to provide a cell or table directly, the best way is to
14
+ # use the <code>make_cell</code> and <code>make_table</code> methods as they
15
+ # don't call <code>draw</code> on the created object.
16
+ #
17
+ # To insert an image just provide a hash with an with an <code>:image</code> key
18
+ # pointing to the image path.
19
+ #
20
+ require File.expand_path(File.join(File.dirname(__FILE__),
21
+ %w[.. example_helper]))
22
+
23
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
24
+ Prawn::ManualBuilder::Example.generate(filename) do
25
+ cell_1 = make_cell(:content => "this row content comes directly ")
26
+ cell_2 = make_cell(:content => "from cell objects")
27
+
28
+ two_dimensional_array = [ ["..."], ["subtable from an array"], ["..."] ]
29
+
30
+ my_table = make_table([ ["..."], ["subtable from another table"], ["..."] ])
31
+
32
+ image_path = File.expand_path("../images/stef.jpg", __dir__)
33
+
34
+ table([ ["just a regular row", "", "", "blah blah blah"],
35
+ [cell_1, cell_2, "", ""],
36
+ ["", "", two_dimensional_array, ""],
37
+ ["just another regular row", "", "", ""],
38
+ [{:image => image_path}, "", my_table, ""]])
39
+ end
@@ -0,0 +1,27 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Creating tables with Prawn is fairly easy. There are two methods that will
4
+ # create tables for us <code>table</code> and <code>make_table</code>.
5
+ #
6
+ # Both are wrappers that create a new <code>Prawn::Table</code> object. The
7
+ # difference is that <code>table</code> calls the <code>draw</code> method
8
+ # after creating the table and <code>make_table</code> only returns the created
9
+ # table, so you have to call the <code>draw</code> method yourself.
10
+ #
11
+ # The most simple table can be created by providing only an array of arrays
12
+ # containing your data where each inner array represents one row.
13
+ #
14
+ require File.expand_path(File.join(File.dirname(__FILE__),
15
+ %w[.. example_helper]))
16
+
17
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
18
+ Prawn::ManualBuilder::Example.generate(filename) do
19
+ t = make_table([ ["this is the first row"],
20
+ ["this is the second row"] ])
21
+ t.draw
22
+ move_down 20
23
+
24
+ table([ ["short", "short", "loooooooooooooooooooong"],
25
+ ["short", "loooooooooooooooooooong", "short"],
26
+ ["loooooooooooooooooooong", "short", "short"] ])
27
+ end
@@ -0,0 +1,36 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Another way to reduce the number of cells is to <code>filter</code> the table.
4
+ #
5
+ # <code>filter</code> is just like <code>Enumerable#select</code>. Pass it a
6
+ # block and it will iterate through the cells returning a new
7
+ # <code>Prawn::Table::Cells</code> instance containing only those cells for
8
+ # which the block was not false.
9
+ #
10
+ require File.expand_path(File.join(File.dirname(__FILE__),
11
+ %w[.. example_helper]))
12
+
13
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
14
+ Prawn::ManualBuilder::Example.generate(filename) do
15
+ data = [ ["Item", "Jan Sales", "Feb Sales"],
16
+ ["Oven", 17, 89],
17
+ ["Fridge", 62, 30],
18
+ ["Microwave", 71, 47]
19
+ ]
20
+
21
+ table(data) do
22
+ values = cells.columns(1..-1).rows(1..-1)
23
+
24
+ bad_sales = values.filter do |cell|
25
+ cell.content.to_i < 40
26
+ end
27
+
28
+ bad_sales.background_color = "FFAAAA"
29
+
30
+ good_sales = values.filter do |cell|
31
+ cell.content.to_i > 70
32
+ end
33
+
34
+ good_sales.background_color = "AAFFAA"
35
+ end
36
+ end
@@ -0,0 +1,17 @@
1
+ # encoding: utf-8
2
+ #
3
+ # If the table cannot fit on the current page it will flow to the next page just
4
+ # like free flowing text. If you would like to have the first row treated as a
5
+ # header which will be repeated on subsequent pages set the <code>:header</code>
6
+ # option to true.
7
+ #
8
+ require File.expand_path(File.join(File.dirname(__FILE__),
9
+ %w[.. example_helper]))
10
+
11
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
12
+ Prawn::ManualBuilder::Example.generate(filename) do
13
+ data = [["This row should be repeated on every new page"]]
14
+ data += [["..."]] * 30
15
+
16
+ table(data, :header => true)
17
+ end
@@ -0,0 +1,33 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Prawn can insert images into a table. Just pass a hash into
4
+ # <code>table()</code> with an <code>:image</code> key pointing to the image.
5
+ #
6
+ # You can pass the <code>:scale</code>, <code>:fit</code>,
7
+ # <code>:position</code>, and <code>:vposition</code> arguments in alongside
8
+ # <code>:image</code>; these will function just as in <code>image()</code>.
9
+ #
10
+ # The <code>:image_width</code> and <code>:image_height</code> arguments set
11
+ # the width/height of the image within the cell, as opposed to the
12
+ # <code>:width</code> and <code>:height</code> arguments, which set the table
13
+ # cell's dimensions.
14
+ #
15
+ require File.expand_path(File.join(File.dirname(__FILE__),
16
+ %w[.. example_helper]))
17
+
18
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
19
+ Prawn::ManualBuilder::Example.generate(filename) do
20
+ image = File.expand_path("../images/prawn.png", __dir__)
21
+
22
+ table [
23
+ ["Standard image cell", {:image => image}],
24
+ [":scale => 0.5", {:image => image, :scale => 0.5}],
25
+ [":fit => [100, 200]", {:image => image, :fit => [100, 200]}],
26
+ [":image_height => 50,
27
+ :image_width => 100", {:image => image, :image_height => 50,
28
+ :image_width => 100}],
29
+ [":position => :center", {:image => image, :position => :center}],
30
+ [":vposition => :center", {:image => image, :vposition => :center,
31
+ :height => 200}]
32
+ ], :width => bounds.width
33
+ end
@@ -0,0 +1,29 @@
1
+ # encoding: utf-8
2
+ #
3
+ # The <code>table()</code> method accepts a <code>:position</code> argument to
4
+ # determine horizontal position of the table within its bounding box. It can be
5
+ # <code>:left</code> (the default), <code>:center</code>, <code>:right</code>,
6
+ # or a number specifying a distance in PDF points from the left side.
7
+ #
8
+ require File.expand_path(File.join(File.dirname(__FILE__),
9
+ %w[.. example_helper]))
10
+
11
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
12
+ Prawn::ManualBuilder::Example.generate(filename) do
13
+ data = [["The quick brown fox jumped over the lazy dogs."]] * 2
14
+
15
+ text "Left:"
16
+ table data, :position => :left
17
+ move_down 10
18
+
19
+ text "Center:"
20
+ table data, :position => :center
21
+ move_down 10
22
+
23
+ text "Right:"
24
+ table data, :position => :right
25
+ move_down 10
26
+
27
+ text "100pt:"
28
+ table data, :position => 100
29
+ end
@@ -0,0 +1,20 @@
1
+ # encoding: utf-8
2
+ #
3
+ # One of the most common table styling techniques is to stripe the rows with
4
+ # alternating colors.
5
+ #
6
+ # There is one helper just for that. Just provide the <code>:row_colors</code>
7
+ # option an array with color values.
8
+ #
9
+ require File.expand_path(File.join(File.dirname(__FILE__),
10
+ %w[.. example_helper]))
11
+
12
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
13
+ Prawn::ManualBuilder::Example.generate(filename) do
14
+ data = [["This row should have one color"],
15
+ ["And this row should have another"]]
16
+
17
+ data += [["..."]] * 10
18
+
19
+ table(data, :row_colors => ["F0F0F0", "FFFFCC"])
20
+ end
@@ -0,0 +1,30 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Table cells can span multiple columns, rows, or both. When building a cell,
4
+ # use the hash argument constructor with a <code>:colspan</code> and/or
5
+ # <code>:rowspan</code> argument. Row or column spanning must be specified when
6
+ # building the data array; you can't set the span in the table's initialization
7
+ # block. This is because cells are laid out in the grid before that block is
8
+ # called, so that references to row and column numbers make sense.
9
+ #
10
+ # Cells are laid out in the order given, skipping any positions spanned by
11
+ # previously instantiated cells. Therefore, a cell with <code>rowspan: 2</code>
12
+ # will be missing at least one cell in the row below it. See the code and table
13
+ # below for an example.
14
+ #
15
+ # It is illegal to overlap cells via spanning. A
16
+ # <code>Prawn::Errors::InvalidTableSpan</code> error will be raised if spans
17
+ # would cause cells to overlap.
18
+ #
19
+ require File.expand_path(File.join(File.dirname(__FILE__),
20
+ %w[.. example_helper]))
21
+
22
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
23
+ Prawn::ManualBuilder::Example.generate(filename) do
24
+ table([
25
+ ["A", {:content => "2x1", :colspan => 2}, "B"],
26
+ [{:content => "1x2", :rowspan => 2}, "C", "D", "E"],
27
+ [{:content => "2x2", :colspan => 2, :rowspan => 2}, "F"],
28
+ ["G", "H"]
29
+ ])
30
+ end
@@ -0,0 +1,33 @@
1
+ # encoding: utf-8
2
+ #
3
+ # We've seen how to apply styles to a selection of cells by setting the
4
+ # individual properties. Another option is to use the <code>style</code> method
5
+ #
6
+ # <code>style</code> lets us define multiple properties at once with a hash. It
7
+ # also accepts a block that will be called for each cell and can be used for
8
+ # some complex styling.
9
+ #
10
+ # Individual cell styles can also be applied when defining the data for the
11
+ # table using a hash syntax for the cell. This style will take precedence over
12
+ # any table level cell styles. See the "cell_text" section for a list of
13
+ # options.
14
+
15
+ require File.expand_path(File.join(File.dirname(__FILE__),
16
+ %w[.. example_helper]))
17
+
18
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
19
+ Prawn::ManualBuilder::Example.generate(filename) do
20
+ table([[""] * 8] * 8) do
21
+ cells.style(:width => 24, :height => 24)
22
+
23
+ cells.style do |c|
24
+ c.background_color = ((c.row + c.column) % 2).zero? ? '000000' : 'ffffff'
25
+ end
26
+ end
27
+ move_down 20
28
+
29
+ table(
30
+ [%w[A B], ['C', { content: 'D', text_color: 'ff0000' }]],
31
+ cell_style: { text_color: '0000ff' }
32
+ )
33
+ end
@@ -0,0 +1,52 @@
1
+ # encoding: utf-8
2
+ #
3
+ # Examples for tables.
4
+ #
5
+ require File.expand_path(File.join(File.dirname(__FILE__),
6
+ %w[.. example_helper]))
7
+
8
+ Prawn::ManualBuilder::Example.generate("table.pdf", :page_size => "FOLIO") do
9
+ package "table" do |p|
10
+ p.name = "Prawn::Table"
11
+
12
+ p.section "Basics" do |s|
13
+ s.example "creation"
14
+ s.example "content_and_subtables"
15
+ s.example "flow_and_header"
16
+ s.example "position"
17
+ end
18
+
19
+ p.section "Styling" do |s|
20
+ s.example "column_widths"
21
+ s.example "width"
22
+ s.example "row_colors"
23
+ s.example "cell_dimensions"
24
+ s.example "cell_borders_and_bg"
25
+ s.example "cell_border_lines"
26
+ s.example "cell_text"
27
+ s.example "image_cells"
28
+ s.example "span"
29
+ s.example "before_rendering_page"
30
+ end
31
+
32
+ p.section "Initializer Block" do |s|
33
+ s.example "basic_block"
34
+ s.example "filtering"
35
+ s.example "style"
36
+ end
37
+
38
+ p.intro do
39
+ prose("Prawn-table provides support for tables in Prawn. Tables can be styled in whatever way you see fit. The whole table, rows, columns and cells can be styled independently from each other.
40
+
41
+ The examples show:")
42
+
43
+ list( "How to create tables",
44
+ "What content can be placed on tables",
45
+ "Subtables (or tables within tables)",
46
+ "How to style the whole table",
47
+ "How to use initializer blocks to style only specific portions of the table"
48
+ )
49
+ end
50
+
51
+ end
52
+ end
@@ -0,0 +1,27 @@
1
+ # encoding: utf-8
2
+ #
3
+ # The default table width depends on the content provided. It will expand up
4
+ # to the current bounding box width to fit the content. If you want the table to
5
+ # have a fixed width no matter the content you may use the <code>:width</code>
6
+ # option to manually set the width.
7
+ #
8
+ require File.expand_path(File.join(File.dirname(__FILE__),
9
+ %w[.. example_helper]))
10
+
11
+ filename = File.basename(__FILE__).gsub('.rb', '.pdf')
12
+ Prawn::ManualBuilder::Example.generate(filename) do
13
+ text "Normal width:"
14
+ table [%w[A B C]]
15
+ move_down 20
16
+
17
+ text "Fixed width:"
18
+ table([%w[A B C]], :width => 300)
19
+ move_down 20
20
+
21
+ text "Normal width:"
22
+ table([["A", "Blah " * 20, "C"]])
23
+ move_down 20
24
+
25
+ text "Fixed width:"
26
+ table([["A", "Blah " * 20, "C"]], :width => 300)
27
+ end