Class: Dommy::HTMLOptionElement

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

Overview

<option> — value, label, selected, disabled, text, index, form.

Constant Summary

Constants inherited from Element

Element::ADJACENT_POSITIONS, Element::APPROX_CHAR_PX, Element::APPROX_LINE_PX, 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::INLINE_TAGS, 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, Node::XMLNS_NAMESPACE, Node::XML_NAMESPACE

Instance Attribute Summary

Attributes inherited from Element

#document

Instance Method Summary collapse

Methods inherited from HTMLElement

#case_sensitive_attribute_names?, #disabled_by_ancestor_fieldset?, #labels_node_list, #parse_non_negative_reflected, #set_non_negative_reflected

Methods included from Internal::ReflectedAttributes

included

Methods inherited from Element

#[], #[]=, #__dommy_backend_node__, #__internal_approx_box, #__internal_case_sensitive_attribute_names__?, #__internal_created_namespace__, #__internal_normalize_attr_key__, #__internal_set_namespace__, #__internal_shadow_root__, #__js_attribute_snapshot__, #__js_call__, #__run_click_activation_behavior__, #__test_scroll_log__, #access_key_label, #accessibility_tree, #activation_behavior, #activation_target, #activation_target?, #after, #anchor_href, #animate, #approximate_layout?, #aria_content_attr, #aria_element_attr, #aria_element_get, #aria_element_set, #aria_elements_attr, #aria_elements_current, #aria_elements_get, #aria_elements_set, #aria_find_in_root, #aria_get, #aria_ref_in_valid_scope?, #aria_set, #aria_snapshot, #assigned_slot, #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, #computed_description, #computed_label, #computed_role, #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, #mark_fragment_scripts_started, #matches?, #namespace_uri, #next_element_sibling, #next_sibling, #on, #outer_html, #outer_html=, #owner_document, #parent_element, #parent_node, #path, #pre_click_activation_state, #previous_element_sibling, #previous_sibling, #query_selector, #query_selector_all, #reflected_attr_name, #reflected_token_list, #remove, #remove_attribute_node, #remove_attribute_ns, #remove_child, #replace_child, #replace_with_nodes, #request_fullscreen, #restore_pre_click_activation, #role, #role=, #root_node, #run_post_click_activation, #same_node?, #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, #translate_mode?, #validate_adjacent_document_insert!, #with_selector_errors, #xpath

Methods included from Bridge::Methods

included

Methods included from Internal::ParentNode

#append, #append_child, #normalize, #prepend, #replace_children

Methods included from Internal::ChildNode

#child_node_after, #child_node_before, #child_node_replace_with, #nullable_dom_string, #validate_insert_before_ref!

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

#__dommy_dump_event_failure__, #__internal_deliver_event__, #__internal_event_parent__, #__internal_process_event_handler_return__, #add_event_listener, capture_flag, #deliver_at, #dispatch_event, #event_name_from_on, #invoke_listener_isolated, js_truthy?, #on_handler, #remove_event_listener, #set_on_handler

Constructor Details

This class inherits a constructor from Dommy::Element

Instance Method Details

#__internal_set_selectedness__(value) ⇒ Object

