cssjanus/cssjanus

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

Maintainers

Details

github.com/wikimedia/php-cssjanus

Homepage

Source

Installs: 5 655 251

Dependents: 5

Suggesters: 0

Security: 0

Stars: 2

Watchers: 20

Forks: 1

v2.3.0 2024-08-06 19:37 UTC

Requires

  • php: >=7.4.0

Requires (Dev)

Apache-2.0 c5868a543c466c994ba5bf9b3297e150105ab803

  • Roan Kattouw
  • Trevor Parscal
  • Timo Tijhof

This package is auto-updated.

Last update: 2025-06-15 23:01:27 UTC

README

Packagist

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;
}

CSS Logical Properties

We encourage and recommend use of CSS logical properties for the subset of CSS features where a native direction-aware version of a CSS property exists (be sure to check browser support for specific properties). You can, for example, set properties like margin-inline-start instead of margin-left, which the browser flips based on content direction, and work seamlessly alongside other CSS properties that CSSJanus flips instead.

Note that CSS logical properties flip based on nearest content direction and content language, whereas CSSJanus is generally configured to flip by user language and UI direction.

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.

Contribute