# rails-sass-images

**Repository Path**: mirrors_ai/rails-sass-images

## Basic Information

- **Project Name**: rails-sass-images
- **Description**: Sass functions and mixins to inline images and get images size
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-01-26
- **Last Updated**: 2025-08-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Rails Sass Images [![Build Status](https://travis-ci.org/ai/rails-sass-images.svg)](https://travis-ci.org/ai/rails-sass-images)

Sass functions and mixins to inline images and get images size:

```sass
.icon
  +image-size("icon.png")
  background: inline("icon.png")

.icon-wrap
  width: image-width("icon.png") + 6px
  height: image-height("icon.png")
```

with HiDPI (Retina) support:

```sass
.icon
  +hidpi-inline("icon.png")

.background
  +hidpi-image("big-image.jpg")
```

and fonts support:

```sass
@font-face
  font-family: "MyFont"
  src: inline("my.woff") format('woff')
```

<a href="https://evilmartians.com/?utm_source=rails-sass-images">
<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54">
</a>

## Features

Instead of Compass, Rails Sass Images has:

* HiDPI (Retina) support.
* Full Assets Pipeline support.
* Useful shortcuts.
* More file types support.
* Smaller and cleaner code.

If you still need Compass for CSS 3 prefixes,
see [Autoprefixer](https://github.com/ai/autoprefixer).

## Usage

### Ruby on Rails

Add gem to your Rails `Gemfile`:

```ruby
gem "rails-sass-images"
```

and import mixins in your `application.sass`:

```sass
@import "rails-sass-images"
```

### Sprockets

You can use Rails Sass Images with plain Ruby application with Sprockets.
Just install in to Sprockets environment:

```ruby
require 'rails-sass-images'

RailsSassImages.install(sprockets_env)
```

and import mixins in your Sass files:

```sass
@import "rails-sass-images"
```

### Other

You can use Rails Sass Images without Sprockets. Just set dir to load assets:

```ruby
require 'rails-sass-images'

RailsSassImages.load_from = './images/'
```

By default, load dir will be current dir `.`.