# frozen_string_literal: true
require "cgi"
HTMLPipeline.require_dependencies(["gemoji", "gemojione"], "EmojiFilter")
class HTMLPipeline
class NodeFilter
# HTML filter that replaces :emoji: with images.
#
# Context:
# :asset_root (required) - base url to link to emoji sprite
# :asset_path (optional) - url path to link to emoji sprite. :file_name can be used as a placeholder for the sprite file name. If no asset_path is set "emoji/:file_name" is used.
# :ignored_ancestor_tags (optional) - Tags to stop the emojification. Node has matched ancestor HTML tags will not be emojified. Default to pre, code, and tt tags. Extra tags please pass in the form of array, e.g., %w(blockquote summary).
# :img_attrs (optional) - Attributes for generated img tag. E.g. Pass { "draggble" => true, "height" => nil } to set draggable attribute to "true" and clear height attribute of generated img tag.
class EmojiFilter < NodeFilter
DEFAULT_IGNORED_ANCESTOR_TAGS = ["pre", "code", "tt"].freeze
# Build a regexp that matches all valid :emoji: names.
def after_initialize
@emoji_pattern ||= /:(#{emoji_names.map { |name| Regexp.escape(name) }.join('|')}):/
end
def selector
Selma::Selector.new(match_text_within: "*", ignore_text_within: ignored_ancestor_tags)
end
def handle_text_chunk(text)
return unless text.to_s.include?(":")
text.replace(emoji_image_filter(text.to_s), as: :html)
end
# Implementation of validate hook.
# Errors should raise exceptions or use an existing validator.
def validate
needs(:asset_root)
end
# Replace :emoji: with corresponding images.
#
# text - String text to replace :emoji: in.
#
# Returns a String with :emoji: replaced with images.
def emoji_image_filter(text)
text.gsub(@emoji_pattern) do
emoji_image_tag(Regexp.last_match(1))
end
end
# The base url to link emoji sprites
#
# Raises ArgumentError if context option has not been provided.
# Returns the context's asset_root.
def asset_root
context[:asset_root]
end
# The url path to link emoji sprites
#
# :file_name can be used in the asset_path as a placeholder for the sprite file name. If no asset_path is set in the context "emoji/:file_name" is used.
# Returns the context's asset_path or the default path if no context asset_path is given.
def asset_path(name)
if context[:asset_path]
context[:asset_path].gsub(":file_name", emoji_filename(name))
else
File.join("emoji", emoji_filename(name))
end
end
# Build an emoji image tag
private def emoji_image_tag(name)
html_attrs =
default_img_attrs(name).transform_keys(&:to_sym)
.merge!(context[:img_attrs] || {}).transform_keys(&:to_sym)
.each_with_object([]) do |(attr, value), arr|
next if value.nil?
value = value.respond_to?(:call) && value.call(name) || value
arr << %(#{attr}="#{value}")
end.compact.join(" ")
""
end
def emoji_names
if self.class.gemoji_loaded?
Emoji.all.map(&:aliases)
else
Gemojione::Index.new.all.map { |i| i[1]["name"] }
end.flatten.sort
end
# Default attributes for img tag
private def default_img_attrs(name)
{
"class" => "emoji",
"title" => ":#{name}:",
"alt" => ":#{name}:",
"src" => emoji_url(name).to_s,
"height" => "20",
"width" => "20",
"align" => "absmiddle",
}
end
private def emoji_url(name)
File.join(asset_root, asset_path(name))
end
private def emoji_filename(name)
if self.class.gemoji_loaded?
Emoji.find_by_alias(name).image_filename
else
# replace their asset_host with ours
Gemojione.image_url_for_name(name).sub(Gemojione.asset_host, "")
end
end
# Return ancestor tags to stop the emojification.
#
# @return [Array] Ancestor tags.
private def ignored_ancestor_tags
if context[:ignored_ancestor_tags]
DEFAULT_IGNORED_ANCESTOR_TAGS | context[:ignored_ancestor_tags]
else
DEFAULT_IGNORED_ANCESTOR_TAGS
end
end
end
end
end