README.md

cssobj-less

Using LESS as JS Object, based on cssobj

Bootstrap in JS Demo - Github Repo

Install

npm i -g cssobj-converter
npm i futurist/cssobj-less

Usage

Small Demo

1. Write LESS in folder as your normal way:

file: lessfiles/page.less

@base: #f938ab;
@width: 100px;
@padding: 10px;

.box-shadow(@style, @alpha: 50%) {
  box-shadow: @style rgba(0, 0, 0, @alpha);
}
.box {
  width: (@width * 2);
  padding: @padding;
  color: saturate(@base, 5%);
  border-color: lighten(@base, 30%);
  div { .box-shadow(0 0 5px, 0.3) }
}

2. Convert LESS to JS using cssobjconv

cssobjconv -d lessfiles
# or watch mode:
# cssobjconv -d lessfiles -w

Notice: you should add a variable, e.g. var page={} manually

3. Include lessfiles/page.less.js into your html, with dist/lessobj.js

<script src="dist/lessobj.js"></script>
<script src="lessfiles/page.less.js"></script>
<script>
var result = lessobj(page)
</script>

4. Enjoy LESS in JS! and you can update @vars as below:

page.$vars.base = 'blue'
result.update()

Any @vars can be changed dynamically!

Plus

You can use selector:extend(.abc), to extend the rule.

Also, you can use $test as key to dynamically enable/disable the rule.

Features NOT Implemented

http://lesscss.org/features/#features-overview-feature-escaping

http://lesscss.org/features/#features-overview-feature-namespaces-and-accessors

http://lesscss.org/features/#variables-feature-variable-interpolation

http://lesscss.org/features/#mixin-guards-feature

http://lesscss.org/features/#css-guards-feature

As the base of cssobj, some of the feature may implemented differently, you should use this lib as normal way as possible.

Copyright

James Yang (c) 2016 MIT