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 24



def initialize(source)
  @source = source
end


  







Class Method Details



  

    .from_html(html)  
  

  [ GitHub ]


  

  


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



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 6



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



  

    #source   (readonly)
  

  [ GitHub ]


  

  


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



attr_reader :source


  







Instance Method Details



  

    #find_all(selector)  
  

  [ GitHub ]


  

  


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



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


  








  

    #replace(selector)  
  

  [ GitHub ]


  

  


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



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 50



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


  








  

    #to_plain_text  
  

  [ GitHub ]


  

  


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



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


  








  

    #to_s  
  

  [ GitHub ]


  

  


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



def to_s
  to_html
end


  








  

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



  

    
  





  
Yields:





  [ GitHub ]


  

  


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



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