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
# File lib/acts_as_taggable_on/tag_list.rb, line 7 def initialize(*args) add(*args) 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
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
# 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