Class: Dommy::HTMLTableElement

Inherits:

HTMLElement

• Object
• Element
• HTMLElement
• Dommy::HTMLTableElement

Defined in:

lib/dommy/html_elements.rb

Overview

‘<table>` — top-level table element. `rows` returns rows from all sections (thead → tbody → tfoot); `tBodies` is a list of tbody elements. `insertRow(-1)` appends to the last tbody (or creates one); `deleteRow` works against the merged `rows` list.

Constant Summary

JS_METHOD_NAMES =

Own js_call methods, on top of Element’s.

%w[
  insertRow deleteRow createCaption deleteCaption createTHead deleteTHead
  createTFoot deleteTFoot createTBody
].freeze

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::PROCESSING_INSTRUCTION_NODE, Element::SHADOW_HOST_TAGS, 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::PROCESSING_INSTRUCTION_NODE, Node::TEXT_NODE

Instance Attribute Summary

Attributes inherited from Element

#document

Instance Method Summary

• #__js_call__(method, args) ⇒ Object
• #__js_get__(key) ⇒ Object
• #__js_method_names__ ⇒ Object
• #__js_set__(key, value) ⇒ Object
• #caption ⇒ Object
• #caption=(new_caption) ⇒ Object
• #create_caption ⇒ Object
• #create_t_body ⇒ Object
• #create_t_foot ⇒ Object
• #create_t_head ⇒ Object
• #delete_caption ⇒ Object
• #delete_row(index) ⇒ Object
• #delete_t_foot ⇒ Object
• #delete_t_head ⇒ Object
• #insert_row(index = -1)) ⇒ Object

  ‘table.insertRow(index)` — inserts a `<tr>` at the merged index.

• #rows ⇒ Object
• #t_bodies ⇒ Object
• #t_foot ⇒ Object
• #t_head ⇒ Object

Methods inherited from HTMLElement

#case_sensitive_attribute_names?

Methods inherited from Element

#[], #[]=, #__dommy_backend_node__, #__internal_shadow_root__, #__test_scroll_log__, #after, #anchor_href, #animate, #append, #append_child, #at_xpath, #attach_shadow, #attributes, #base_uri, #before, #blur, #child_element_count, #child_nodes, #children, #class_list, #class_name, #class_name=, #click, #clone_node, #closest, #compare_document_position, #contains?, #dataset, #equal_node?, #first_child, #first_element_child, #focus, #get_animations, #get_attribute, #get_attribute_node, #get_elements_by_class_name, #get_elements_by_tag_name, #get_html, #get_inner_html, #has_attribute?, #has_attributes?, #has_child_nodes?, #id, #id=, #initialize, #inner_html, #inner_html=, #insert_adjacent_element, #insert_adjacent_html, #insert_adjacent_text, #insert_before, #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, #prepend, #previous_element_sibling, #previous_sibling, #query_selector, #query_selector_all, #reflected_attr_name, #remove, #remove_attribute, #remove_attribute_node, #remove_child, #replace_child, #replace_children, #replace_with_nodes, #role, #role=, #root_node, #same_node?, #set_attribute, #set_attribute_node, #shadow_root, #slot, #slot=, #style, #tag_name, #text_content, #text_content=, #to_s, #toggle_attribute, #xpath

Methods included from EventTarget

#__internal_deliver_event__, #add_event_listener, #dispatch_event, #invoke_listener, #remove_event_listener

Constructor Details

This class inherits a constructor from Dommy::Element

Instance Method Details

#__js_call__(method, args) ⇒ Object

# File 'lib/dommy/html_elements.rb', line 3101

def __js_call__(method, args)
  case method
  when "insertRow"
    insert_row(args[0] || -1)
  when "deleteRow"
    delete_row(args[0])
  when "createCaption"
    create_caption
  when "deleteCaption"
    delete_caption
  when "createTHead"
    create_t_head
  when "deleteTHead"
    delete_t_head
  when "createTFoot"
    create_t_foot
  when "deleteTFoot"
    delete_t_foot
  when "createTBody"
    create_t_body
  else
    super
  end
end

#__js_get__(key) ⇒ Object

# File 'lib/dommy/html_elements.rb', line 3075

def __js_get__(key)
  case key
  when "caption"
    caption
  when "tHead"
    t_head
  when "tFoot"
    t_foot
  when "tBodies"
    t_bodies
  when "rows"
    rows
  else
    super
  end
end

#__js_method_names__ ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2927

def __js_method_names__
  super + JS_METHOD_NAMES
end

#__js_set__(key, value) ⇒ Object

# File 'lib/dommy/html_elements.rb', line 3092

def __js_set__(key, value)
  case key
  when "caption"
    self.caption = value
  else
    super
  end
end

#caption ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2931

def caption
  @__node__.element_children.find { |n| n.name == "caption" }&.then { |n| @document.wrap_node(n) }
end

#caption=(new_caption) ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2935

def caption=(new_caption)
  delete_caption
  return unless new_caption.respond_to?(:__dommy_backend_node__)

  first = @__node__.children.first
  first ? first.add_previous_sibling(new_caption.__dommy_backend_node__) : @__node__.add_child(new_caption.__dommy_backend_node__)
end

#create_caption ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2980

def create_caption
  existing = caption
  return existing if existing

  cap = @document.create_element("caption")
  first = @__node__.children.first
  first ? first.add_previous_sibling(cap.__dommy_backend_node__) : @__node__.add_child(cap.__dommy_backend_node__)
  cap
end

#create_t_body ⇒ Object

# File 'lib/dommy/html_elements.rb', line 3031

def create_t_body
  tb = @document.create_element("tbody")
  last_tbody = t_bodies.last
  if last_tbody
    last_tbody.__dommy_backend_node__.add_next_sibling(tb.__dommy_backend_node__)
  else
    @__node__.add_child(tb.__dommy_backend_node__)
  end

  tb
end

#create_t_foot ⇒ Object

# File 'lib/dommy/html_elements.rb', line 3017

def create_t_foot
  existing = t_foot
  return existing if existing

  foot = @document.create_element("tfoot")
  @__node__.add_child(foot.__dommy_backend_node__)
  foot
end

#create_t_head ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2996

def create_t_head
  existing = t_head
  return existing if existing

  head = @document.create_element("thead")
  cap = caption
  if cap
    cap.__dommy_backend_node__.add_next_sibling(head.__dommy_backend_node__)
  else
    first = @__node__.children.first
    first ? first.add_previous_sibling(head.__dommy_backend_node__) : @__node__.add_child(head.__dommy_backend_node__)
  end

  head
end

#delete_caption ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2990

def delete_caption
  cap = caption
  cap&.remove
  nil
end

#delete_row(index) ⇒ Object

# File 'lib/dommy/html_elements.rb', line 3070

def delete_row(index)
  rows[index.to_i]&.remove
  nil
end

#delete_t_foot ⇒ Object

# File 'lib/dommy/html_elements.rb', line 3026

def delete_t_foot
  t_foot&.remove
  nil
end

#delete_t_head ⇒ Object

# File 'lib/dommy/html_elements.rb', line 3012

def delete_t_head
  t_head&.remove
  nil
end

#insert_row(index = -1)) ⇒ Object

‘table.insertRow(index)` — inserts a `<tr>` at the merged index. Per spec, if no `<tbody>` exists and the table is empty, the row is inserted directly; otherwise it goes into the last `<tbody>`.

Raises:

• (DOMException::IndexSizeError)

# File 'lib/dommy/html_elements.rb', line 3047

def insert_row(index = -1)
  list = rows.to_a
  raw = index.to_i
  raise DOMException::IndexSizeError, "row index #{raw} out of range" if raw < -1 || raw > list.size

  idx = raw == -1 ? list.size : raw

  tr = @document.create_element("tr")
  if idx == list.size
    target_section = t_bodies.last || create_t_body
    target_section.append_child(tr)
  else
    anchor = list[idx]
    section = anchor.__dommy_backend_node__.parent
    if section
      anchor.__dommy_backend_node__.add_previous_sibling(tr.__dommy_backend_node__)
      @document.notify_child_list_mutation(target_node: section, added_nodes: [tr.__dommy_backend_node__], removed_nodes: [])
    end
  end

  tr
end

#rows ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2963

def rows
  el = self
  HTMLCollection.new do
    ordered = []
    head = el.__dommy_backend_node__.element_children.find { |n| n.name == "thead" }
    bodies = el.__dommy_backend_node__.element_children.select { |n| n.name == "tbody" }
    direct = el.__dommy_backend_node__.element_children.select { |n| n.name == "tr" }
    foot = el.__dommy_backend_node__.element_children.find { |n| n.name == "tfoot" }
    [head, *bodies, foot].compact.each do |sec|
      sec.element_children.select { |n| n.name == "tr" }.each { |n| ordered << n }
    end

    direct.each { |n| ordered << n }
    ordered.map { |n| el.document.wrap_node(n) }.compact
  end
end

#t_bodies ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2951

def t_bodies
  el = self
  HTMLCollection.new do
    el
      .__dommy_backend_node__
      .element_children
      .select { |n| n.name == "tbody" }
      .map { |n| el.document.wrap_node(n) }
      .compact
  end
end

#t_foot ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2947

def t_foot
  @__node__.element_children.find { |n| n.name == "tfoot" }&.then { |n| @document.wrap_node(n) }
end

#t_head ⇒ Object

# File 'lib/dommy/html_elements.rb', line 2943

def t_head
  @__node__.element_children.find { |n| n.name == "thead" }&.then { |n| @document.wrap_node(n) }
end