1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138
|
# -*- coding: utf-8 -*-
module Sass::Script::Value
# A SassScript object representing a CSS string *or* a CSS identifier.
class String < Base
@@interpolation_deprecation = Sass::Deprecation.new
# The Ruby value of the string.
#
# @return [String]
attr_reader :value
# Whether this is a CSS string or a CSS identifier.
# The difference is that strings are written with double-quotes,
# while identifiers aren't.
#
# @return [Symbol] `:string` or `:identifier`
attr_reader :type
def self.value(contents)
contents.gsub("\\\n", "").gsub(/\\(?:([0-9a-fA-F]{1,6})\s?|(.))/) do
next $2 if $2
# Handle unicode escapes as per CSS Syntax Level 3 section 4.3.8.
code_point = $1.to_i(16)
if code_point == 0 || code_point > 0x10FFFF ||
(code_point >= 0xD800 && code_point <= 0xDFFF)
'�'
else
[code_point].pack("U")
end
end
end
# Returns the quoted string representation of `contents`.
#
# @options opts :quote [String]
# The preferred quote style for quoted strings. If `:none`, strings are
# always emitted unquoted. If `nil`, quoting is determined automatically.
# @options opts :sass [String]
# Whether to quote strings for Sass source, as opposed to CSS. Defaults to `false`.
def self.quote(contents, opts = {})
quote = opts[:quote]
# Short-circuit if there are no characters that need quoting.
unless contents =~ /[\n\\"']|\#\{/
quote ||= '"'
return "#{quote}#{contents}#{quote}"
end
if quote.nil?
if contents.include?('"')
if contents.include?("'")
quote = '"'
else
quote = "'"
end
else
quote = '"'
end
end
# Replace single backslashes with multiples.
contents = contents.gsub("\\", "\\\\\\\\")
# Escape interpolation.
contents = contents.gsub('#{', "\\\#{") if opts[:sass]
if quote == '"'
contents = contents.gsub('"', "\\\"")
else
contents = contents.gsub("'", "\\'")
end
contents = contents.gsub(/\n(?![a-fA-F0-9\s])/, "\\a").gsub("\n", "\\a ")
"#{quote}#{contents}#{quote}"
end
# Creates a new string.
#
# @param value [String] See \{#value}
# @param type [Symbol] See \{#type}
# @param deprecated_interp_equivalent [String?]
# If this was created via a potentially-deprecated string interpolation,
# this is the replacement expression that should be suggested to the user.
def initialize(value, type = :identifier, deprecated_interp_equivalent = nil)
super(value)
@type = type
@deprecated_interp_equivalent = deprecated_interp_equivalent
end
# @see Value#plus
def plus(other)
other_value = if other.is_a?(Sass::Script::Value::String)
other.value
else
other.to_s(:quote => :none)
end
Sass::Script::Value::String.new(value + other_value, type)
end
# @see Value#to_s
def to_s(opts = {})
return @value.gsub(/\n\s*/, ' ') if opts[:quote] == :none || @type == :identifier
String.quote(value, opts)
end
# @see Value#to_sass
def to_sass(opts = {})
to_s(opts.merge(:sass => true))
end
def separator
check_deprecated_interp
super
end
def to_a
check_deprecated_interp
super
end
# Prints a warning if this string was created using potentially-deprecated
# interpolation.
def check_deprecated_interp
return unless @deprecated_interp_equivalent
@@interpolation_deprecation.warn(source_range.file, source_range.start_pos.line, <<WARNING)
\#{} interpolation near operators will be simplified in a future version of Sass.
To preserve the current behavior, use quotes:
#{@deprecated_interp_equivalent}
WARNING
end
def inspect
String.quote(value)
end
end
end
|