Class Mechanize::Form::MultiSelectList
In: lib/mechanize/form/multi_select_list.rb
Parent: Field
Mechanize\n[lib/mechanize.rb\nlib/mechanize/chain.rb\nlib/mechanize/chain/auth_headers.rb\nlib/mechanize/chain/body_decoding_handler.rb\nlib/mechanize/chain/connection_resolver.rb\nlib/mechanize/chain/custom_headers.rb\nlib/mechanize/chain/handler.rb\nlib/mechanize/chain/header_resolver.rb\nlib/mechanize/chain/parameter_resolver.rb\nlib/mechanize/chain/pre_connect_hook.rb\nlib/mechanize/chain/request_resolver.rb\nlib/mechanize/chain/response_body_parser.rb\nlib/mechanize/chain/response_header_handler.rb\nlib/mechanize/chain/response_reader.rb\nlib/mechanize/chain/ssl_resolver.rb\nlib/mechanize/chain/uri_resolver.rb\nlib/mechanize/content_type_error.rb\nlib/mechanize/cookie.rb\nlib/mechanize/cookie_jar.rb\nlib/mechanize/file.rb\nlib/mechanize/file_response.rb\nlib/mechanize/file_saver.rb\nlib/mechanize/form.rb\nlib/mechanize/form/button.rb\nlib/mechanize/form/check_box.rb\nlib/mechanize/form/field.rb\nlib/mechanize/form/file_upload.rb\nlib/mechanize/form/image_button.rb\nlib/mechanize/form/multi_select_list.rb\nlib/mechanize/form/option.rb\nlib/mechanize/form/radio_button.rb\nlib/mechanize/form/select_list.rb\nlib/mechanize/headers.rb\nlib/mechanize/history.rb\nlib/mechanize/monkey_patch.rb\nlib/mechanize/page.rb\nlib/mechanize/page/base.rb\nlib/mechanize/page/frame.rb\nlib/mechanize/page/image.rb\nlib/mechanize/page/label.rb\nlib/mechanize/page/link.rb\nlib/mechanize/page/meta.rb\nlib/mechanize/pluggable_parsers.rb\nlib/mechanize/redirect_limit_reached_error.rb\nlib/mechanize/redirect_not_get_or_head_error.rb\nlib/mechanize/response_code_error.rb\nlib/mechanize/unsupported_scheme_error.rb\nlib/mechanize/util.rb] WWW dot/f_53.png

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'

Methods

Attributes

options  [RW] 

Public Class methods

[Source]

    # File lib/mechanize/form/multi_select_list.rb, line 14
14:       def initialize node
15:         value = []
16:         @options = []
17: 
18:         # parse
19:         node.search('option').each do |n|
20:           option = Option.new(n, self)
21:           @options << option
22:         end
23:         super(node, value)
24:       end

Public Instance methods

[Source]

    # File lib/mechanize/form/multi_select_list.rb, line 26
26:       def query_value
27:         value ? value.collect { |v| [name, v] } : ''
28:       end

Select all options

[Source]

    # File lib/mechanize/form/multi_select_list.rb, line 37
37:       def select_all
38:         @value = []
39:         options.each { |o| o.tick }
40:       end

Select no options

[Source]

    # File lib/mechanize/form/multi_select_list.rb, line 31
31:       def select_none
32:         @value = []
33:         options.each { |o| o.untick }
34:       end

Get a list of all selected options

[Source]

    # File lib/mechanize/form/multi_select_list.rb, line 43
43:       def selected_options
44:         @options.find_all { |o| o.selected? }
45:       end

[Source]

    # File lib/mechanize/form/multi_select_list.rb, line 59
59:       def value
60:         value = []
61:         value.push(*@value)
62:         value.push(*selected_options.collect { |o| o.value })
63:         value
64:       end

[Source]

    # File lib/mechanize/form/multi_select_list.rb, line 47
47:       def value=(values)
48:         select_none
49:         [values].flatten.each do |value|
50:           option = options.find { |o| o.value == value }
51:           if option.nil?
52:             @value.push(value)
53:           else
54:             option.select
55:           end
56:         end
57:       end

[Validate]