Module: AdvancedSelect::Helper

Defined in:
lib/advanced_select/helper.rb

Instance Method Summary collapse

Instance Method Details

#advanced_select_add_option?(options, selected_options, add_mode, query) ⇒ Boolean

Returns:

  • (Boolean) 


117
118
119
120
121
122
123
124
 
# File 'lib/advanced_select/helper.rb', line 117

def advanced_select_add_option?(options, selected_options, add_mode, query)
  return false unless add_mode && query.present?

  query_label = advanced_select_normalized_label(query)
  advanced_select_matched_labels(options, selected_options).none? do |label|
    advanced_select_normalized_label(label) == query_label
  end
end

#advanced_select_array(value) ⇒ Object 



172
173
174
175
176
177
178
179
180
181
 
# File 'lib/advanced_select/helper.rb', line 172

def advanced_select_array(value)
  case value
  when nil
    []
  when Array
    value.compact
  else
    [value]
  end
end

#advanced_select_class(class_map, *keys) ⇒ Object 



38
39
40
 
# File 'lib/advanced_select/helper.rb', line 38

def advanced_select_class(class_map, *keys)
  class_map.class_name(*keys)
end

#advanced_select_class_map(classes, append_classes = {}) ⇒ Object 



204
205
206
207
208
209
210
 
# File 'lib/advanced_select/helper.rb', line 204

def advanced_select_class_map(classes, append_classes = {})
  if classes.is_a?(AdvancedSelect::ClassMap)
    classes
  else
    AdvancedSelect::ClassMap.new(classes, append_classes)
  end
end

#advanced_select_default_option_content_tag(option, class_map) ⇒ Object 



99
100
101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/advanced_select/helper.rb', line 99

def advanced_select_default_option_content_tag(option, class_map)
  description = advanced_select_option_description(option)
  content = [tag.span(advanced_select_option_label(option))]

  if description.present?
    content << tag.span(
      description,
      class: advanced_select_class(class_map, :option_description)
    )
  end

  tag.span(safe_join(content), class: advanced_select_class(class_map, :option_content))
end

#advanced_select_display_label(label) ⇒ Object 



168
169
170
 
# File 'lib/advanced_select/helper.rb', line 168

def advanced_select_display_label(label)
  label.to_s.split(" > ").last
end

#advanced_select_flat_options(options) ⇒ Object 



200
201
202
 
# File 'lib/advanced_select/helper.rb', line 200

def advanced_select_flat_options(options)
  options.flat_map { |option| option.key?(:options) ? option.fetch(:options) : option }
end

#advanced_select_matched_labels(options, selected_options) ⇒ Object 



183
184
185
186
187
188
189
190
191
192
193
194
 
# File 'lib/advanced_select/helper.rb', line 183

def advanced_select_matched_labels(options, selected_options)
  option_labels = advanced_select_flat_options(options).flat_map do |option|
    label = advanced_select_option_label(option)
    [label, advanced_select_option_display_label(option)]
  end

  selected_labels = selected_options.flat_map do |option|
    [advanced_select_option_label(option), advanced_select_option_display_label(option)]
  end

  option_labels + selected_labels
end

#advanced_select_normalized_label(label) ⇒ Object 



196
197
198
 
# File 'lib/advanced_select/helper.rb', line 196

def advanced_select_normalized_label(label)
  I18n.transliterate(label.to_s.squish).downcase
end

#advanced_select_option_content_tag(option, option_content_partial, class_map) ⇒ Object 



91
92
93
94
95
96
97
 
# File 'lib/advanced_select/helper.rb', line 91

def advanced_select_option_content_tag(option, option_content_partial, class_map)
  if option_content_partial.present?
    render partial: option_content_partial, locals: { option: option }
  else
    advanced_select_default_option_content_tag(option, class_map)
  end
end

#advanced_select_option_description(option) ⇒ Object 



164
165
166
 
# File 'lib/advanced_select/helper.rb', line 164

def advanced_select_option_description(option)
  option[:description].to_s
end

#advanced_select_option_display_label(option) ⇒ Object 



160
161
162
 
# File 'lib/advanced_select/helper.rb', line 160

def advanced_select_option_display_label(option)
  option.fetch(:display_label, advanced_select_display_label(advanced_select_option_label(option))).to_s
end

#advanced_select_option_groups(options) ⇒ Object 



126
127
128
129
130
131
132
133
134
 
# File 'lib/advanced_select/helper.rb', line 126

def advanced_select_option_groups(options)
  options.map do |option|
    if option.key?(:options)
      { label: option.fetch(:label), options: option.fetch(:options) }
    else
      { label: nil, options: [option] }
    end
  end
end

#advanced_select_option_label(option) ⇒ Object 



152
153
154
 
# File 'lib/advanced_select/helper.rb', line 152

def advanced_select_option_label(option)
  option.fetch(:label, option.fetch(:display_label, option.fetch(:value, option.fetch(:id)))).to_s
end

#advanced_select_option_selected?(option, selected_options, selected_option_ids = nil) ⇒ Boolean

Returns:

  • (Boolean) 


142
143
144
145
146
 
# File 'lib/advanced_select/helper.rb', line 142

def advanced_select_option_selected?(option, selected_options, selected_option_ids = nil)
  return selected_option_ids.key?(option.fetch(:id).to_s) if selected_option_ids

  selected_options.any? { |selected_option| selected_option.fetch(:id).to_s == option.fetch(:id).to_s }
