Class: Mechanize::Form::MultiSelectList

Inherits:
Field
  • Object
show all
Extended by:
ElementMatcher
Defined in:
lib/mechanize/form/multi_select_list.rb

Overview

This class represents a select list where multiple values can be selected. MultiSelectList#value= accepts an array, and those values are used as values for the select list. For example, to select multiple values, simply do this:

list.value = ['one', 'two']

Single values are still supported, so these two are the same:

list.value = ['one']
list.value = 'one'

Direct Known Subclasses

SelectList

Instance Attribute Summary collapse

Attributes inherited from Field

#name, #node

Instance Method Summary collapse

Methods included from ElementMatcher

elements_with

Methods inherited from Field

#<=>, #dom_id

Constructor Details

#initialize(node) ⇒ MultiSelectList

Returns a new instance of MultiSelectList.



17
18
19
20
21
22
23
24
25
26
27
 
# File 'lib/mechanize/form/multi_select_list.rb', line 17

def initialize node
  value = []
  @options = []

  # parse
  node.search('option').each do |n|
    option = Mechanize::Form::Option.new(n, self)
    @options << option
  end
  super(node, value)
end

Instance Attribute Details

#options ⇒ Object

Returns the value of attribute options.



15
16
17
 
# File 'lib/mechanize/form/multi_select_list.rb', line 15

def options
  @options
end

Instance Method Details

#option ⇒ Object

Find all options on this select list with criteria Example:

select_list.options_with(:value => /1|2/).each do |field|
  field.value = '20'
end



41
 
# File 'lib/mechanize/form/multi_select_list.rb', line 41

elements_with :option

#query_value ⇒ Object 



43
44
45
 
# File 'lib/mechanize/form/multi_select_list.rb', line 43

def query_value
  value ? value.collect { |v| [name, v] } : ''
end

#select_all ⇒ Object

Select all options



54
55
56
57
 
# File 'lib/mechanize/form/multi_select_list.rb', line 54

def select_all
  @value = []
  options.each { |o| o.tick }
end

#select_none ⇒ Object

Select no options



48
49
50
51
 
# File 'lib/mechanize/form/multi_select_list.rb', line 48

def select_none
  @value = []
  options.each { |o| o.untick }
end

#selected_options ⇒ Object

Get a list of all selected options



60
61
62
 
# File 'lib/mechanize/form/multi_select_list.rb', line 60

def selected_options
  @options.find_all { |o| o.selected? }
end

#value ⇒ Object 



76
77
78
79
80
81
 
# File 'lib/mechanize/form/multi_select_list.rb', line 76

def value
  value = []
  value.push(*@value)
  value.push(*selected_options.collect { |o| o.value })
  value
end

#value=(values) ⇒ Object 



64
65
66
67
68
69
70
71
72
73
74
 
# File 'lib/mechanize/form/multi_select_list.rb', line 64

def value=(values)
  select_none
  [values].flatten.each do |value|
    option = options.find { |o| o.value == value }
    if option.nil?
      @value.push(value)
    else
      option.select
    end
  end
end