module FontAwesome
module Rails
module IconHelper
# Creates an icon tag given an icon name and possible icon
# modifiers.
#
# Examples
#
# fa_icon "camera-retro"
# # =>
#
# fa_icon "camera-retro", text: "Take a photo"
# # => Take a photo
#
# fa_icon "camera-retro 2x"
# # =>
# fa_icon ["camera-retro", "4x"]
# # =>
# fa_icon "spinner spin large"
# # =>
#
# fa_icon "quote-left 4x muted", class: "pull-left"
# # =>
#
# fa_icon "user", data: { id: 123 }
# # =>
#
# content_tag(:li, fa_icon("ok li", text: "Bulleted list item"))
# # => Bulleted list item
def fa_icon(names = "flag", options = {})
classes = Private.icon_names(names).concat(Array(options.delete(:class)))
text = options.delete(:text)
icon = content_tag(:i, nil, options.merge(:class => classes))
Private.icon_join(icon, text)
end
# Creates an stack set of icon tags given a base icon name, a main icon
# name, and possible icon modifiers.
#
# Examples
#
# fa_stacked_icon "twitter", base: "check-empty"
# # =>
# # =>
# # =>
# # =>
#
# fa_stacked_icon "terminal light", base: "sign-blank", class: "pull-right", text: "Hi!"
# # =>
# # =>
# # =>
# # => Hi!
#
# fa_stacked_icon "camera", base: "ban-circle", reverse: true
# # =>
# # =>
# # =>
# # =>
def fa_stacked_icon(names = "flag", options = {})
classes = Private.icon_names("stack").concat(Array(options.delete(:class)))
base_names = Private.array_value(options.delete(:base)).push("stack-base")
base = fa_icon(base_names, options.delete(:base_options) || {})
icon = fa_icon(names, options.delete(:icon_options) || {})
icons = [base, icon]
icons.reverse! if options.delete(:reverse)
text = options.delete(:text)
stacked_icon = content_tag(:span, safe_join(icons), options.merge(:class => classes))
Private.icon_join(stacked_icon, text)
end
module Private
extend ActionView::Helpers::OutputSafetyHelper
def self.icon_join(icon, text)
return icon if text.blank?
safe_join([icon, ERB::Util.html_escape(text)], " ")
end
def self.icon_names(names = [])
array_value(names).map { |n| "icon-#{n}" }
end
def self.array_value(value = [])
value.is_a?(Array) ? value : value.to_s.split(/\s+/)
end
end
end
end
end