Class: ActionText::Fragment

Inherits:
Object
  • Object
show all
Defined in:
lib/action_text/fragment.rb

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(source) ⇒ Fragment

Returns a new instance of Fragment.



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

def initialize(source)
  @source = source
end

Instance Attribute Details

#sourceObject (readonly)

Returns the value of attribute source.



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

def source
  @source
end

Class Method Details

.from_html(html) ⇒ Object



17
18
19
# File '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) ⇒ Object



6
7
8
9
10
11
12
13
14
15
# File '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 Method Details

#find_all(selector) ⇒ Object



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

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

#replace(selector) ⇒ Object



37
38
39
40
41
42
43
44
# File '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_htmlObject



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

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

#to_plain_textObject



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

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

#to_sObject



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

def to_s
  to_html
end

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

Yields:



32
33
34
35
# File 'lib/action_text/fragment.rb', line 32

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