Module: Formtastic::Inputs::Base::Collections

Included in:
CheckBoxesInput, DatalistInput, RadioInput, SelectInput
Defined in:
lib/formtastic/inputs/base/collections.rb

Instance Method Summary (collapse)

Instance Method Details

- (Object) collection



49
50
51
52
53
54
55
56
57
58
59
# File 'lib/formtastic/inputs/base/collections.rb', line 49

def collection
  # Return if we have a plain string
  return raw_collection if raw_collection.instance_of?(String) || raw_collection.instance_of?(ActiveSupport::SafeBuffer)

  # Return if we have an Array of strings, fixnums or arrays
  return raw_collection if (raw_collection.instance_of?(Array) || raw_collection.instance_of?(Range)) &&
                       [Array, Fixnum, String].include?(raw_collection.first.class) &&
                       !(options.include?(:member_label) || options.include?(:member_value))

  raw_collection.map { |o| [send_or_call(label_method, o), send_or_call(value_method, o)] }
end

- (Object) collection_for_boolean



95
96
97
98
99
100
101
102
# File 'lib/formtastic/inputs/base/collections.rb', line 95

def collection_for_boolean
  true_text = options[:true] || Formtastic::I18n.t(:yes)
  false_text = options[:false] || Formtastic::I18n.t(:no)

  # TODO options[:value_as_class] = true unless options.key?(:value_as_class)

  [ [true_text, true], [false_text, false] ]
end

- (Object) collection_from_association



73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
# File 'lib/formtastic/inputs/base/collections.rb', line 73

def collection_from_association
  if reflection
    if reflection.respond_to?(:options)
      raise PolymorphicInputWithoutCollectionError.new(
                "A collection must be supplied for #{method} input. Collections cannot be guessed for polymorphic associations."
            ) if reflection.options[:polymorphic] == true
    end

    conditions_from_reflection = (reflection.respond_to?(:options) && reflection.options[:conditions]) || {}
    conditions_from_reflection = conditions_from_reflection.call if conditions_from_reflection.is_a?(Proc)

    scope_conditions = conditions_from_reflection.empty? ? nil : {:conditions => conditions_from_reflection}
    where_conditions = (scope_conditions && scope_conditions[:conditions]) || {}
    
    if Util.rails3?
      reflection.klass.scoped(scope_conditions).where({}) # where is uneccessary, but keeps the stubbing simpler while we support rails3
    else
      reflection.klass.where(where_conditions)
    end
  end
end

- (Object) collection_from_options



61
62
63
64
65
66
67
68
69
70
71
# File 'lib/formtastic/inputs/base/collections.rb', line 61

def collection_from_options
  items = options[:collection]
  case items
  when Hash
    items.to_a
  when Range
    items.to_a.collect{ |c| [c.to_s, c] }
  else
    items
  end
end

- (Object) label_and_value_method



22
23
24
# File 'lib/formtastic/inputs/base/collections.rb', line 22

def label_and_value_method
  @label_and_value_method ||= label_and_value_method_from_collection(raw_collection)
end

- (Object) label_and_value_method_from_collection(_collection)



26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
# File 'lib/formtastic/inputs/base/collections.rb', line 26

def label_and_value_method_from_collection(_collection)
  sample = _collection.first || _collection.last

  case sample
  when Array
    label, value = :first, :last
  when Integer
    label, value = :to_s, :to_i
  when Symbol, String, NilClass
    label, value = :to_s, :to_s
  end

  # Order of preference: user supplied method, class defaults, auto-detect
  label ||= builder.collection_label_methods.find { |m| sample.respond_to?(m) }
  value ||= builder.collection_value_methods.find { |m| sample.respond_to?(m) }

  [label, value]
end

- (Object) label_method



6
7
8
# File 'lib/formtastic/inputs/base/collections.rb', line 6

def label_method
  @label_method ||= (label_method_from_options || label_and_value_method.first)
end

- (Object) label_method_from_options



10
11
12
# File 'lib/formtastic/inputs/base/collections.rb', line 10

def label_method_from_options
  options[:member_label]
end

- (Object) raw_collection



45
46
47
# File 'lib/formtastic/inputs/base/collections.rb', line 45

def raw_collection
  @raw_collection ||= (collection_from_options || collection_from_association || collection_for_boolean)
end

- (Object) send_or_call(duck, object)



104
105
106
107
108
109
110
# File 'lib/formtastic/inputs/base/collections.rb', line 104

def send_or_call(duck, object)
  if duck.respond_to?(:call)
    duck.call(object)
  elsif object.respond_to? duck.to_sym
    object.send(duck)
  end
end

- (Object) send_or_call_or_object(duck, object)

Avoids an issue where send_or_call can be a String and duck can be something simple like :first, which obviously String responds to.



114
115
116
117
# File 'lib/formtastic/inputs/base/collections.rb', line 114

def send_or_call_or_object(duck, object)
  return object if object.is_a?(String) || object.is_a?(Integer) || object.is_a?(Symbol) # TODO what about other classes etc?
  send_or_call(duck, object)
end

- (Object) value_method



14
15
16
# File 'lib/formtastic/inputs/base/collections.rb', line 14

def value_method
  @value_method ||= (value_method_from_options || label_and_value_method.last)
end

- (Object) value_method_from_options



18
19
20
# File 'lib/formtastic/inputs/base/collections.rb', line 18

def value_method_from_options
  options[:member_value]
end