Class: Coradoc::CoreModel::StructuralElement

Inherits:
Base
  • Object
show all
Defined in:
lib/coradoc/core_model/structural_element.rb

Overview

Base class for structural elements

Represents document structure elements that organize content. Typed subclasses (SectionElement, DocumentElement, etc.) express their role via the class hierarchy — the class IS the type.

Structural elements can contain other elements (blocks, lists, etc.) and can be nested hierarchically to represent document structure.

Instance Attribute Summary collapse

Attributes inherited from Base

#element_attributes, #id, #metadata_entries, #title

Class Method Summary collapse

Instance Method Summary collapse

Methods inherited from Base

#accept, #attr, #metadata, #semantically_equivalent?, #set_attr, #set_metadata

Instance Attribute Details

#attributes ⇒ Metadata?

Returns document-level attributes (typed key-value pairs).

Returns:

  • (Metadata, nil) —

    document-level attributes (typed key-value pairs)



28
 
# File 'lib/coradoc/core_model/structural_element.rb', line 28

attribute :attributes, Metadata

#children ⇒ Array<Base>?

Returns child elements (sections, blocks, etc.).

Returns:

  • (Array<Base>, nil) —

    child elements (sections, blocks, etc.)



24
 
# File 'lib/coradoc/core_model/structural_element.rb', line 24

attribute :children, Base, collection: true

#content ⇒ String?

Returns text content of the element.

Returns:

  • (String, nil) —

    text content of the element



20
 
# File 'lib/coradoc/core_model/structural_element.rb', line 20

attribute :content, :string

#level ⇒ Integer?

Returns hierarchical level (1-6 for sections).

Returns:

  • (Integer, nil) —

    hierarchical level (1-6 for sections)



16
 
# File 'lib/coradoc/core_model/structural_element.rb', line 16

attribute :level, :integer

Class Method Details

.element_type_name ⇒ Object 



56
57
58
 
# File 'lib/coradoc/core_model/structural_element.rb', line 56

def self.element_type_name
  nil
end

Instance Method Details

#document? ⇒ Boolean

Returns:

  • (Boolean) 


38
39
40
 
# File 'lib/coradoc/core_model/structural_element.rb', line 38

def document?
  false
end

#element_type ⇒ Object

Derived element_type string for backward compatibility with templates and legacy consumers. Subclasses override this.



52
53
54
 
# File 'lib/coradoc/core_model/structural_element.rb', line 52

def element_type
  self.class.element_type_name
end

#header? ⇒ Boolean

Returns:

  • (Boolean) 


46
47
48
 
# File 'lib/coradoc/core_model/structural_element.rb', line 46

def header?
  false
end

#heading_level ⇒ Object 



30
31
32
 
# File 'lib/coradoc/core_model/structural_element.rb', line 30

def heading_level
  level || 1
end

#preamble? ⇒ Boolean

Returns:

  • (Boolean) 


42
43
44
 
# File 'lib/coradoc/core_model/structural_element.rb', line 42

def preamble?
  false
end

#section? ⇒ Boolean

Returns:

  • (Boolean) 


34
35
36
 
# File 'lib/coradoc/core_model/structural_element.rb', line 34

def section?
  false
end