css-modules 0.3.1

CSS Modules with a macro for convenience.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# CSS Modules

[![Build Status](https://travis-ci.org/anarchistmae/css-modules-rs.svg?branch=master)](https://travis-ci.org/anarchistmae/css-modules-rs)
[![Latest Version](https://img.shields.io/crates/v/css-modules.svg)](https://crates.io/crates/css-modules)
[![Documentation](https://docs.rs/css-modules/badge.svg)](https://docs.rs/css-modules)
[![Minimum rustc version](https://img.shields.io/badge/rustc-1.31+-yellow.svg)](https://gitlab.com/anarchistmae/css-modules-rs#versions)
[![License:MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
![lines of code](https://tokei.rs/b1/gitlab/anarchistmae/css-modules-rs)

The [CSS Modules] project defines CSS Modules as:

> A **CSS Module** is a CSS file in which all class names and animation names are scoped locally by default.

This implementation is however currently immature and what parsing we do have is very naively implemented. As a result, currently only class names are locally scoped and the following work is in progress:

- Locally scoped animation names
- Inlining `url()` and `@import` statements

## Usage

A `Module` can be constructed manually:

```rust
use css_modules::Module;

let css = Module::new("my_module", ".myStyles {}");
```

Or if you would prefer to use automatic module naming based on source code, through a macro:

```rust
use css_modules::*;

let css = css_module!(".myStyles {}");
```

The same as above, but from a file relative to the current source file:

```rust
use css_modules::*;

let css = include_css_module!("test.css");
```

Which is the equivelent of doing:

```rust
use css_modules::*;

let css = css_module!(include_str!("test.css"));
```

For more detailed examples, look in the `examples/` directory.

[CSS Modules]: https://github.com/css-modules/css-modules