method

excerpt

v1.2.6 - Show latest stable - 1 note - Class: ActionView::Helpers::TextHelper

excerpt(text, phrase, radius = 100, excerpt_string = "...") public

Extracts an excerpt from text that matches the first instance of phrase. The radius expands the excerpt on each side of phrase by the number of characters defined in radius. If the excerpt radius overflows the beginning or end of the text, then the excerpt_string will be prepended/appended accordingly. If the phrase isn’t found, nil is returned.

  excerpt('This is an example', 'an', 5)
   => "...s is an examp..."

  excerpt('This is an example', 'is', 5)
   => "This is an..."

Show source

# File actionpack/lib/action_view/helpers/text_helper.rb, line 62
      def excerpt(text, phrase, radius = 100, excerpt_string = "...")
        if text.nil? || phrase.nil? then return end
        phrase = Regexp.escape(phrase)

        if found_pos = text.chars =~ /(#{phrase})/i
          start_pos = [ found_pos - radius, 0 ].max
          end_pos   = [ found_pos + phrase.chars.length + radius, text.chars.length ].min

          prefix  = start_pos > 0 ? excerpt_string : ""
          postfix = end_pos < text.chars.length ? excerpt_string : ""

          prefix + text.chars[start_pos..end_pos].strip + postfix
        else
          nil
        end
      end

September 23, 2008 - (<= v2.1.0)

1 thank

Description copied from Rails 2.0

Extracts an excerpt from text that matches the first instance of phrase. The radius expands the excerpt on each side of the first occurrence of phrase by the number of characters defined in radius (which defaults to 100). If the excerpt radius overflows the beginning or end of the text, then the excerpt_string will be prepended/appended accordingly. If the phrase isn‘t found, nil is returned.

Examples

excerpt('This is an example', 'an', 5)
# => "...s is an examp..."

excerpt('This is an example', 'is', 5)
# => "This is an..."

excerpt('This is an example', 'is')
# => "This is an example"

excerpt('This next thing is an example', 'ex', 2)
# => "...next t..."

excerpt('This is also an example', 'an', 8, '<chop> ')
# => "<chop> is also an example"

excerpt

Related methods

Description copied from Rails 2.0

Examples