123456789_123456789_123456789_123456789_123456789_

Class: ActionText::Fragment

Relationships & Source Files
Inherits: Object
Defined in: actiontext/lib/action_text/fragment.rb

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(source) ⇒ Fragment

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 28

def initialize(source)
  @source = source
end

Class Method Details

.from_html(html)

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 19

def from_html(html)
  new(ActionText::HtmlConversion.fragment_for_html(html.to_s.strip))
end

.wrap(fragment_or_html)

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 8

def wrap(fragment_or_html)
  case fragment_or_html
  when self
    fragment_or_html
  when Nokogiri::XML::DocumentFragment # base class for all fragments
    new(fragment_or_html)
  else
    from_html(fragment_or_html)
  end
end

Instance Attribute Details

#deconstruct (readonly)

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 26

delegate :deconstruct, to: "source.elements"

#source (readonly)

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 24

attr_reader :source

Instance Method Details

#find_all(selector)

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 32

def find_all(selector)
  source.css(selector)
end

#replace(selector)

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 41

def replace(selector)
  update do |source|
    source.css(selector).each do |node|
      replacement_node = yield(node)
      node.replace(replacement_node.to_s) if node != replacement_node
    end
  end
end

#to_html

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 54

def to_html
  @html ||= HtmlConversion.node_to_html(source)
end

#to_plain_text

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 50

def to_plain_text
  @plain_text ||= PlainTextConversion.node_to_plain_text(source)
end

#to_s

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 58

def to_s
  to_html
end

#update {|source = self.source.dup| ... }

Yields:

[ GitHub ]

  
# File 'actiontext/lib/action_text/fragment.rb', line 36

def update
  yield source = self.source.dup
  self.class.new(source)
end