# frozen_string_literal: true require_relative 'docx_paragraph/bookmark_start' require_relative 'docx_paragraph/bookmark_end' require_relative 'docx_paragraph/comment_range_end' require_relative 'docx_paragraph/comment_range_start' require_relative 'docx_paragraph/docx_paragraph_helper' require_relative 'docx_paragraph/docx_paragraph_run' require_relative 'docx_paragraph/field_simple' require_relative 'docx_paragraph/indents' require_relative 'docx_paragraph/inserted' require_relative 'docx_paragraph/structured_document_tag' require_relative 'docx_paragraph/frame_properties' require_relative 'docx_paragraph/docx_formula' module OoxmlParser # Class for data of DocxParagraph class DocxParagraph < OOXMLDocumentObject include DocxParagraphHelper attr_accessor :number, :align, :numbering, :character_style_array, :page_break, :borders, :keep_lines, :contextual_spacing, :sector_properties, :page_numbering, :section_break, :style, :keep_next, :orphan_control # @return [Hyperlink] hyperlink in paragraph attr_reader :hyperlink # @return [ParagraphProperties] Properties of current paragraph attr_accessor :paragraph_properties # @return [Inserted] data inserted by review attr_accessor :inserted # @return [FieldSimple] field simple attr_reader :field_simple # @return [Integer] id of paragraph (for comment) attr_accessor :paragraph_id # @return [MathParagraph] math paragraph attr_reader :math_paragraph # Set spacing value attr_writer :spacing # @return [Integer] id of text (for comment) attr_accessor :text_id def initialize(parent: nil) @number = 0 @align = :left @spacing = Spacing.new @ind = Indents.new @character_style_array = [] @page_break = false @borders = Borders.new @keep_lines = false @contextual_spacing = false @page_numbering = false @keep_next = false @orphan_control = true super end alias elements character_style_array # Constructor for copy of object # @param source [DocxParagraph] original object # @return [void] def initialize_copy(source) super @character_style_array = source.character_style_array.clone @spacing = source.instance_variable_get(:@spacing).clone end # @return [Array] array of child objects that contains data def nonempty_runs @character_style_array.select do |cur_run| case cur_run when DocxParagraphRun, ParagraphRun !cur_run.empty? when DocxFormula, StructuredDocumentTag, BookmarkStart, BookmarkEnd, CommentRangeStart, CommentRangeEnd true end end end alias runs character_style_array # @return [True, false] if structure contain any user data def with_data? !nonempty_runs.empty? || paragraph_properties&.section_properties end # Compare this object to other # @param other [Object] any other object # @return [True, False] result of comparision def ==(other) ignored_attributes = %i[@number @parent] all_instance_variables = instance_variables significan_attribues = all_instance_variables - ignored_attributes significan_attribues.each do |current_attributes| return false unless instance_variable_get(current_attributes) == other.instance_variable_get(current_attributes) end true end # Parse object # @param node [Nokogiri::XML:Node] node with DocxParagraph # @param par_number [Integer] number of paragraph # @param default_character [DocxParagraphRun] style for paragraph # @param parent [OOXMLDocumentObject] parent of run # @return [DocxParagraph] result of parse def parse(node, par_number = 0, default_character = DocxParagraphRun.new, parent: nil) @parent ||= parent default_character_style = default_character.dup character_styles_array = [] custom_character_style = default_character_style.dup custom_character_style.parent = self char_number = 0 node.attributes.each do |key, value| case key when 'paraId' @paragraph_id = value.value.to_i when 'textId' @text_id = value.value.to_i end end node.xpath('*').each do |node_child| case node_child.name when 'bookmarkStart' character_styles_array << BookmarkStart.new(parent: self).parse(node_child) when 'bookmarkEnd' character_styles_array << BookmarkEnd.new(parent: self).parse(node_child) when 'pPr' @paragraph_properties = ParagraphProperties.new(parent: self).parse(node_child) parse_paragraph_style(node_child, custom_character_style) when 'commentRangeStart' character_styles_array << CommentRangeStart.new(parent: self).parse(node_child) when 'commentRangeEnd' character_styles_array << CommentRangeEnd.new(parent: self).parse(node_child) when 'fldSimple' @field_simple = FieldSimple.new(parent: self).parse(node_child) @page_numbering = true if field_simple.page_numbering? character_styles_array += field_simple.runs when 'r' run = custom_character_style.dup node_child.xpath('w:instrText').each do |insrt_text| @page_numbering = true if insrt_text.text.include?('PAGE') end run.parse(node_child, char_number, parent: self) character_styles_array << run char_number += 1 when 'hyperlink' @hyperlink = Hyperlink.new(parent: self).parse(node_child) hyperlink_run = default_character_style.dup hyperlink_run.parent = self if @hyperlink.id @hyperlink.parent = hyperlink_run hyperlink_run.link = @hyperlink elsif @hyperlink.anchor hyperlink_run.link = @hyperlink.anchor end node_child.xpath('w:r').each do |r_tag| hyperlink_run.parse(r_tag, char_number, parent: self) character_styles_array << hyperlink_run char_number += 1 end node_child.xpath('w:fldSimple').each do |simple_field| hyperlink_field_simple = FieldSimple.new(parent: self).parse(simple_field) character_styles_array += hyperlink_field_simple.runs end when 'oMathPara' @math_paragraph = MathParagraph.new(parent: self).parse(node_child) character_styles_array << math_paragraph.math when 'ins' @inserted = Inserted.new(parent: self).parse(node_child) when 'sdt' character_styles_array << StructuredDocumentTag.new(parent: self).parse(node_child) end end @number = par_number character_styles_array.last.text = character_styles_array.last.text.rstrip if character_styles_array.last.instance_of?(DocxParagraphRun) @character_style_array = character_styles_array @parent = parent self end # Parse style # @param node [Nokogiri::XML:Node] node with style # @param default_char_style [DocxParagraphRun] style for paragraph # @return [DocxParagraph] result of parse def parse_paragraph_style(node, default_char_style = DocxParagraphRun.new(parent: self)) node.xpath('*').each do |node_child| case node_child.name when 'pageBreakBefore' @page_break = true if node_child.attribute('val').nil? || node_child.attribute('val').value != 'false' when 'pBdr' @borders = ParagraphBorders.new(parent: self).parse(node_child) when 'keepLines' if node_child.attribute('val').nil? @keep_lines = true else @keep_lines = true unless node_child.attribute('val').value == 'false' end when 'widowControl' @orphan_control = option_enabled?(node_child) when 'keepNext' @keep_next = true when 'contextualSpacing' @contextual_spacing = true when 'pStyle' @paragraph_style_ref = ParagraphStyleRef.new(parent: self).parse(node_child) fill_style_data(default_char_style) when 'ind' @ind = root_object.default_paragraph_style.instance_variable_get(:@ind).dup.parse(node_child) when 'numPr' @numbering = NumberingProperties.new(parent: self).parse(node_child) when 'jc' @justification_object = ValuedChild.new(:string, parent: self).parse(node_child) @align = @justification_object.value.to_sym unless @justification_object.value.nil? @align = :justify if @justification_object.value == 'both' when 'spacing' @valued_spacing = ParagraphSpacing.new(parent: self).parse(node_child) @spacing = @spacing.fetch_from_valued_spacing(@valued_spacing) when 'sectPr' @sector_properties = PageProperties.new(parent: self).parse(node_child, self, default_char_style) @section_break ||= @sector_properties.section_break end end @parent = parent self end def spacing style_spacing = root_object.styles&.default_style(:paragraph)&.paragraph_properties&.spacing return Spacing.new.fetch_from_valued_spacing(style_spacing) if style_spacing @spacing end # @return [Indents] value of indents def ind return @ind if @ind != Indents.new indents_from_styles = root_object.styles&.default_style(:paragraph)&.paragraph_properties&.indent return indents_from_styles if indents_from_styles Indents.new end # Fill data from styles # @param character_style [DocxParagraphRun] style to parse # @return [void] def fill_style_data(character_style) @style = root_object.document_style_by_id(@paragraph_style_ref.value) parse_paragraph_style(@style.paragraph_properties_node, character_style) if @style.paragraph_properties_node character_style.parse_properties(@style.run_properties_node) if @style.run_properties_node end extend Gem::Deprecate deprecate :page_numbering, 'field_simple.page_numbering?', 2020, 1 # @return [OoxmlParser::StructuredDocumentTag] Return first sdt element def sdt @character_style_array.each do |cur_element| return cur_element if cur_element.is_a?(StructuredDocumentTag) end nil end deprecate :sdt, 'nonempty_runs[i]', 2020, 1 end end