end

#advanced_select_option_tag(option, selected_options, option_content_partial, class_map, selected_option_ids: nil) ⇒ Object 



63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
 
# File 'lib/advanced_select/helper.rb', line 63

def advanced_select_option_tag(option, selected_options, option_content_partial, class_map, selected_option_ids: nil)
  selected = advanced_select_option_selected?(option, selected_options, selected_option_ids)

  tag.button(
    type: "button",
    class: advanced_select_class(class_map, :option, (:option_selected if selected)),
    role: "option",
    aria: { selected: selected },
    data: {
      advanced_select_option: "",
      action: "mouseenter->advanced-select#activateOption mousedown->advanced-select#choose",
      advanced_select_value_param: option.fetch(:id),
      advanced_select_submit_value_param: advanced_select_option_value(option),
      advanced_select_label_param: advanced_select_option_label(option),
      advanced_select_display_label_param: advanced_select_option_display_label(option)
    }
  ) do
    safe_join([
      tag.span(
        (selected ? "\u2713" : ""),
        class: advanced_select_class(class_map, :option_check),
        data: { advanced_select_option_check: "" }
      ),
      advanced_select_option_content_tag(option, option_content_partial, class_map)
    ])
  end
end

#advanced_select_option_value(option) ⇒ Object 



156
157
158
 
# File 'lib/advanced_select/helper.rb', line 156

def advanced_select_option_value(option)
  option.fetch(:value, option.fetch(:id)).to_s
end

#advanced_select_options_empty?(options) ⇒ Boolean

Returns:

  • (Boolean) 


148
149
150
 
# File 'lib/advanced_select/helper.rb', line 148

def advanced_select_options_empty?(options)
  advanced_select_flat_options(options).empty?
end

#advanced_select_options_for_render(options, selected_options, searchable) ⇒ Object 



113
114
115
 
# File 'lib/advanced_select/helper.rb', line 113

def advanced_select_options_for_render(options, selected_options, searchable)
  searchable ? selected_options.presence || options : options
end

#advanced_select_options_tag(target_id:, selected:, options:, multiple: false, add_mode: false, query: nil, option_content_partial: nil, classes: {}, append_classes: {}) ⇒ Object 



25
26
27
28
29
30
31
32
33
34
35
36
 
# File 'lib/advanced_select/helper.rb', line 25

def advanced_select_options_tag(target_id:, selected:, options:, multiple: false, add_mode: false, query: nil, option_content_partial: nil, classes: {}, append_classes: {})
  render partial: "advanced_select/options", locals: {
    target_id: target_id,
    selected_options: advanced_select_selected_options(selected),
    options: options,
    multiple: multiple,
    add_mode: add_mode,
    query: query,
    option_content_partial: option_content_partial,
    class_map: advanced_select_class_map(classes, append_classes)
  }
end

#advanced_select_selected_option_ids(selected_options) ⇒ Object 



136
137
138
139
140
 
# File 'lib/advanced_select/helper.rb', line 136

def advanced_select_selected_option_ids(selected_options)
  selected_options.each_with_object({}) do |selected_option, selected_option_ids|
    selected_option_ids[selected_option.fetch(:id).to_s] = true
  end
end

#advanced_select_selected_options(selected) ⇒ Object 



46
47
48
49
50
51
52
53
54
55
 
# File 'lib/advanced_select/helper.rb', line 46

def advanced_select_selected_options(selected)
  advanced_select_array(selected).map do |option|
    {
      id: option.fetch(:id).to_s,
      value: advanced_select_option_value(option),
      label: advanced_select_option_label(option),
      display_label: advanced_select_option_display_label(option)
    }
  end
end

#advanced_select_selected_value(selected_options) ⇒ Object 



57
58
59
60
61
 
# File 'lib/advanced_select/helper.rb', line 57

def advanced_select_selected_value(selected_options)
  selected_options.map do |option|
    option.merge(displayLabel: option.fetch(:display_label))
  end.to_json
end

#advanced_select_state_class(class_map, key) ⇒ Object 



42
43
44
 
# File 'lib/advanced_select/helper.rb', line 42

def advanced_select_state_class(class_map, key)
  class_map.state_class(key)
end

#advanced_select_tag(name, id:, selected:, options:, placeholder:, options_url: nil, multiple: false, searchable: true, add_mode: false, dependent_fields: {}, include_hidden: true, option_content_partial: nil, classes: {}, append_classes: {}) ⇒ Object 



3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
 
# File 'lib/advanced_select/helper.rb', line 3

def advanced_select_tag(name, id:, selected:, options:, placeholder:, options_url: nil, multiple: false, searchable: true, add_mode: false, dependent_fields: {}, include_hidden: true, option_content_partial: nil, classes: {}, append_classes: {})
  selected_options = advanced_select_selected_options(selected)
  class_map = advanced_select_class_map(classes, append_classes)

  render partial: "advanced_select/select", locals: {
    name: name,
    id: id,
    options_url: options_url,
    selected_options: selected_options,
    options: options,
    placeholder: placeholder,
    multiple: multiple,
    searchable: searchable && options_url.present?,
    add_mode: add_mode,
    dependent_fields: dependent_fields,
    include_hidden: include_hidden,
    target_id: "#{id}_options",
    option_content_partial: option_content_partial,
    class_map: class_map
  }
end