class ActsAsTaggableOn::TagList

Attributes

owner[RW]

Public Class Methods

from(string) click to toggle source

Returns a new TagList using the given tag string.

Example:

tag_list = TagList.from("One , Two,  Three")
tag_list # ["One", "Two", "Three"]
# File lib/acts_as_taggable_on/tag_list.rb, line 17
def self.from(string)
  string = string.join(ActsAsTaggableOn.glue) if string.respond_to?(:join)

  new.tap do |tag_list|
    string = string.to_s.dup

    # Parse the quoted tags
    d = ActsAsTaggableOn.delimiter
    d = d.join("|") if d.kind_of?(Array) 
    string.gsub!(/(\A|#{d})\s*"(.*?)"\s*(#{d}\s*|\z)/) { tag_list << $2; $3 }
    string.gsub!(/(\A|#{d})\s*'(.*?)'\s*(#{d}\s*|\z)/) { tag_list << $2; $3 }

    tag_list.add(string.split(Regexp.new d))
  end
end
new(*args) click to toggle source
# File lib/acts_as_taggable_on/tag_list.rb, line 7
def initialize(*args)
  add(*args)
end

Public Instance Methods

add(*names) click to toggle source

Add tags to the tag_list. Duplicate or blank tags will be ignored. Use the :parse option to add an unparsed tag string.

Example:

tag_list.add("Fun", "Happy")
tag_list.add("Fun, Happy", :parse => true)
# File lib/acts_as_taggable_on/tag_list.rb, line 40
def add(*names)
  extract_and_apply_options!(names)
  concat(names)
  clean!
  self
end
remove(*names) click to toggle source

Remove specific tags from the tag_list. Use the :parse option to add an unparsed tag string.

Example:

tag_list.remove("Sad", "Lonely")
tag_list.remove("Sad, Lonely", :parse => true)
# File lib/acts_as_taggable_on/tag_list.rb, line 54
def remove(*names)
  extract_and_apply_options!(names)
  delete_if { |name| names.include?(name) }
  self
end
to_s() click to toggle source

Transform the tag_list into a tag string suitable for editing in a form. The tags are joined with TagList.delimiter and quoted if necessary.

Example:

tag_list = TagList.new("Round", "Square,Cube")
tag_list.to_s # 'Round, "Square,Cube"'
# File lib/acts_as_taggable_on/tag_list.rb, line 67
def to_s
  tags = frozen? ? self.dup : self
  tags.send(:clean!)

  tags.map do |name|
    d = ActsAsTaggableOn.delimiter
    d = Regexp.new d.join("|") if d.kind_of? Array
    name.index(d) ? "\"#{name}\"" : name
  end.join(ActsAsTaggableOn.glue)
end

Private Instance Methods

clean!() click to toggle source

Remove whitespace, duplicates, and blanks.

# File lib/acts_as_taggable_on/tag_list.rb, line 81
def clean!
  reject!(&:blank?)
  map!(&:strip)
  map!{ |tag| tag.mb_chars.downcase.to_s } if ActsAsTaggableOn.force_lowercase
  map!(&:parameterize) if ActsAsTaggableOn.force_parameterize

  uniq!
end
extract_and_apply_options!(args) click to toggle source
# File lib/acts_as_taggable_on/tag_list.rb, line 90
def extract_and_apply_options!(args)
  options = args.last.is_a?(Hash) ? args.pop : {}
  options.assert_valid_keys :parse

  if options[:parse]
    args.map! { |a| self.class.from(a) }
  end

  args.flatten!
end