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
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 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
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
Generated with the Darkfish Rdoc Generator 2.