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) 


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

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 



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

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

#advanced_select_class(class_map, *keys) ⇒ Object 



40
41
42
 
# File 'lib/advanced_select/helper.rb', line 40

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

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



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

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 



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

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 



170
171
172
 
# File 'lib/advanced_select/helper.rb', line 170

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

#advanced_select_flat_options(options) ⇒ Object 



202
203
204
 
# File 'lib/advanced_select/helper.rb', line 202

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 



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

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 



198
199
200
 
# File 'lib/advanced_select/helper.rb', line 198

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 



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

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 



166
167
168
 
# File 'lib/advanced_select/helper.rb', line 166

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

#advanced_select_option_display_label(option) ⇒ Object 



162
163
164
 
# File 'lib/advanced_select/helper.rb', line 162

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 



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

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 



154
155
156
 
# File 'lib/advanced_select/helper.rb', line 154

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) 


144
145
146
147
148
 
# File 'lib/advanced_select/helper.rb', line 144

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 



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
90
91
 
# File 'lib/advanced_select/helper.rb', line 65

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 



158
159
160
 
# File 'lib/advanced_select/helper.rb', line 158

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

#advanced_select_options_empty?(options) ⇒ Boolean

Returns:

  • (Boolean) 


150
151
152
 
# File 'lib/advanced_select/helper.rb', line 150

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

#advanced_select_options_for_render(options, selected_options, searchable) ⇒ Object 



115
116
117
 
# File 'lib/advanced_select/helper.rb', line 115

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 



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

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 



138
139
140
141
142
 
# File 'lib/advanced_select/helper.rb', line 138

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 



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

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 



59
60
61
62
63
 
# File 'lib/advanced_select/helper.rb', line 59

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 



44
45
46
 
# File 'lib/advanced_select/helper.rb', line 44

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, auto_select_single: true, eager: 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
24
25
 
# 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, auto_select_single: true, eager: 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,
    add_mode: add_mode,
    dependent_fields: dependent_fields,
    include_hidden: include_hidden,
    auto_select_single: auto_select_single,
    eager: eager,
    target_id: "#{id}_options",
    option_content_partial: option_content_partial,
    class_map: class_map
  }
end