summaryrefslogtreecommitdiff
path: root/vendor/cssjanus/cssjanus/README.md
blob: 597ef211c2abc7b5bbf75779e6fbbcc7c7f52805 (plain)
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
[![Build Status](https://travis-ci.org/cssjanus/php-cssjanus.svg?branch=master)](https://travis-ci.org/cssjanus/php-cssjanus) [![Latest Stable Version](https://poser.pugx.org/cssjanus/cssjanus/v/stable.svg)](https://packagist.org/packages/cssjanus/cssjanus)

# CSSJanus

Convert CSS stylesheets between left-to-right and right-to-left.

## Basic usage

```php
$rtlCss = CSSJanus::transform( $ltrCss );
```

## Advanced usage

``transform( $css, $swapLtrRtlInURL = false, $swapLeftRightInURL = false )``

* ``$css`` (string) Stylesheet to transform
* ``$swapLtrRtlInURL`` (boolean) Swap 'ltr' and 'rtl' in URLs
* ``$swapLeftRightInURL`` (boolean) Swap 'left' and 'right' in URLs

### Preventing flipping

Use a ```/* @noflip */``` comment to protect a rule from being changed.

```css
.rule1 {
  /* Will be converted to margin-right */
  margin-left: 1em;
}
/* @noflip */
.rule2 {
  /* Will be preserved as margin-left */
  margin-left: 1em;
}
```

## Port

This is a PHP port of the Node.js implementation of CSSJanus.

Feature requests and bugs related to the actual CSS transformation or test
cases of it, should be submitted upstream at
<https://github.com/cssjanus/cssjanus>.

Upstream releases will be ported here.