Set selectedness WITHOUT marking it dirty (the Option constructor's step).



2057
2058
2059
 
# File 'lib/dommy/html_elements.rb', line 2057

def __internal_set_selectedness__(value)
  @selectedness = !!value
end

#__js_get__(key) ⇒ Object 



2138
2139
2140
2141
2142
2143
2144
2145
2146
2147
2148
2149
2150
2151
2152
2153
2154
2155
2156
2157
 
# File 'lib/dommy/html_elements.rb', line 2138

def __js_get__(key)
  case key
  when "value"
    value
  when "label"
    label
  when "defaultSelected"
    default_selected
  when "selected"
    selected
  when "text"
    text
  when "form"
    form
  when "index"
    index
  else
    super
  end
end

#__js_set__(key, v) ⇒ Object 



2159
2160
2161
2162
2163
2164
2165
2166
2167
2168
2169
2170
2171
2172
2173
2174
 
# File 'lib/dommy/html_elements.rb', line 2159

def __js_set__(key, v)
  case key
  when "value"
    self.value = v
  when "label"
    self.label = v
  when "selected"
    self.selected = v
  when "defaultSelected"
    self.default_selected = v
  when "text"
    self.text = v
  else
    super
  end
end

#__selectedness_dirty__ ⇒ Object

Whether selectedness was set via the IDL setter (property), as opposed to only the content attribute — a single-select shows the most recently property-selected option in preference to an attribute-selected one.



2064
2065
2066
 
# File 'lib/dommy/html_elements.rb', line 2064

def __selectedness_dirty__
  @selectedness_dirty || false
end

#default_selected ⇒ Object

defaultSelected reflects the selected content attribute.



2033
2034
2035
 
# File 'lib/dommy/html_elements.rb', line 2033

def default_selected
  reflected_boolean("selected")
end

#default_selected=(v) ⇒ Object 



2037
2038
2039
 
# File 'lib/dommy/html_elements.rb', line 2037

def default_selected=(v)
  set_reflected_boolean("selected", v)
end

#form ⇒ Object 



2126
2127
2128
 
# File 'lib/dommy/html_elements.rb', line 2126

def form
  closest("form")
end

#index ⇒ Object

index — position within the containing select's options list.



2131
2132
2133
2134
2135
2136
 
# File 'lib/dommy/html_elements.rb', line 2131

def index
  sel = closest("select")
  return 0 unless sel

  sel.options.find_index { |o| o.__dommy_backend_node__ == @__node__ } || 0
end

#label ⇒ Object 



2024
2025
2026
 
# File 'lib/dommy/html_elements.rb', line 2024

def label
  has_attribute_ns?(nil, "label") ? get_attribute_ns(nil, "label").to_s : text
end

#label=(v) ⇒ Object 



2028
2029
2030
 
# File 'lib/dommy/html_elements.rb', line 2028

def label=(v)
  set_reflected_string("label", v)
end

#remove_attribute(name) ⇒ Object 



2076
2077
2078
2079
2080
 
# File 'lib/dommy/html_elements.rb', line 2076

def remove_attribute(name)
  result = super
  sync_selectedness_from_attribute if name.to_s.casecmp?("selected")
  result
end

#selected ⇒ Object

selected is the selectedness state. It is a distinct boolean (the IDL getter returns it directly), initialised from defaultSelected. While the dirtiness flag is false, adding/removing the selected content attribute re-syncs selectedness to it; the IDL setter makes it dirty so it then holds its value independently of the attribute.



2046
2047
2048
2049
 
# File 'lib/dommy/html_elements.rb', line 2046

def selected
  @selectedness = default_selected if @selectedness.nil?
  @selectedness
end

#selected=(value) ⇒ Object 



2051
2052
2053
2054
 
# File 'lib/dommy/html_elements.rb', line 2051

def selected=(value)
  @selectedness = !!value
  @selectedness_dirty = true
end

#set_attribute(name, value) ⇒ Object

Keep the selected content attribute and selectedness in sync (while not dirty) by hooking the attribute mutators, the way

tracks open.



2070
2071
2072
2073
2074
 
# File 'lib/dommy/html_elements.rb', line 2070

def set_attribute(name, value)
  result = super
  sync_selectedness_from_attribute if name.to_s.casecmp?("selected")
  result
end

#sync_selectedness_from_attribute ⇒ Object 



2082
2083
2084
 
# File 'lib/dommy/html_elements.rb', line 2082

def sync_selectedness_from_attribute
  @selectedness = default_selected unless @selectedness_dirty
end

#text ⇒ Object 



2086
2087
2088
2089
2090
2091
2092
 
# File 'lib/dommy/html_elements.rb', line 2086

def text
  # WHATWG: strip-and-collapse ASCII whitespace over the concatenated Text
  # node descendants — excluding any inside a script (HTML or SVG) element.
  parts = []
  collect_option_text(@__node__, parts)
  parts.join.gsub(/[\t\n\f\r ]+/, " ").strip
end

#text=(v) ⇒ Object 



2094
2095
2096
 
# File 'lib/dommy/html_elements.rb', line 2094

def text=(v)
  self.text_content = v
end

#value ⇒ Object 



2013
2014
2015
2016
2017
2018
 
# File 'lib/dommy/html_elements.rb', line 2013

def value
  # `value`/`label` reflect the NO-namespace content attribute (a same-named
  # attribute in another namespace, via setAttributeNS, does not count);
  # both default to the option's `text` when their attribute is absent.
  has_attribute_ns?(nil, "value") ? get_attribute_ns(nil, "value").to_s : text
end

#value=(v) ⇒ Object 



2020
2021
2022
 
# File 'lib/dommy/html_elements.rb', line 2020

def value=(v)
  set_reflected_string("value", v)
end