README.md
No OneTemporary
Actions

Size

1 KB

Referenced Files

None

Subscribers

None

README.md
View Options

	[![Packagist](https://img.shields.io/packagist/v/cssjanus/cssjanus.svg?style=flat)](https://packagist.org/packages/cssjanus/cssjanus)

	# CSSJanus

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

	## Usage

	```php
	transform( string $css, bool $swapLtrInURL = false, bool $swapLeftInURL = false ) : string
	```

	Parameters;

	* ``$css`` (string) Stylesheet to transform.
	* ``$swapLtrInURL`` (boolean) Swap `ltr` to `rtl` direction in URLs.
	* ``$swapLeftInURL`` (boolean) Swap `left` and `right` edges in URLs.

	Example:

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

	### Preventing flipping

	If a rule is not meant to be flipped by CSSJanus, use a `/* @noflip */` comment to protect the rule.

	```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 logic or test cases of it, should be submitted upstream
	at <https://github.com/cssjanus/cssjanus>.

	CSSJanus was originally a [Google project](http://code.google.com/p/cssjanus/).

	## Contribute

	* Issue tracker: <https://phabricator.wikimedia.org/tag/cssjanus/>
	* Source code: <https://gerrit.wikimedia.org/g/mediawiki/libs/php-cssjanus>
	* Submit patches via Gerrit: <https://www.mediawiki.org/wiki/Developer_account>