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

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

#__node__, #document

Instance Method Summary

• #__js_call__(method, args) ⇒ Object
• #__js_get__(key) ⇒ 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 Element

#[], #[]=, #__shadow_root__, #after, #anchor_href, #append, #append_child, #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_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, #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

Methods included from EventTarget

#__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 3050

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 3024

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_set__(key, value) ⇒ Object

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

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 2880

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 2884

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

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

#create_caption ⇒ Object

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

def create_caption
  existing = caption
  return existing if existing

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

#create_t_body ⇒ Object

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

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

  tb
end

#create_t_foot ⇒ Object

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

def create_t_foot
  existing = t_foot
  return existing if existing

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

#create_t_head ⇒ Object

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

def create_t_head
  existing = t_head
  return existing if existing

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

  head
end

#delete_caption ⇒ Object

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

def delete_caption
  cap = caption
  cap&.remove
  nil
end

#delete_row(index) ⇒ Object

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

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

#delete_t_foot ⇒ Object

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

def delete_t_foot
  t_foot&.remove
  nil
end

#delete_t_head ⇒ Object

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

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 2996

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.__node__.parent
    if section
      anchor.__node__.add_previous_sibling(tr.__node__)
      @document.notify_child_list_mutation(target_node: section, added_nodes: [tr.__node__], removed_nodes: [])
    end
  end

  tr
end

#rows ⇒ Object

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

def rows
  el = self
  HTMLCollection.new do
    ordered = []
    head = el.__node__.element_children.find { |n| n.name == "thead" }
    bodies = el.__node__.element_children.select { |n| n.name == "tbody" }
    direct = el.__node__.element_children.select { |n| n.name == "tr" }
    foot = el.__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 2900

def t_bodies
  el = self
  HTMLCollection.new do
    el
      .__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 2896

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 2892

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