Class: Webrat::Field

Inherits:

Element

• Object
• Element
• Webrat::Field

show all

Defined in:

lib/webrat/core/elements/field.rb

Overview

Instance Attribute Summary (collapse)

• - (Object) value readonly

  Returns the value of attribute value.

Attributes inherited from Element

#element

Class Method Summary (collapse)

• + (Object) field_class(element)
• + (Object) field_classes
• + (Object) inherited(klass)
• + (Object) load(session, element)
• + (Object) xpath_search
• + (Object) xpath_search_excluding_hidden

Instance Method Summary (collapse)

• - (Boolean) disabled?
• - (Object) id
• - (Field) initialize(*args) constructor

  A new instance of Field.

• - (Object) label_text
• - (Object) raise_error_if_disabled
• - (Object) set(value)
• - (Object) to_query_string
• - (Object) unset

Methods inherited from Element

#inspect, load_all, #path

65
66
67
68

# File 'lib/webrat/core/elements/field.rb', line 65

def initialize(*args)
  super
  @value = default_value
end

14
15
16

# File 'lib/webrat/core/elements/field.rb', line 14

def value
  @value
end

39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63

# File 'lib/webrat/core/elements/field.rb', line 39

def self.field_class(element)
  case element.name
  when "button"   then ButtonField
  when "select"
    if element.attributes["multiple"].nil?
      SelectField
    else
      MultipleSelectField
    end
  when "textarea" then TextareaField
  else
    case element["type"]
    when "checkbox" then CheckboxField
    when "hidden"   then HiddenField
    when "radio"    then RadioField
    when "password" then PasswordField
    when "file"     then FileField
    when "reset"    then ResetField
    when "submit"   then ButtonField
    when "button"   then ButtonField
    when "image"    then ButtonField
    else  TextField
    end
  end
end

24
25
26

# File 'lib/webrat/core/elements/field.rb', line 24

def self.field_classes
  @field_classes || []
end

28
29
30
31
32

# File 'lib/webrat/core/elements/field.rb', line 28

def self.inherited(klass)
  @field_classes ||= []
  @field_classes << klass
  # raise args.inspect
end

34
35
36
37

# File 'lib/webrat/core/elements/field.rb', line 34

def self.load(session, element)
  return nil if element.nil?
  session.elements[element.path] ||= field_class(element).new(session, element)
end

16
17
18

# File 'lib/webrat/core/elements/field.rb', line 16

def self.xpath_search
  ".//button|.//input|.//textarea|.//select"
end

20
21
22

# File 'lib/webrat/core/elements/field.rb', line 20

def self.xpath_search_excluding_hidden
  [".//button", ".//input[ @type != 'hidden']", ".//textarea", ".//select"]
end

79
80
81

# File 'lib/webrat/core/elements/field.rb', line 79

def disabled?
  @element.attributes.has_key?("disabled") && @element["disabled"] != 'false'
end

75
76
77

# File 'lib/webrat/core/elements/field.rb', line 75

def id
  @element["id"]
end

70
71
72
73

# File 'lib/webrat/core/elements/field.rb', line 70

def label_text
  return nil if labels.empty?
  labels.first.text
end

83
84
85
86

# File 'lib/webrat/core/elements/field.rb', line 83

def raise_error_if_disabled
  return unless disabled?
  raise DisabledFieldError.new("Cannot interact with disabled form element (#{self})")
end

101
102
103

# File 'lib/webrat/core/elements/field.rb', line 101

def set(value)
  @value = value
end

88
89
90
91
92
93
94
95
96
97
98
99

# File 'lib/webrat/core/elements/field.rb', line 88

def to_query_string
  return nil if disabled?

  query_string = case Webrat.configuration.mode
  when :rails, :merb, :rack, :sinatra
    build_query_string
  when :mechanize
    build_query_string(false)
  end

  query_string
end

105
106
107

# File 'lib/webrat/core/elements/field.rb', line 105

def unset
  @value = default_value
end