Module: Watir::UserEditable

Included in:
TextArea, TextField
Defined in:
lib/watir/user_editable.rb

Instance Method Summary collapse

Instance Method Details

#append(*args) ⇒ Object Also known as: <<

Appends the given value to the text in the text field.

Parameters:

Raises:

  • (NotImplementedError)

45
46
47
48
49
# File 'lib/watir/user_editable.rb', line 45

def append(*args)
  raise NotImplementedError, '#append method is not supported with contenteditable element' if @content_editable

  send_keys(*args)
end

#clearObject

Clears the text field.


56
57
58
59
60
# File 'lib/watir/user_editable.rb', line 56

def clear
  element_call(:wait_for_writable) do
    @element.clear
  end
end

#set(*args) ⇒ Object Also known as: value=

Clear the element, then type in the given value.

Parameters:


9
10
11
12
13
14
# File 'lib/watir/user_editable.rb', line 9

def set(*args)
  element_call(:wait_for_writable) do
    @element.clear
    @element.send_keys(*args)
  end
end

#set!(*args) ⇒ Object

Uses JavaScript to enter most of the given value. Selenium is used to enter the first and last characters

Parameters:

Raises:

  • (ArgumentError)

24
25
26
27
28
29
30
31
32
33
34
35
36
37
# File 'lib/watir/user_editable.rb', line 24

def set!(*args)
  msg = '#set! does not support special keys, use #set instead'
  raise ArgumentError, msg if args.any? { |v| v.is_a?(::Symbol) }

  input_value = args.join
  set input_value[0]
  return content_editable_set!(*args) if @content_editable

  element_call { execute_js(:setValue, @element, input_value[0..-2]) }
  append(input_value[-1])
  return if value == input_value

  raise Exception::Error, "#set! value: '#{value}' does not match expected input: '#{input_value}'"
end