README.md
# Sprockets::MediaQueryCombiner
[![Gem Version](https://badge.fury.io/rb/sprockets-media_query_combiner.png)](http://badge.fury.io/rb/sprockets-media_query_combiner)
[![Build Status](https://travis-ci.org/aaronjensen/sprockets-media_query_combiner.png)](https://travis-ci.org/aaronjensen/sprockets-media_query_combiner)
[![Coverage Status](https://coveralls.io/repos/aaronjensen/sprockets-media_query_combiner/badge.png?branch=master)](https://coveralls.io/r/aaronjensen/sprockets-media_query_combiner)
[![Code Climate](https://codeclimate.com/badge.png)](https://codeclimate.com/github/aaronjensen/sprockets-media_query_combiner)
Combines all matching media queries while compiling your assets with
sprockets/Rails asset pipeline.
If you're not using
Rails 3.1+ or Sprockets, you should use [sass-media_query_combiner](https://github.com/aaronjensen/sass-media_query_combiner)
For example:
```css
h3 {
color: orange
}
@media (max-width: 480px) {
h1 {
color: red
}
}
@media (max-width: 980px) {
h4 {
color: black
}
}
@media (max-width: 480px) {
h2 {
color: blue
}
}
```
Would end up as (except the whitespace won't be so clean):
```css
h3 {
color: orange
}
@media (max-width: 480px) {
h1 {
color: red
}
h2 {
color: blue
}
}
@media (max-width: 980px) {
h4 {
color: black
}
}
```
### Note
**This will change the order of your css, so be aware of that.** All the
`@media` queries will end up at the end of each css file in the order that
they are first encountered. In other words, if you're relying on only using
min-width or only using max-width in a specific order you'll want to be sure
define your media queries in the right order up front before you use them
randomly throughout your file.
## Installation
Requires Ruby >= 1.9.2.
Add this line to your application's Gemfile:
gem 'sprockets-media_query_combiner'
And then execute:
$ bundle
Or install it yourself as:
$ gem install sprockets-media_query_combiner
## Usage
If you're using Rails you're done. Nothing more to do.
If you're using Sprockets on its own you'll need to register the bundle processor:
```ruby
register_bundle_processor 'text/css', Sprockets::MediaQueryCombiner::Processor
```
## Contributing
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Added some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request
[![Bitdeli Badge](https://d2weczhvl823v0.cloudfront.net/aaronjensen/sprockets-media_query_combiner/trend.png)](https://bitdeli.com/free "Bitdeli Badge")