DON'T READ this Less CSS Tutorial (Highly Addictive)

This article was written in 2011. Because the web changes quite fast, some information here might be outdated.
WARNING: If you like copy-pasting, find-replacing, scrolling in giant messy CSS files, not reusing your code, writing hundreds of times the same thing, you should definitely LEAVE THIS PAGE RIGHT NOW. I'm serious, if you start reading this tutorial, you might like it and could dangerously become way more productive. At the end of this read, you might even think crazy things like "pure CSS sucks" ! You've been warned...
EDIT: I strongly recommend reading or watching my talk about CSS Preprocessors and considering using Sass instead of Less. If you're a web developer or designer you probably faced this kind of situation before: "I wonder if we should use a different theme on our website, can we try a blue one instead of the current green?" 2 possible answers:- A pure CSS developer: "Damn... Can you come back in 15 minutes?"
- A Less CSS developer: "Sure! Wait just a second... Done, look!"
What is Less?
A "dynamic" CSS
According to the official website, Less is a "dynamic stylesheet language". I have a question for you now: How many stylesheet languages do you know? Well except if you developed your own language and a dedicated browser to interpret it, chances are that you only know CSS. You might even have never thought about "What if there were another stylesheet language?". Well Less is kind of one. "Kind of" because you develop using the Less language, but in the end, it's compiled to pure CSS so that browsers can read it. It's also called "dynamic" because it enriches CSS with many common features available in most modern dynamic programming languages (like variables for instance). During the development phase, you'll be able to use all those new cool features we'll see in this tutorial and it will help you code way more efficiently. Less compiler, which is written in JavaScript, will convert all your Less code into CSS to be interpretable by the client. When does this conversion happen? Well you have 3 options:- On the fly in the browser with
less.js
, - By using the lessc compiler via the command-line,
- With some fancy app like CodeKit or LiveReload.
Compiling in the browser with less.js
LessCSS.org has a big tempting button to downloadless.js
. It is not a good idea. At least not for production.
Less.js
will perform AJAX requests to grab your Less files, will then process those files to convert them into CSS, and finally inject the resulting CSS in the head of your document. It is extremely inefficient in terms of performance and you should never use it in production. Plus, if the user's JavaScript is deactivated, well... it will just not work at all.
But if you just want to do a quick Less prototype or if you don't have access to your usual development environment, less.js
is perfectly fine!
Lessc and the command-line
You can also execute Less in your terminal. In order to do this, you will need to install Node.js on your development machine, and then install the Less module by running:
npm install less -g
style.less
file to style.css
:
lessc style.less > style.css
Using an application to compile for you
Here is a list of applications that you can run when you are working that will manage the compilation for you. It is taken from my slides about CSS Preprocessors:
Okay sounds cool, let's start!
In this entire scenario, my goal will be to draw CSS shapes with different colors and decorations (cause it's visual and I know you like it). Of course you can, and should, imagine how you can apply this to a real project. I highly recommend that you implement this example for real, because it's the best way to learn. Honestly, you should really do it. I know you're lazy but trust me, it's worth it. So create an empty HTML file and here we go!Our HTML file
First, here is the HTML we'll be using:A little bit of basic CSS styling
Okay, we can finally start! First, create and open astyle.less
file. Then we add some CSS styles to our shapes in order to see them. We'll set the default shape to a simple light blue square:
Run lessc style.less > style.css
to compile it and this is what your browser should display:

#ddf
light blue color in several different places in the file? Even with very good CSS best practices, we would still have to replace every single declaration of this color in order to try a new theme for example. That's not convenient at all. Let's use a Less variable to handle this.
Variables
Less variables can be declared and used with the@
symbol. You give them a name and a value, and then you can refer to the name of the variable anywhere in your Less file:
Pretty cool right? But it won't be very helpful if we have to change the references to @lightBlue
everywhere in the code. So we can for instance declare an other variable for our "default theme":
With this example you can see our code becoming more modular and reusable. We just have to change the @defaultThemeColor
to @lightGreen
to apply the new green theme:

Personal tip: I like to use the usual camelCase notation (lowercase for the first word, then uppercase for the first letter of the following words) for variables. You could also use the CSS-style naming convention with dashes-between-lowercase-words, it's up to you. It personally helps me to differentiate Less from pure CSS.
Mixins
Do you know how to draw rounds in CSS? You just have to set a very high CSS3 border-radius value. Let's apply that to the first shape:
-webkit-
and -moz-
vendor prefixes versions as well. So you would do something like this is regular CSS:
We see something interesting here: three properties with the same value. Pretty boring to write right? No problem, Less to the rescue!
With Less we can define "mixins", which are something comparable to functions in other programming languages. In Less they're used to group CSS instructions. We'll use a mixin to handle the boring repetition of border-radius declarations. Just like variables, you have to declare a mixin before calling it, with the .
symbol this time:
You can then apply this .Round
mixin wherever you want to make something round without having to declare the border-radius
instructions again. That's already cool, but it gets even cooler with parameters.
Personal best practice: You probably noticed that I used a capitalized letter for the mixin name. Well since CSS class selectors also use the .
symbol, there is no way to differentiate it from a Less mixin name. That's why I always use capitalized letters. That also mimics Object Oriented Programming, which uses capitalized letters for classes.
Parametric mixins
I now want to be able to create rounded squares, not just rounds. Let's modify our.Round
mixin to something more generic: .RoundedShape
. Our RoundedShape
mixin should be able to handle rounds and rounded squares, depending on the parameters used to call it. To declare parameters, use parentheses after the mixin name:
A parameter can be used similarly to a variable inside the mixin, and you can specify a default value for the parameter if none is given when the mixin is called. I also used a variable for this default value to keep the code reusable and generic.
So now that we have our cool RoundedShape mixin, let's create 2 other mixins which will call it to create rounds and rounded squares:
And then, all we have to do to is applying those Round
and RoundedSquare
to our shapes:
Now refresh your page and... BOOM!

RoundedSquare
, the 30px @defaultRadius
variable is used, but we could also call it with parameters, on #shape3
for instance:

Operations
One other powerful feature of Less is the ability to use mathematical operations in your stylesheets (I agree it sounds boring, but it's actually very cool). Let's declare a@defaultShapesWidth
variable to set the default shapes widths to 200px
instead of hard-coding it like we used to:
@defaultShapesWidth:200px;
@borderSize:@defaultShapesWidth * 0.1;
#000
has no effect and #fff
has a maximal effect.
And this is what we get when applying these new variables to a border rule:
border:@borderSize solid @borderColor;

Side note: Remember that all this funky Less code will be converted to CSS in the end, so this will be static once generated. If you programmatically resize the width of a shape, the border won't scale with it on the fly.
Color functions
Less provides the following color functions:darken()
andlighten()
, which add some black or white,saturate()
anddesaturate()
, to make a color more "colorful" or more "grayscale",fadein()
andfadeout()
, to increase or reduce transparency,- and
spin()
, which modifies the hue of the color.
@borderColor:desaturate(@defaultThemeColor, 100%);
@borderColor:darken(desaturate(@defaultThemeColor, 100%), 20%);

@defaultThemeColor:spin(@lightBlue, 100);

Nested rules
When designing a complex page using CSS, you often have to chain selectors to aim a particular element in the DOM, like this: Depending on the container of theh1
elements, their style will be different if they're in the #header
or the #main
section. This syntax is fine when you have a very simple DOM, but if you have to chain 4 or 5 selectors it gets messy and visually hard to represent the hierarchy of your styles. With Less you can nest rules inside parent rules to mimic the DOM structure:
This can be a little bit confusing at the beginning but when you get used to it, this syntax helps a lot to visualise where is located the element you're working on.
There is also a super handy way to use pseudo-classes (you know, those special selectors like :hover
). Let's say we want to change our shapes' color when hovering them with the mouse, we can use nested rules combined with the &
selector:
This &
symbol represents the current selected elements. It's the equivalent of "this
" in most programming languages. Very convenient! And here is the result:

*.less
files, many editors (including Eclipse) will go crazy and do some very bad syntax coloration with nested rules. If you can deal with broken syntax highlighting it will be fine, but for most of us, it's really awful. The only thing we can do is wait for a proper plugin to bring a real Less support to our editors.
Personally, I only use nested rules for very simple one level nesting with few properties or for the &:hover
thing. But it's really up to you.
Importing
Finally, the last thing I wanted to show you is how to import Less files. It's a very good practice to separate your rules into different files instead of having a 1000 lines giant file. Importing a file into another in Less is as simple as that:
@import "colors.less";
@import "colors";
- CSS Reset or normalization,
- Colors,
- Fonts and typography,
- UI Elements,
- The main styles of the page,
- ...and any other relevant group of rules depending on your project.
Final Less code
Here is what the final code looks like (no import for such a little example): You will also notice that you can use single line comments, which is a very simple but clever addition to CSS!Conclusion
We've seen a lot of amazing features in this tutorial, and I hope it made you want to start using Less. I personally think Less is a real game changer for web development, and I cannot even consider going back to pure CSS. Less is like CSS5 in 2011! There are still very interesting things I haven't covered in this tutorial so if you're interested in learning more about Less, you should definitely check the official documentation. Oh and by the way, since Less is also open source and hosted on Github you can easily get involved, report issues, or fork it. That's all folks! Thanks for reading and feel free to share your thoughts and previous experience about Less in the comments section. I'd love to know if you enjoy it as much as I do!Posted on