Class: Sass::Script::String

Inherits:
Literal show all
Defined in:
lib/sass/script/string.rb

Overview

A SassScript object representing a CSS string or a CSS identifier.

Instance Attribute Summary collapse

Attributes inherited from Node

#context, #line, #options

Instance Method Summary collapse

Methods inherited from Literal

#==, #_perform, #and, #assert_int!, #children, #comma, #concat, #div, #eq, #inspect, #minus, #neq, #options, #or, #single_eq, #to_bool, #to_i, #unary_div, #unary_minus, #unary_not, #unary_plus

Methods inherited from Node

#_perform, #children, #dasherize, #perform

Constructor Details

#initialize(value, type = :identifier) ⇒ String

Creates a new string.

Parameters:

  • value (String) —

    See #value

  • type (Symbol) (defaults to: :identifier) —

    See #type



31
32
33
34
 
# File 'lib/sass/script/string.rb', line 31

def initialize(value, type = :identifier)
  super(value)
  @type = type
end

Instance Attribute Details

#type ⇒ Symbol (readonly)

Whether this is a CSS string or a CSS identifier. The difference is that strings are written with double-quotes, while identifiers aren't.

Returns:

  • (Symbol) —

    :string or :identifier



16
17
18
 
# File 'lib/sass/script/string.rb', line 16

def type
  @type
end

#value ⇒ String (readonly)

The Ruby value of the string.

Returns:



9
10
11
 
# File 'lib/sass/script/string.rb', line 9

def value
  @value
end

Instance Method Details

#context=(context)

In addition to setting the Node#context of the string, this sets the string to be an identifier if the context is :equals.

See Also:



22
23
24
25
 
# File 'lib/sass/script/string.rb', line 22

def context=(context)
  super
  @type = :identifier if context == :equals
end

#plus(other)

See Also:



37
38
39
40
 
# File 'lib/sass/script/string.rb', line 37

def plus(other)
  other_str = other.is_a?(Sass::Script::String) ? other.value : other.to_s
  Sass::Script::String.new(self.value + other_str, self.type)
end

#to_s(opts = {})

See Also:

  • Node#to_s


43
44
45
 
# File 'lib/sass/script/string.rb', line 43

def to_s(opts = {})
  to_sass(opts)
end

#to_sass(opts = {})

Parameters:

  • opts ({Symbol => Object}) (defaults to: {}) —

    opts[:type] -- The type of string to render this as. :strings have double quotes, :identifiers do not. Defaults to :identifier.

See Also:



52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
 
# File 'lib/sass/script/string.rb', line 52

def to_sass(opts = {})
  type = opts[:type] || self.type
  if type == :identifier
    if context == :equals && self.value !~ Sass::SCSS::RX::URI &&
        Sass::SCSS::RX.escape_ident(self.value).include?(?\\)
      return "unquote(#{Sass::Script::String.new(self.value, :string).to_sass})"
    elsif context == :equals && self.value.size == 0
      return %q{""}
    end
    return self.value.gsub("\n", " ")
  end

  return "\"#{value.gsub('"', "\\\"")}\"" if opts[:quote] == %q{"}
  return "'#{value.gsub("'", "\\'")}'" if opts[:quote] == %q{'}
  return "\"#{value}\"" unless value.include?('"')
  return "'#{value}'" unless value.include?("'")
  "\"#{value.gsub('"', "\\\"")}\"" #'
end