Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cssjanus/cssjanus
↔️ Convert CSS between left-to-right and right-to-left. Mirror of https://gerrit.wikimedia.org/g/mediawiki/libs/node-cssjanus/. Contribute via https://www.mediawiki.org/wiki/Developer_account.
https://github.com/cssjanus/cssjanus
css cssjanus javascript stylesheets swap
Last synced: 3 months ago
JSON representation
↔️ Convert CSS between left-to-right and right-to-left. Mirror of https://gerrit.wikimedia.org/g/mediawiki/libs/node-cssjanus/. Contribute via https://www.mediawiki.org/wiki/Developer_account.
- Host: GitHub
- URL: https://github.com/cssjanus/cssjanus
- Owner: wikimedia
- License: apache-2.0
- Created: 2012-06-28T17:15:35.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2023-10-24T23:56:19.000Z (about 1 year ago)
- Last Synced: 2023-12-19T18:54:24.169Z (11 months ago)
- Topics: css, cssjanus, javascript, stylesheets, swap
- Language: JavaScript
- Homepage: https://cssjanus.github.io
- Size: 486 KB
- Stars: 198
- Watchers: 10
- Forks: 52
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: History.md
- License: LICENSE.txt
- Code of conduct: CODE_OF_CONDUCT.md
- Authors: AUTHORS.txt
Awesome Lists containing this project
README
[](https://www.npmjs.com/package/cssjanus)
[](https://qunitjs.com/)
# CSSJanus
Convert CSS stylesheets between left-to-right and right-to-left.
Based the original [Google project](https://code.google.com/p/cssjanus/).
See **[Interactive demo](https://cssjanus.github.io)**.
## Install
```sh
npm install cssjanus
```
## Usage
```javascript
var cssjanus = require( 'cssjanus' );
var rtlCss = cssjanus.transform( ltrCss );
```
```
transform( string css [, Object options ] ) : string
```
Parameters:
* `css` Stylesheet to transform
* `options`: Options object (optional)
* `options.transformDirInUrl` (Boolean): Transform directions in URLs, such as `ltr` to `rtl`. Default: `false`.
* `options.transformEdgeInUrl` (Boolean): Transform edges in URLs, such as `left` to `right`. Default: `false`.
### 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;
}
```
## Integrations
* **[css](https://www.npmjs.com/package/css)** parser: [rtl-converter](https://github.com/HosseinAlipour/rtl-converter).
* **Grunt**: [grunt-cssjanus](https://gerrit.wikimedia.org/g/mediawiki/tools/grunt-cssjanus).
* **PHP** port: [php-cssjanus](https://gerrit.wikimedia.org/g/mediawiki/libs/php-cssjanus/).
* **Gulp**: [gulp-cssjanus](https://github.com/tomyam1/gulp-cssjanus).
* **PostCSS**: [postcss-cssjanus](https://www.npmjs.com/package/postcss-janus).
* **styled-components**: [styled-components-rtl](https://www.npmjs.com/package/styled-components-rtl).
* **Stylis**: [stylis-plugin-rtl](https://www.npmjs.com/package/stylis-plugin-rtl).
* **webpack**: [cssjanus-webpack](https://www.npmjs.com/package/@mooeypoo/cssjanus-webpack), [webpack-arabic-css](https://www.npmjs.com/package/webpackarabiccssplugin).
## Who uses CSSJanus?
* **[Wikimedia Foundation](https://www.wikimedia.org/)**, the non-profit behind Wikipedia and other free knowledge projects. Used as part of [MediaWiki](https://www.mediawiki.org/wiki/MediaWiki) and [VisualEditor](https://gerrit.wikimedia.org/g/VisualEditor/VisualEditor) on [Wikipedia](https://ar.wikipedia.org/), and [more](https://doc.wikimedia.org/).
* **[WordPress](https://wordpress.org/)**, a free and open-source content management system. Used for the interface of wp-admin and the default yearly themes.
* **[styled-components](https://styled-components.com/)**, an ecosystem of visual primitives. Its RTL support is powered by CSSJanus.
* **[AdminLTE](https://adminlte.io/)**, an open-source admin dashboard and control panel theme. See
[AdminLTE-RTL](https://github.com/mmdsharifi/AdminLTE-RTL).
## See also
* [Interactive demo](https://cssjanus.github.io)
## Contribute
* Issue tracker:
* Source code:
* Submit patches via Gerrit: