Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/isuke/postcss-ghost-utils
PostCSS plugin to add helper utils for your CSS
https://github.com/isuke/postcss-ghost-utils
css postcss postcss-plugin
Last synced: 12 days ago
JSON representation
PostCSS plugin to add helper utils for your CSS
- Host: GitHub
- URL: https://github.com/isuke/postcss-ghost-utils
- Owner: isuke
- License: mit
- Created: 2018-09-18T12:37:23.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2023-02-09T18:07:14.000Z (almost 2 years ago)
- Last Synced: 2024-12-07T21:15:09.138Z (about 1 month ago)
- Topics: css, postcss, postcss-plugin
- Language: JavaScript
- Size: 186 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# postcss-ghost-utils [](https://github.com/isuke/postcss-ghost-utils/actions/workflows/main.yml) [](https://www.npmjs.com/package/postcss-ghost-utils) [](https://github.com/isuke/git-consistent)
[](https://nodejs.org/ja/download/releases/)
[](https://nodejs.org/ja/download/releases/)
[](https://nodejs.org/ja/download/releases/)
postcss-ghost-utils is a [PostCSS](https://github.com/postcss/postcss) plugin.
This plugin can give you useful css syntax.
**It is NOT include old css technique (ex. clearfix).**
## Usage
### Install
```sh
$ npm install -D postcss postcss-ghost-utils
# or
$ yarn add -D postcss postcss-ghost-utils
```
`.postcss.config.js`
```js
module.exports = {
plugins: [
require('postcss-ghost-utils')
]
}
```
## Rule List
### font-size-line-height
Input Output
```css
.one {
@ghost font-size-line-height(16px, 2px);
}
```
```css
.one {
font-size: 16px;
line-height: calc(16px + 2px * 2);
}
```
### new-line
Input Output
```css
.one {
@ghost new-line;
}
```
```css
.one {
white-space: pre-wrap;
word-wrap: break-word;
}
```
### truncate
Input Output
```css
.one {
@ghost truncate;
}
.two {
@ghost truncate('-');
}
```
```css
.one {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.two {
white-space: nowrap;
overflow: hidden;
text-overflow: '-';
}
```
### margin-left-right
Input Output
```css
.one {
@ghost margin-left-right(16px);
}
```
```css
.one {
margin-left: 16px;
margin-right: 16px;
}
```
### margin-top-bottom
Input Output
```css
.one {
@ghost margin-top-bottom(16px);
}
```
```css
.one {
margin-top: 16px;
margin-bottom: 16px;
}
```
### padding-left-right
Input Output
```css
.one {
@ghost padding-left-right(16px);
}
```
```css
.one {
padding-left: 16px;
padding-right: 16px;
}
```
### padding-top-bottom
Input Output
```css
.one {
@ghost padding-top-bottom(16px);
}
```
```css
.one {
padding-top: 16px;
padding-bottom: 16px;
}
```
### border-left-right
Input Output
```css
.one {
@ghost border-left-right(2px solid black);
}
```
```css
.one {
border-left: 2px solid black;
border-right: 2px solid black;
}
```
### border-top-bottom
Input Output
```css
.one {
@ghost border-top-bottom(2px solid black);
}
```
```css
.one {
border-top: 2px solid black;
border-bottom: 2px solid black;
}
```
### border-top-radius
Input Output
```css
.one {
@ghost border-top-radius(4px);
}
.two {
@ghost border-top-radius(4px 2px);
}
```
```css
.one {
border-top-left-radius: 4px;
border-top-right-radius: 4px;
}
.two {
border-top-left-radius: 4px 2px;
border-top-right-radius: 4px 2px;
}
```
### border-bottom-radius
Input Output
```css
.one {
@ghost border-bottom-radius(4px);
}
.two {
@ghost border-bottom-radius(4px 2px);
}
```
```css
.one {
border-bottom-left-radius: 4px;
border-bottom-right-radius: 4px;
}
.two {
border-bottom-left-radius: 4px 2px;
border-bottom-right-radius: 4px 2px;
}
```
### border-left-radius
Input Output
```css
.one {
@ghost border-left-radius(4px);
}
.two {
@ghost border-left-radius(4px 2px);
}
```
```css
.one {
border-top-left-radius: 4px;
border-bottom-left-radius: 4px;
}
.two {
border-top-left-radius: 4px 2px;
border-bottom-left-radius: 4px 2px;
}
```
### border-right-radius
Input Output
```css
.one {
@ghost border-right-radius(4px);
}
.two {
@ghost border-right-radius(4px 2px);
}
```
```css
.one {
border-top-right-radius: 4px;
border-bottom-right-radius: 4px;
}
.two {
border-top-right-radius: 4px 2px;
border-bottom-right-radius: 4px 2px;
}
```
### size
Input Output
```css
.one {
@ghost size(160px);
}
.two {
@ghost size(160px, 240px);
}
```
```css
.one {
width: 160px;
height: 160px;
}
.two {
width: 160px;
height: 240px;
}
```
### circle
Input Output
```css
.one {
@ghost circle(200px);
background-color: #ff0000;
border: 10px solid #ffffff;
}
```
```css
.one {
width: 200px;
height: 200px;
border-radius: 50%;
background-color: #ff0000;
border: 10px solid #ffffff;
}
```
### transition
Input Output
```css
.one {
@ghost transition(100ms, ease-in, color);
}
.two {
@ghost transition(100ms, ease-in, color, background-color, border-color);
}
```
```css
.one {
transition: 100ms ease-in color;
}
.two {
transition: 100ms ease-in color, 100ms ease-in background-color, 100ms ease-in border-color;
}
```
## Experimental Rule List
The following rules may not work with not pure css ex) LESS, SASS.
### all-buttons
Input Output
```css
@ghost all-buttons {
background-color: transparent;
border: none;
cursor: pointer;
outline: 0;
}
@ghost all-buttons(hover) {
transform: translateY(-2px);
box-shadow: 0 2px 2px rgba(0, 0, 0, 0.2);
}
@ghost all-buttons(active) {
transform: none;
box-shadow: none;
}
@ghost all-buttons(focus) {
transform: translateY(-2px);
box-shadow: 0 2px 2px rgba(0, 0, 0, 0.2);
}
```
```css
button, [type='button'], [type='reset'], [type='submit'] {
background-color: transparent;
border: none;
cursor: pointer;
outline: 0;
}
button:hover, [type='button']:hover, [type='reset']:hover, [type='submit']:hover {
transform: translateY(-2px);
box-shadow: 0 2px 2px rgba(0, 0, 0, 0.2);
}
button:active, [type='button']:active, [type='reset']:active, [type='submit']:active {
transform: none;
box-shadow: none;
}
button:focus, [type='button']:focus, [type='reset']:focus, [type='submit']:focus {
transform: translateY(-2px);
box-shadow: 0 2px 2px rgba(0, 0, 0, 0.2);
}
```