summaryrefslogtreecommitdiff
path: root/www/wiki/vendor/cssjanus/cssjanus/README.md
blob: 9fad19461529dd3e1f698f51f62e13d5eafc68ac (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.com/cssjanus/php-cssjanus.svg?branch=master)](https://travis-ci.com/cssjanus/php-cssjanus) [![Packagist](https://img.shields.io/packagist/v/cssjanus/cssjanus.svg?style=flat)](https://packagist.org/packages/cssjanus/cssjanus) [![Coverage Status](https://coveralls.io/repos/github/cssjanus/php-cssjanus/badge.svg?branch=master)](https://coveralls.io/github/cssjanus/php-cssjanus?branch=master)

# 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.