A Rails (Sprockets) wrapper on CSS Modules (respective the CSS Module Loader Core).
It is a minimal and slightly naïve implementation at the moment (for example calling node
command directly via command-line). Pull requests are more than welcome.
A current drawback of an implementation of CSS Modules in Rails is, that it makes views dependent on stylesheets. Currently there is no way how to include digests of relevant stylesheet files with Rails partial digests. This in turn renders this solution unusable in connection with so called russian-doll-caching, since changes to stylesheet assets won't bust the view cache. Ideas and solutions welcome.
Add this line to your application's Gemfile:
gem 'cssm-rails'
And then execute:
$ bundle
Or install it yourself as:
$ gem install cssm-rails
This gem requires Node to be installed.
Files with *.cssm
, *.sassm
, *.scssm
will be processed for CSS modules.
Files with *.css
, *.sass
, *.scss
extensions will remain unchanged.
/* common.cssm */
.bg { /* this class will be transformed to `.common_bg_HASH` */ };
/* event.cssm */
.title {
composes: bg from './common.cssm';
/* this class will be transformed to `.event_title_HASH`,
the outcome of the `cssm` helper will then be `event_title_HASH common_bg_HASH`
*/
}
The cssm
helper outputs css module classes:
cssm(file_name, class_name)
For example:
cssm('event', 'title') # => 'event_title_HASH common_bg_HASH'
The cssms
outputs class selector:
cssms('event', 'title') # => '.event_title_HASH.common_bg_HASH'
These are helpful to generate module classes in views:
<p class="<%= cssm 'event', 'title' %>"> # => <p class="event_title_HASH common_bg_HASH">
event title
</p>
And selectors in JS:
$("<%= cssms 'event', 'title' %>"); // => $('.event_title_HASH.common_bg_HASH')
After checking out the repo, run bin/setup
to install dependencies. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
. To release a new version, update the version number in version.rb
, and then run bundle exec rake release
, which will create a git tag for the version, push git commits and tags, and push the .gem
file to rubygems.org.
bundle exec rake vendor_build
Bug reports and pull requests are welcome on GitHub at https://github.com/css-modules/cssm-rails.
The gem is available as open source under the terms of the MIT License.