Class: Dommy::HTMLFormElement

Inherits:
HTMLElement show all
Defined in:
lib/dommy/html_elements.rb

Overview

‘<form>` — element collection, submit/reset, and a stubbed validation surface.

Constant Summary

Constants inherited from Element

Element::ATTRIBUTE_NODE, Element::CDATA_SECTION_NODE, Element::COMMENT_NODE, Element::DOCUMENT_FRAGMENT_NODE, Element::DOCUMENT_NODE, Element::DOCUMENT_POSITION_CONTAINED_BY, Element::DOCUMENT_POSITION_CONTAINS, Element::DOCUMENT_POSITION_DISCONNECTED, Element::DOCUMENT_POSITION_FOLLOWING, Element::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, Element::DOCUMENT_POSITION_PRECEDING, Element::DOCUMENT_TYPE_NODE, Element::ELEMENT_NODE, Element::HTML_NAMESPACE, Element::PROCESSING_INSTRUCTION_NODE, Element::REFLECTED_TOKEN_LIST_HOSTS, Element::SHADOW_HOST_TAGS, Element::SVG_NAMESPACE, Element::TEXT_NODE

Constants included from Node

Node::ATTRIBUTE_NODE, Node::CDATA_SECTION_NODE, Node::COMMENT_NODE, Node::DOCUMENT_FRAGMENT_NODE, Node::DOCUMENT_NODE, Node::DOCUMENT_POSITION_CONTAINED_BY, Node::DOCUMENT_POSITION_CONTAINS, Node::DOCUMENT_POSITION_DISCONNECTED, Node::DOCUMENT_POSITION_FOLLOWING, Node::DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, Node::DOCUMENT_POSITION_PRECEDING, Node::DOCUMENT_TYPE_NODE, Node::ELEMENT_NODE, Node::HTML_NAMESPACE, Node::PROCESSING_INSTRUCTION_NODE, Node::TEXT_NODE

Instance Attribute Summary

Attributes inherited from Element

#document

Instance Method Summary collapse

Methods inherited from HTMLElement

#case_sensitive_attribute_names?

Methods included from Internal::ReflectedAttributes

#__js_set__, included

Methods inherited from Element

#[], #[]=, #__dommy_backend_node__, #__internal_set_namespace__, #__internal_shadow_root__, #__js_set__, #__test_scroll_log__, #access_key_label, #after, #anchor_href, #animate, #aria_content_attr, #aria_element_attr, #aria_element_get, #aria_element_set, #aria_elements_attr, #aria_elements_get, #aria_elements_set, #aria_find_in_root, #aria_get, #aria_set, #at_xpath, #attach_shadow, #attributes, #base_uri, #before, #blur, #child_element_count, #child_nodes, #children, #class_list, #class_name, #class_name=, #clear_aria_element_ref_for, #click, #clone_node, #closest, #contains?, #dataset, #element_prefix, #equal_node?, #first_child, #first_element_child, #focus, #get_animations, #get_attribute, #get_attribute_names, #get_attribute_node, #get_attribute_node_ns, #get_attribute_ns, #get_bounding_client_rect, #get_client_rects, #get_elements_by_class_name, #get_elements_by_tag_name, #get_elements_by_tag_name_ns, #get_html, #get_inner_html, #has_attribute?, #has_attribute_ns?, #has_attributes?, #has_child_nodes?, #hide_popover, #id, #id=, #initialize, #inner_html, #inner_html=, #insert_adjacent_element, #insert_adjacent_html, #insert_adjacent_text, #insert_before, #insertion_parent!, #is_connected?, #last_child, #last_element_child, #live_child_nodes, #local_name, #matches?, #namespace_uri, #next_element_sibling, #next_sibling, #normalize, #on, #outer_html, #outer_html=, #owner_document, #parent_element, #parent_node, #path, #previous_element_sibling, #previous_sibling, #query_selector, #query_selector_all, #reflected_attr_name, #reflected_token_list, #remove, #remove_attribute, #remove_attribute_node, #remove_attribute_ns, #remove_child, #replace_child, #replace_with_nodes, #request_fullscreen, #role, #role=, #root_node, #same_node?, #scoped_query, #set_attribute, #set_attribute_node, #set_attribute_ns, #shadow_root, #show_popover, #slot, #slot=, #style, #tag_name, #text_content, #text_content=, #to_s, #toggle_attribute, #toggle_popover, #with_selector_errors, #xpath

Methods included from Bridge::Methods

included

Methods included from Internal::ParentNode

#append, #append_child, #prepend, #replace_children

Methods included from Node

#compare_document_position, #get_root_node, #is_default_namespace, #is_equal_node, #is_same_node, #lookup_namespace_uri, #lookup_prefix

Methods included from EventTarget

#__internal_deliver_event__, #__internal_event_parent__, #add_event_listener, capture_flag, #deliver_at, #dispatch_event, js_truthy?, #remove_event_listener

Constructor Details

This class inherits a constructor from Dommy::Element

Instance Method Details

#__js_call__(method, args) ⇒ Object 



201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
 
# File 'lib/dommy/html_elements.rb', line 201

def __js_call__(method, args)
  case method
  when "submit"
    submit
  when "reset"
    reset
  when "requestSubmit"
    request_submit(args[0])
  when "checkValidity"
    check_validity
  when "reportValidity"
    report_validity
  else
    super
  end
end

#__js_get__(key) ⇒ Object 



189
190
191
192
193
194
195
196
197
198
 
# File 'lib/dommy/html_elements.rb', line 189

def __js_get__(key)
  case key
  when "elements"
    elements
  when "length"
    length
  else
    super
  end
end

#check_validity ⇒ Object

Walk all listed elements; the form is “valid” iff every candidate control passes its own checkValidity. Dispatches a non-bubbling ‘invalid` event on each failing control.



