Class: Tabulatr
- Inherits:
-
Object
- Object
- Tabulatr
- Includes:
- ActionView::Helpers::FormOptionsHelper, ActionView::Helpers::FormTagHelper, ActionView::Helpers::TagHelper, ActionView::Helpers::TranslationHelper
- Defined in:
- lib/tabulatr/tabulatr.rb,
lib/tabulatr/version.rb,
lib/tabulatr/tabulatr/settings.rb,
lib/tabulatr/tabulatr/data_cell.rb,
lib/tabulatr/tabulatr/paginator.rb,
lib/tabulatr/tabulatr/filter_cell.rb,
lib/tabulatr/tabulatr/header_cell.rb,
lib/tabulatr/tabulatr/row_builder.rb,
lib/tabulatr/tabulatr/batch_actions.rb,
lib/tabulatr/tabulatr/check_controls.rb,
lib/generators/tabulatr/install_generator.rb
Overview
– Copyright © 2010-2011 Peter Horn, Provideal GmbH
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. ++
Defined Under Namespace
Modules: Finder, Formattr, Generators
Constant Summary collapse
- VERSION =
"0.0.2"
- TABLE_OPTIONS =
Hash keeping the defaults for the table options, may be overriden in the table_for call
WhinyHash.new({ # WhinyHash.new({ remote: false, # add data-remote="true" to form form_class: 'tabulatr_form', # class of the overall form table_class: 'tabulatr_table', # class for the actual data table sortable_class: 'sortable', # class for the header of a sortable column sorting_asc_class: 'sorting-asc', # class for the currently asc sorting column sorting_desc_class: 'sorting-desc', # class for the currently desc sorting column page_left_class: 'page-left', # class for the page left button page_right_class: 'page-right', # class for the page right button page_no_class: 'page-no', # class for the page no <input> control_div_class_before: 'table-controls', # class of the upper div containing the paging and batch action controls control_div_class_after: 'table-controls', # class of the lower div containing the paging and batch action controls paginator_div_class: 'paginator', # class of the div containing the paging controls batch_actions_div_class: 'batch-actions', # class of the div containing the batch action controls select_controls_div_class: 'check-controls', # class of the div containing the check controls submit_class: 'submit-table', # class of submit button pagesize_select_class: 'pagesize_select', # class of the pagesize select element select_all_class: 'select-btn', # class of the select all button select_none_class: 'select-btn', # class of the select none button select_visible_class: 'select-btn', # class of the select visible button unselect_visible_class: 'select-btn', # class of the unselect visible button select_filtered_class: 'select-btn', # class of the select filtered button unselect_filtered_class: 'select-btn', # class of the unselect filteredbutton info_text_class: 'info-text', # class of the info text div batch_actions_label: 'Batch Action: ', # Text to show in front of the batch action select batch_actions_type: :select, # :select or :button depending on the kind of input you want batch_actions_class: 'batch-action-inputs', # class to apply on the batch action input elements submit_label: 'Apply', # Text on the submit button select_all_label: 'Select All', # Text on the select all button select_none_label: 'Select None', # Text on the select none button select_visible_label: 'Select visible', # Text on the select visible button unselect_visible_label: 'Unselect visible', # Text on the unselect visible button select_filtered_label: 'Select filtered', # Text on the select filtered button unselect_filtered_label: 'Unselect filtered',# Text on the unselect filtered button info_text: "Showing %1$d, total %2$d, selected %3$d, matching %4$d", # which controls to be rendered above and below the tabel and in which order before_table_controls: [:submit, :paginator, :batch_actions, :select_controls, :info_text], after_table_controls: [], # whih selecting controls to render in which order select_controls: [:select_all, :select_none, :select_visible, :unselect_visible, :select_filtered, :unselect_filtered], image_path_prefix: '/images/tabulatr/', pager_left_button: 'left.gif', pager_left_button_inactive: 'left_off.gif', pager_right_button: 'right.gif', pager_right_button_inactive: 'right_off.gif', sort_up_button: 'up.gif', sort_up_button_inactive: 'up_off.gif', sort_down_button: 'down.gif', sort_down_button_inactive: 'down_off.gif', make_form: true, # whether or not to wrap the whole table (incl. controls) in a form table_html: false, # a hash with html attributes for the table row_html: false, # a hash with html attributes for the normal trs header_html: false, # a hash with html attributes for the header trs filter_html: false, # a hash with html attributes for the filter trs filter: true, # false for no filter row at all paginate: true, # true to show paginator sortable: true, # true to allow sorting (can be specified for every sortable column) selectable: true, # true to render "select all", "select none" and the like action: nil, # target action of the wrapping form if applicable batch_actions: false, # name: value hash of batch action stuff translate: false, # call t() for all 'labels' and stuff, possible values are true/:translate or :localize row_classes: ['odd', 'even'] # class for the trs })
- TABLE_FORM_OPTIONS =
these settings are considered constant for the whole application, can not be overridden on a per-table basis. That’s necessary to allow find_for_table to work properly
WhinyHash.new({ batch_action_name: 'batch_action', # name of the batch action param sort_by_key: 'sort_by_key', # name of key which to search, format is 'id asc' pagination_postfix: '_pagination', # name of the param w/ the pagination infos filter_postfix: '_filter', # postfix for name of the filter in the params hash: xxx_filter sort_postfix: '_sort', # postfix for name of the filter in the params hash: xxx_filter checked_postfix: '_checked', # postfix for name of the checked in the params hash: xxx_filter associations_filter: '__association', # name of the associations in the filter hash method: 'post', # http method for that form if applicable batch_postfix: '_batch', # postfix for name of the batch action select checked_separator: ',' # symbol to separate the checked ids })
- PAGINATE_OPTIONS =
these settings are considered constant for the whole application, can not be overridden on a per-table basis. That’s necessary to allow find_for_table to work properly
ActiveSupport::HashWithIndifferentAccess.new({ page: 1, pagesize: 10, pagesizes: [10, 20, 50] })
- COLUMN_OPTIONS =
Hash keeping the defaults for the column options
ActiveSupport::HashWithIndifferentAccess.new({ header: false, # a string to write into the header cell width: false, # the width of the cell align: false, # horizontal alignment valign: false, # vertical alignment wrap: true, # wraps type: :string, # :integer, :date td_html: false, # a hash with html attributes for the cells th_html: false, # a hash with html attributes for the header cell filter_html: false, # a hash with html attributes for the filter cell filter: true, # false for no filter field, # container for options_for_select # String from options_from_collection_for_select or the like # :range for range spec # :checkbox for a 0/1 valued checkbox checkbox_value: '1', # value if checkbox is checked checkbox_label: '', # text behind the checkbox filter_width: '97%', # width of the filter <input> range_filter_symbol: '–', # put between the <inputs> of the range filter format: false, # a sprintf-string or a proc to do special formatting method: false, # if you want to get the column by a different method than its name link: false, # proc or symbol to make the content a link join_symbol: ', ', # symbol used to join the elements of 'many' associations sortable: true # if set, sorting-stuff is added to the header cell })
- FINDER_INJECT_OPTIONS =
these settings are considered constant for the whole application, can not be overridden on a per-table basis. That’s necessary to allow find_for_table to work properly
WhinyHash.new({ pagination: :__pagination, filters: :__filters, classname: :__classname, sorting: :__sorting, checked: :__checked, store_data: :__store_data })
- FINDER_OPTIONS =
defaults for the find_for_table
WhinyHash.new({ default_order: false, default_pagesize: false, precondition: false, store_data: false })
- SQL_OPTIONS =
Stupid hack
WhinyHash.new({ like: 'LIKE' })
Class Method Summary collapse
- .column_options(n = nil) ⇒ Object
- .finder_inject_options(n = nil) ⇒ Object
- .finder_options(n = nil) ⇒ Object
- .paginate_options(n = nil) ⇒ Object
- .sql_options(n = nil) ⇒ Object
- .table_design_options(n = nil) ⇒ Object
- .table_form_options(n = nil) ⇒ Object
- .table_options(n = nil) ⇒ Object
Instance Method Summary collapse
- #action(opts = {}, &block) ⇒ Object
-
#association(relation, name, opts = {}, &block) ⇒ Object
called inside the build_table block, branches into data, header, or filter building methods depending on the current mode.
-
#build_table(&block) ⇒ Object
the actual table definition method.
-
#checkbox(opts = {}, &block) ⇒ Object
called inside the build_table block, branches into data, header, or filter building methods depending on the current mode.
-
#column(name, opts = {}, &block) ⇒ Object
called inside the build_table block, branches into data, header, or filter building methods depending on the current mode.
- #data_action(opts = {}, &block) ⇒ Object
-
#data_association(relation, name, opts = {}, &block) ⇒ Object
the method used to actually define the data cells of the columns, taking the name of the attribute and a hash of options.
- #data_checkbox(opts = {}, &block) ⇒ Object
-
#data_column(name, opts = {}, &block) ⇒ Object
the method used to actually define the data cells of the columns, taking the name of the attribute and a hash of options.
- #filter_action(opts = {}, &block) ⇒ Object
-
#filter_association(relation, name, opts = {}, &block) ⇒ Object
the method used to actually define the filters of the columns, taking the name of the attribute and a hash of options.
- #filter_checkbox(opts = {}, &block) ⇒ Object
-
#filter_column(name, opts = {}, &block) ⇒ Object
the method used to actually define the filters of the columns, taking the name of the attribute and a hash of options.
- #header_action(opts = {}, &block) ⇒ Object
-
#header_association(relation, name, opts = {}, &block) ⇒ Object
the method used to actually define the headers of the columns, taking the name of the attribute and a hash of options.
- #header_checkbox(opts = {}, &block) ⇒ Object
-
#header_column(name, opts = {}, &block) ⇒ Object
the method used to actually define the headers of the columns, taking the name of the attribute and a hash of options.
-
#initialize(records, view = nil, toptions = {}) ⇒ Tabulatr
constructor
Constructor of Tabulatr.
-
#render_batch_actions ⇒ Object
render the select tag for batch actions.
- #render_element(element, &block) ⇒ Object
-
#render_paginator ⇒ Object
render the paginator controls, inputs etc.
- #render_select_controls ⇒ Object
- #render_table(&block) ⇒ Object
- #sql_options(n = nil) ⇒ Object
- #table_design_options(n = nil) ⇒ Object
Constructor Details
#initialize(records, view = nil, toptions = {}) ⇒ Tabulatr
Constructor of Tabulatr
Parameters:
records
-
the ‘row’ data of the table
view
-
the current instance of ActionView
opts
-
a hash of options specific for this table
51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 |
# File 'lib/tabulatr/tabulatr.rb', line 51 def initialize(records, view=nil, ={}) @records = records @view = view @table_options = TABLE_OPTIONS.merge() @table_form_options = TABLE_FORM_OPTIONS @val = [] @record = nil @row_mode = false @classname = @records.send(FINDER_INJECT_OPTIONS[:classname]) @pagination = @records.send(FINDER_INJECT_OPTIONS[:pagination]) @filters = @records.send(FINDER_INJECT_OPTIONS[:filters]) @sorting = @records.send(FINDER_INJECT_OPTIONS[:sorting]) @checked = @records.send(FINDER_INJECT_OPTIONS[:checked]) @store_data = @records.send(FINDER_INJECT_OPTIONS[:store_data]) @should_translate = @table_options[:translate] end |
Class Method Details
.column_options(n = nil) ⇒ Object
189 190 191 192 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 189 def self.(n=nil) COLUMN_OPTIONS.merge!(n) if n COLUMN_OPTIONS end |
.finder_inject_options(n = nil) ⇒ Object
179 180 181 182 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 179 def self.(n=nil) FINDER_INJECT_OPTIONS.merge!(n) if n FINDER_INJECT_OPTIONS end |
.finder_options(n = nil) ⇒ Object
184 185 186 187 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 184 def self.(n=nil) FINDER_OPTIONS.merge!(n) if n FINDER_OPTIONS end |
.paginate_options(n = nil) ⇒ Object
199 200 201 202 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 199 def self.(n=nil) PAGINATE_OPTIONS.merge!(n) if n PAGINATE_OPTIONS end |
.sql_options(n = nil) ⇒ Object
214 215 216 217 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 214 def self.(n=nil) SQL_OPTIONS.merge!(n) if n SQL_OPTIONS end |
.table_design_options(n = nil) ⇒ Object
209 210 211 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 209 def self.(n=nil) raise("table_design_options stopped existing. Use table_options instead.") end |
.table_form_options(n = nil) ⇒ Object
204 205 206 207 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 204 def self.(n=nil) TABLE_FORM_OPTIONS.merge!(n) if n TABLE_FORM_OPTIONS end |
.table_options(n = nil) ⇒ Object
194 195 196 197 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 194 def self.(n=nil) TABLE_OPTIONS.merge!(n) if n TABLE_OPTIONS end |
Instance Method Details
#action(opts = {}, &block) ⇒ Object
65 66 67 68 69 70 71 72 73 |
# File 'lib/tabulatr/tabulatr/row_builder.rb', line 65 def action(opts={}, &block) #puts "column: '#{name}'" case @row_mode when :data then data_action(opts, &block) when :header then header_action(opts, &block) when :filter then filter_action(opts, &block) else raise "Wrong row mode '#{@row_mode}'" end # case end |
#association(relation, name, opts = {}, &block) ⇒ Object
called inside the build_table block, branches into data, header, or filter building methods depending on the current mode
43 44 45 46 47 48 49 50 51 |
# File 'lib/tabulatr/tabulatr/row_builder.rb', line 43 def association(relation, name, opts={}, &block) #puts "assoc: '#{relation}.#{name}'" case @row_mode when :data then data_association(relation, name, opts, &block) when :header then header_association(relation, name, opts, &block) when :filter then filter_association(relation, name, opts, &block) else raise "Wrong row mode '#{@row_mode}'" end # case end |
#build_table(&block) ⇒ Object
the actual table definition method. It takes an Array of records, a hash of options and a block with the actual column
calls.
The following options are evaluated here:
:table_html
-
a hash with html-attributes added to the <table> created
:header_html
-
a hash with html-attributes added to the <tr> created for the header row
:filter_html
-
a hash with html-attributes added to the <tr> created for the filter row
:row_html
-
a hash with html-attributes added to the <tr>s created for the data rows
:filter
-
if set to false, no filter row is output
80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 |
# File 'lib/tabulatr/tabulatr.rb', line 80 def build_table(&block) @val = [] make_tag(@table_options[:make_form] ? :form : nil, :method => :get, :class => @table_options[:form_class], 'data-remote' => (@table_options[:remote] ? "true" : nil)) do # TODO: make_tag(:input, :type => 'submit', :style => 'display:inline; width:1px; height:1px', :value => '__submit') make_tag(:div, :class => @table_options[:control_div_class_before]) do @table_options[:before_table_controls].each do |element| render_element(element) end end if @table_options[:before_table_controls].present? # </div> @store_data.each do |k,v| make_tag(:input, :type => :hidden, :name => k, :value => h(v)) end render_element(:table, &block) make_tag(:div, :class => @table_options[:control_div_class_after]) do @table_options[:after_table_controls].each do |element| render_element(element) end end if @table_options[:after_table_controls].present? # </div> end # </form> @val.join("").html_safe end |
#checkbox(opts = {}, &block) ⇒ Object
called inside the build_table block, branches into data, header, or filter building methods depending on the current mode
55 56 57 58 59 60 61 62 63 |
# File 'lib/tabulatr/tabulatr/row_builder.rb', line 55 def checkbox(opts={}, &block) #puts "column: '#{name}'" case @row_mode when :data then data_checkbox(opts, &block) when :header then header_checkbox(opts, &block) when :filter then filter_checkbox(opts, &block) else raise "Wrong row mode '#{@row_mode}'" end # case end |
#column(name, opts = {}, &block) ⇒ Object
called inside the build_table block, branches into data, header, or filter building methods depending on the current mode
31 32 33 34 35 36 37 38 39 |
# File 'lib/tabulatr/tabulatr/row_builder.rb', line 31 def column(name, opts={}, &block) #puts "column: '#{name}'" case @row_mode when :data then data_column(name, opts, &block) when :header then header_column(name, opts, &block) when :filter then filter_column(name, opts, &block) else raise "Wrong row mode '#{@row_mode}'" end # case end |
#data_action(opts = {}, &block) ⇒ Object
106 107 108 109 110 111 112 113 114 115 116 |
# File 'lib/tabulatr/tabulatr/data_cell.rb', line 106 def data_action(opts={}, &block) raise "Not in data mode!" if @row_mode != :data opts = opts make_tag(:td, opts[:td_html]) do if block_given? concat(yield(@record)) else raise "Always give a block ino action columns" end # block_given? end # </td> end |
#data_association(relation, name, opts = {}, &block) ⇒ Object
the method used to actually define the data cells of the columns, taking the name of the attribute and a hash of options.
The following options are evaluated here:
:td_html
-
a hash with html-attributes added to the <ts>s created
:method
-
the actual method invoked on the record to retrieve the value for the column, or false if name is to be used.
:fromat
-
either a String by which the value is
sprinf
ed, a proc/lambda to which the value is passed or false if no specific formatting is desired.
74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 |
# File 'lib/tabulatr/tabulatr/data_cell.rb', line 74 def data_association(relation, name, opts={}, &block) raise "Not in data mode!" if @row_mode != :data opts = opts if block_given? return yield(@record) end assoc = @record.class.reflect_on_association(relation) make_tag(:td, opts[:td_html]) do concat(if assoc.collection? @record.send relation else [ @record.send(relation.to_sym) ] end.map do |r| val = h(r.send(opts[:method] || name)) val = opts[:format].call(val) if opts[:format].class == Proc val = (opts[:format] % val) if opts[:format].class == String val end.join(opts[:join_symbol])) end # </td> end |
#data_checkbox(opts = {}, &block) ⇒ Object
95 96 97 98 99 100 101 102 103 104 |
# File 'lib/tabulatr/tabulatr/data_cell.rb', line 95 def data_checkbox(opts={}, &block) raise "Whatever that's for!" if block_given? iname = "#{@classname}#{@table_form_options[:checked_postfix]}[current_page][]" make_tag(:td, opts[:td_html]) do checked = @checked[:selected].member?(@record.id.to_s) ? :checked : nil make_tag(:input, :type => 'checkbox', :name => iname, :id => "#{@classname}#{@table_form_options[:checked_postfix]}_#{@record.id.to_s}", :value => @record.id, :checked => checked) end end |
#data_column(name, opts = {}, &block) ⇒ Object
the method used to actually define the data cells of the columns, taking the name of the attribute and a hash of options.
The following options are evaluated here:
:td_html
-
a hash with html-attributes added to the <ts>s created
:method
-
the actual method invoked on the record to retrieve the value for the column, or false if name is to be used.
:fromat
-
either a String by which the value is
sprinf
ed, a proc/lambda to which the value is passed or false if no specific formatting is desired.
36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 |
# File 'lib/tabulatr/tabulatr/data_cell.rb', line 36 def data_column(name, opts={}, &block) raise "Not in data mode!" if @row_mode != :data opts = opts make_tag(:td, opts[:td_html]) do href = if opts[:link].class == Symbol || opts[:link].class == String @view.send(opts[:link], @record) elsif opts[:link].respond_to?(:call) opts[:link].call(@record) else nil end make_tag((href ? :a : nil), :href => href) do if block_given? concat(yield(@record)) else val = @record.send(opts[:method] || name) format = opts[:format] concat( if format.is_a?(Proc) then format.call(val) elsif format.is_a?(String) then h(format % val) elsif format.is_a?(Symbol) then Tabulatr::Formattr.format(format, val) else h(val.to_s) end) end # block_given? end # </a> end # </td> end |
#filter_action(opts = {}, &block) ⇒ Object
84 85 86 87 88 89 90 |
# File 'lib/tabulatr/tabulatr/filter_cell.rb', line 84 def filter_action(opts={}, &block) raise "Not in filter mode!" if @row_mode != :filter opts = (opts) make_tag(:td, opts[:filter_html]) do concat(t(opts[:filter])) unless [true, false, nil].member?(opts[:filter]) end # </td> end |
#filter_association(relation, name, opts = {}, &block) ⇒ Object
the method used to actually define the filters of the columns, taking the name of the attribute and a hash of options.
The following options are evaluated here:
:filter_html
-
a hash with html-attributes added to the <ts>s created
:filter
-
may take different values:
false
-
no filter is output for this column
- a Hash
-
the keys of the hash are used to define a
select
where the values are thevalue
of theoptions
. - an Array
-
the elements of that array are used to define a
select
- a subclass of
ActiveRecord::Base
-
a
select
is created with all instances
63 64 65 66 67 68 69 70 71 72 73 |
# File 'lib/tabulatr/tabulatr/filter_cell.rb', line 63 def filter_association(relation, name, opts={}, &block) raise "Not in filter mode!" if @row_mode != :filter opts = (opts) filters = (@filters[@table_form_options[:associations_filter]] || {}) value = filters["#{relation}.#{name}"] make_tag(:td, opts[:filter_html]) do of = opts[:filter] iname = "#{@classname}#{@table_form_options[:filter_postfix]}[#{@table_form_options[:associations_filter]}][#{relation}.#{name}]" filter_tag(of, iname, value, opts) end # </td> end |
#filter_checkbox(opts = {}, &block) ⇒ Object
75 76 77 78 79 80 81 82 |
# File 'lib/tabulatr/tabulatr/filter_cell.rb', line 75 def filter_checkbox(opts={}, &block) raise "Whatever that's for!" if block_given? make_tag(:td, opts[:filter_html]) do iname = "#{@classname}#{@table_form_options[:checked_postfix]}" make_tag(:input, :type => 'hidden', :name => "#{iname}[checked_ids]", :value => @checked[:checked_ids]) make_tag(:input, :type => 'hidden', :name => "#{iname}[visible]", :value => @checked[:visible]) end end |
#filter_column(name, opts = {}, &block) ⇒ Object
the method used to actually define the filters of the columns, taking the name of the attribute and a hash of options.
The following options are evaluated here:
:filter_html
-
a hash with html-attributes added to the <ts>s created
:filter
-
may take different values:
false
-
no filter is output for this column
- a container
-
the keys of the hash are used to define a
select
where the values are the <tt>value</tt> of the <tt>options</tt>.
- an Array
-
the elements of that array are used to define a
select
- a String
-
a
select
is created with that String as options you can use ActionView#collection_select and the like
39 40 41 42 43 44 45 46 47 48 |
# File 'lib/tabulatr/tabulatr/filter_cell.rb', line 39 def filter_column(name, opts={}, &block) raise "Not in filter mode!" if @row_mode != :filter opts = (opts) value = @filters[name] make_tag(:td, opts[:filter_html]) do of = opts[:filter] iname = "#{@classname}#{@table_form_options[:filter_postfix]}[#{name}]" filter_tag(of, iname, value, opts) end # </td> end |
#header_action(opts = {}, &block) ⇒ Object
88 89 90 91 92 |
# File 'lib/tabulatr/tabulatr/header_cell.rb', line 88 def header_action(opts={}, &block) make_tag(:th, opts[:th_html]) do concat(t(opts[:header] || ""), :escape_html) end end |
#header_association(relation, name, opts = {}, &block) ⇒ Object
the method used to actually define the headers of the columns, taking the name of the attribute and a hash of options.
The following options are evaluated here:
:th_html
-
a hash with html-attributes added to the <th>s created
:header
-
if present, the value will be output in the header cell, otherwise, the capitalized name is used
70 71 72 73 74 75 76 77 78 79 |
# File 'lib/tabulatr/tabulatr/header_cell.rb', line 70 def header_association(relation, name, opts={}, &block) raise "Not in header mode!" if @row_mode != :header opts = opts if opts[:sortable] and @table_options[:sortable] # change classes accordingly end make_tag(:th, opts[:th_html]) do concat(t(opts[:header] || "#{relation.to_s.capitalize} #{name.to_s.capitalize}"), :escape_html) end # </th> end |
#header_checkbox(opts = {}, &block) ⇒ Object
81 82 83 84 85 86 |
# File 'lib/tabulatr/tabulatr/header_cell.rb', line 81 def header_checkbox(opts={}, &block) raise "Whatever that's for!" if block_given? make_tag(:th, opts[:th_html]) do concat(t(opts[:header] || ""), :escape_html) end end |
#header_column(name, opts = {}, &block) ⇒ Object
the method used to actually define the headers of the columns, taking the name of the attribute and a hash of options.
The following options are evaluated here:
:th_html
-
a hash with html-attributes added to the <th>s created
:header
-
if present, the value will be output in the header cell, otherwise, the capitalized name is used
34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 |
# File 'lib/tabulatr/tabulatr/header_cell.rb', line 34 def header_column(name, opts={}, &block) raise "Not in header mode!" if @row_mode != :header sortparam = "#{@classname}#{@table_form_options[:sort_postfix]}" bid = "#{@classname}#{@table_form_options[:sort_postfix]}" opts = opts make_tag(:th, opts[:th_html]) do concat(t(opts[:header] || name.to_s.capitalize), :escape_html) if opts[:sortable] and @table_options[:sortable] if @sorting and @sorting[:by].to_s == name.to_s pname = "#{sortparam}[_resort][#{name}][#{@sorting[:direction] == 'asc' ? 'desc' : 'asc'}]" bid = "#{bid}_#{name}_#{@sorting[:direction] == 'asc' ? 'desc' : 'asc'}" psrc = File.join(@table_options[:image_path_prefix], @table_options[@sorting[:direction] == 'desc' ? :sort_down_button : :sort_up_button]) make_tag(:input, :type => :hidden, :name => "#{sortparam}[#{name}][#{@sorting[:direction]}]", :value => "#{@sorting[:direction]}") else pname = "#{sortparam}[_resort][#{name}][desc]" bid = "#{bid}_#{name}_desc" psrc = File.join(@table_options[:image_path_prefix], @table_options[:sort_down_button_inactive]) end make_tag(:input, :type => 'image', :id => bid, :src => psrc, :name => pname) end end # </th> end |
#render_batch_actions ⇒ Object
render the select tag for batch actions
27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 |
# File 'lib/tabulatr/tabulatr/batch_actions.rb', line 27 def render_batch_actions make_tag(:div, :class => @table_options[:batch_actions_div_class]) do concat(t(@table_options[:batch_actions_label])) if @table_options[:batch_actions_label] iname = "#{@classname}#{TABLE_FORM_OPTIONS[:batch_postfix]}" case @table_options[:batch_actions_type] when :select make_tag(:select, :name => iname, :class => @table_options[:batch_actions_class]) do concat("<option></option>") @table_options[:batch_actions].each do |n,v| make_tag(:option, :value => n) do concat(v) end # </option> end # each end # </select> when :buttons @table_options[:batch_actions].each do |n,v| make_tag(:input, :type => 'submit', :value => v, :name => "#{iname}[#{n}]", :class => @table_options[:batch_actions_class]) end # each else raise "Use either :select or :buttons for :batch_actions_type" end # case end # </div> end |
#render_element(element, &block) ⇒ Object
109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 |
# File 'lib/tabulatr/tabulatr.rb', line 109 def render_element(element, &block) case element when :paginator then render_paginator if @table_options[:paginate] when :hidden_submit then when :submit then make_tag(:input, :type => 'submit', :class => @table_options[:submit_class], :value => t(@table_options[:submit_label])) when :batch_actions then render_batch_actions if @table_options[:batch_actions] when :select_controls then render_select_controls if @table_options[:selectable] when :info_text make_tag(:div, :class => @table_options[:info_text_class]) do concat(format(t(@table_options[:info_text]), @records.count, @pagination[:total], @checked[:selected].length, @pagination[:count])) end if @table_options[:info_text] when :table then render_table &block else if element.is_a?(String) concat(element) else raise "unknown element '#{element}'" end end end |
#render_paginator ⇒ Object
render the paginator controls, inputs etc.
27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 |
# File 'lib/tabulatr/tabulatr/paginator.rb', line 27 def render_paginator # get the current pagination state pagination_name = "#{@classname}#{TABLE_FORM_OPTIONS[:pagination_postfix]}" pparams = @records.send(FINDER_INJECT_OPTIONS[:pagination]) page = pparams[:page].to_i pages = pparams[:pages].to_i pagesize = pparams[:pagesize].to_i pagesizes = pparams[:pagesizes].map &:to_i # render the 'wrapping' div make_tag(:div, :class => @table_options[:paginator_div_class]) do # << Page Left if page > 1 make_tag(:input, :type => 'image', :src => File.join(@table_options[:image_path_prefix], @table_options[:pager_left_button]), :class => @table_options[:page_left_class], :id => "#{pagination_name}_page_left", :name => "#{pagination_name}[page_left]") else make_tag(:img, :src => File.join(@table_options[:image_path_prefix], @table_options[:pager_left_button_inactive]), :class => @table_options[:page_left_class]) end # page > 1 # current page number concat(make_tag(:input, :type => :hidden, :name => "#{pagination_name}[current_page]", :value => page)) concat(make_tag(:input, :type => :text, :size => pages.to_s.length, :name => "#{pagination_name}[page]", :value => page)) concat("/#{pages}") # >> Page Right if page < pages make_tag(:input, :type => 'image', :src => File.join(@table_options[:image_path_prefix], @table_options[:pager_right_button]), :class => @table_options[:page_right_class], :id => "#{pagination_name}_page_right", :name => "#{pagination_name}[page_right]") else make_tag(:img, :src => File.join(@table_options[:image_path_prefix], @table_options[:pager_right_button_inactive]), :class => @table_options[:page_right_class]) end # page < pages if pagesizes.length > 1 make_tag(:select, :name => "#{pagination_name}[pagesize]", :class => @table_options[:pagesize_select_class]) do pagesizes.each do |n| make_tag(:option, (n.to_i==pagesize ? {:selected => :selected} : {}).merge(:value => n)) do concat(n.to_s) end # </option> end # each end # </select> else # just one pagesize concat(make_tag(:input, :type => :hidden, :name => "#{pagination_name}[pagesize]", :value => pagesizes.first)) end end # </div> end |
#render_select_controls ⇒ Object
26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 |
# File 'lib/tabulatr/tabulatr/check_controls.rb', line 26 def render_select_controls make_tag(:div, :class => @table_options[:select_controls_div_class]) do iname = "#{@classname}#{TABLE_FORM_OPTIONS[:checked_postfix]}" @table_options[:select_controls].each do |name| raise "Invalid check control '#{name}' requested." unless [:select_all, :select_none, :select_visible, :unselect_visible, :select_filtered, :unselect_filtered].member?(name) topts = { :type => 'submit', :value => t(@table_options["#{name}_label"]), :name => "#{iname}[#{name}]" } topts[:class] = @table_options["#{name}_class"] if @table_options["#{name}_class"] make_tag(:input, topts) end end # </div> end |
#render_table(&block) ⇒ Object
133 134 135 136 137 138 139 140 141 142 143 144 145 |
# File 'lib/tabulatr/tabulatr.rb', line 133 def render_table(&block) to = @table_options[:table_html] to = (to || {}).merge(:class => @table_options[:table_class]) if @table_options[:table_class] make_tag(:table, to) do make_tag(:thead) do render_table_header(&block) render_table_filters(&block) if @table_options[:filter] end # </thead> make_tag(:tbody) do render_table_rows(&block) end # </tbody> end # </table> end |
#sql_options(n = nil) ⇒ Object
218 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 218 def (n=nil) self.class.(n) end |
#table_design_options(n = nil) ⇒ Object
212 |
# File 'lib/tabulatr/tabulatr/settings.rb', line 212 def (n=nil) self.class.(n) end |