README

CSSJanus

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

Usage

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:

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

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

Who uses CSSJanus?

Wikimedia Foundation, the non-profit behind Wikipedia and other free knowledge projects.
Used in MediaWiki, on Wikipedia, and other projects.

Port

This is a PHP port of the Node.js implementation of CSSJanus, and was originally based on a Google project.

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.

Upstream releases will be ported here.

cssjanus / cssjanus

Maintainers

Details