170
171
172
173
174
175
176
177
178
179
180
181
182
183
 
# File 'lib/dommy/html_elements.rb', line 170

def check_validity
  ok = true
  elements.each do |el|
    next unless el.respond_to?(:will_validate)
    next unless el.will_validate
    next if el.validity.valid && (el.instance_variable_get(:@custom_validity_message) || "").empty?

    # Fire invalid event on this control (matches spec).
    el.dispatch_event(Event.new("invalid", "bubbles" => false, "cancelable" => true))
    ok = false
  end

  ok
end

#elements ⇒ Object

‘form.elements` — listed elements inside the form (excludes nested forms per spec; we approximate by walking input/select/textarea/button/output/fieldset). Returned as a live HTMLCollection so listening to `submit`/`reset` and adding fields between accesses works as expected.



116
117
118
119
120
121
122
123
124
125
126
127
 
# File 'lib/dommy/html_elements.rb', line 116

def elements
  el = self
  HTMLCollection.new do
    el
      .__dommy_backend_node__
      .css("input, select, textarea, button, output, fieldset")
      .map do |n|
        el.document.wrap_node(n)
      end
      .compact
  end
end

#length ⇒ Object 



129
130
131
 
# File 'lib/dommy/html_elements.rb', line 129

def length
  elements.size
end

#report_validity ⇒ Object 



185
186
187
 
# File 'lib/dommy/html_elements.rb', line 185

def report_validity
  check_validity
end

#request_submit(submitter = nil) ⇒ Object

Spec: ‘requestSubmit(submitter?)` is the JS counterpart that MIRRORS user-initiated submission — it runs constraint validation and fires a `submit` event. Returns true if not default-prevented. `submitter` (if given) must be a button inside this form.



152
153
154
155
156
157
158
159
160
161
162
163
164
165
 
# File 'lib/dommy/html_elements.rb', line 152

def request_submit(submitter = nil)
  if submitter
    unless submitter.respond_to?(:__dommy_backend_node__) && submitter.__dommy_backend_node__.ancestors.include?(@__node__)
      raise DOMException::NotFoundError, "submitter is not a descendant of this form"
    end

    type = submitter.respond_to?(:type) ? submitter.type.to_s.downcase : ""
    unless %w[submit image].include?(type)
      raise TypeError, "submitter must be a submit button"
    end
  end

  dispatch_event(Event.new("submit", "bubbles" => true, "cancelable" => true))
end

#reset ⇒ Object

Spec: ‘reset()` does fire a `reset` event; if the event is default-prevented, no reset happens. Dommy has no built-in control re-init logic, so we just dispatch the event.



144
145
146
 
# File 'lib/dommy/html_elements.rb', line 144

def reset
  dispatch_event(Event.new("reset", "bubbles" => true, "cancelable" => true))
end

#submit ⇒ Object

Spec: ‘submit()` performs form submission directly WITHOUT firing a `submit` event. This is the JS-only entry point —browsers don’t run constraint validation either. Dommy has no navigation engine, so this is effectively a no-op (returns nil).



137
138
139
 
# File 'lib/dommy/html_elements.rb', line 137

def submit
  nil
end