Class: Sass::Engine
Overview
This class handles the parsing and compilation of the Sass template. Example usage:
template = File.load('stylesheets/sassy.sass')
sass_engine = Sass::Engine.new(template)
output = sass_engine.render
puts output
Defined Under Namespace
Classes: Line
Constant Summary collapse
- PROPERTY_CHAR =
The character that begins a CSS property.
?:
- SCRIPT_CHAR =
The character that designates that a property should be assigned to a SassScript expression.
?=
- COMMENT_CHAR =
The character that designates the beginning of a comment, either Sass or CSS.
?/
- SASS_COMMENT_CHAR =
The character that follows the general COMMENT_CHAR and designates a Sass comment, which is not output as a CSS comment.
?/
- CSS_COMMENT_CHAR =
The character that follows the general COMMENT_CHAR and designates a CSS comment, which is embedded in the CSS document.
?*
- DIRECTIVE_CHAR =
The character used to denote a compiler directive.
?@
- ESCAPE_CHAR =
Designates a non-parsed rule.
?\\
- MIXIN_DEFINITION_CHAR =
Designates block as mixin definition rather than CSS rules to output
?=
- MIXIN_INCLUDE_CHAR =
Includes named mixin declared using MIXIN_DEFINITION_CHAR
?+
- PROPERTY_NEW_MATCHER =
The regex that matches properties of the form
name: prop
. /^[^\s:"\[]+\s*[=:](\s|$)/
- PROPERTY_NEW =
The regex that matches and extracts data from properties of the form
name: prop
. /^([^\s=:"]+)\s*(=|:)(?:\s+|$)(.*)/
- PROPERTY_OLD =
The regex that matches and extracts data from properties of the form
:name prop
. /^:([^\s=:"]+)\s*(=?)(?:\s+|$)(.*)/
- DEFAULT_OPTIONS =
The default options for Sass::Engine.
{ :style => :nested, :load_paths => ['.'], :cache => true, :cache_location => './.sass-cache', :syntax => :sass, }.freeze
Constants included from Haml::Util
Instance Method Summary collapse
-
#initialize(template, options = {}) ⇒ Engine
constructor
A new instance of Engine.
-
#render ⇒ String
(also: #to_css)
Render the template to CSS.
-
#to_tree ⇒ Sass::Tree::Node
Parses the document into its parse tree.
Methods included from Haml::Util
#ap_geq_3?, #ap_geq_3_beta_3?, #assert_html_safe!, #av_template_class, #caller_info, #check_encoding, #def_static_method, #enum_cons, #enum_slice, #enum_with_index, #flatten, #haml_warn, #has?, #html_safe, #intersperse, #map_hash, #map_keys, #map_vals, #merge_adjacent_strings, #ord, #paths, #powerset, #rails_env, #rails_root, #rails_safe_buffer_class, #rails_xss_safe?, #restrict, #ruby1_8?, #ruby1_8_6?, #scope, #set_eql?, #set_hash, #silence_haml_warnings, #silence_warnings, #static_method_name, #strip_string_array, #substitute, #to_hash
Constructor Details
#initialize(template, options = {}) ⇒ Engine
Returns a new instance of Engine.
138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 |
# File 'lib/sass/engine.rb', line 138
def initialize(template, options={})
@options = DEFAULT_OPTIONS.merge(options.reject {|k, v| v.nil?})
@template = template
# Support both, because the docs said one and the other actually worked
# for quite a long time.
@options[:line_comments] ||= @options[:line_numbers]
# Backwards compatibility
@options[:property_syntax] ||= @options[:attribute_syntax]
case @options[:property_syntax]
when :alternate; @options[:property_syntax] = :new
when :normal; @options[:property_syntax] = :old
end
end
|
Instance Method Details
#render ⇒ String Also known as: to_css
Render the template to CSS.
158 159 160 161 |
# File 'lib/sass/engine.rb', line 158
def render
return _to_tree.render unless @options[:quiet]
Haml::Util.silence_haml_warnings {_to_tree.render}
end
|
#to_tree ⇒ Sass::Tree::Node
Parses the document into its parse tree.
168 169 170 171 |
# File 'lib/sass/engine.rb', line 168
def to_tree
return _to_tree unless @options[:quiet]
Haml::Util.silence_haml_warnings {_to_tree}
end
|