Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/francoisromain/postcss-button
A PostCSS plugin to create buttons.
https://github.com/francoisromain/postcss-button
css postcss postcss-button postcss-plugins
Last synced: about 5 hours ago
JSON representation
A PostCSS plugin to create buttons.
- Host: GitHub
- URL: https://github.com/francoisromain/postcss-button
- Owner: francoisromain
- License: mit
- Created: 2016-04-24T23:05:11.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2023-01-03T15:14:11.000Z (almost 2 years ago)
- Last Synced: 2024-10-14T11:39:08.296Z (about 1 month ago)
- Topics: css, postcss, postcss-button, postcss-plugins
- Language: JavaScript
- Homepage: http://francoisromain.github.io/postcss-button
- Size: 1.53 MB
- Stars: 5
- Watchers: 2
- Forks: 0
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# postcss-button
[![npm version][npm-img]][npm] [![Build Status][ci-img]][ci] [![Dependency Status][dep-img]][dep]
[](https://nodei.co/npm/postcss-button/)
[francoisromain.github.io/postcss-button][github.io]
A [PostCSS] plugin to create buttons.
[github.io]: http://francoisromain.github.io/postcss-button
[postcss]: https://github.com/postcss/postcss
[ci-img]: https://travis-ci.org/francoisromain/postcss-button.svg
[ci]: https://travis-ci.org/francoisromain/postcss-button
[npm-img]: https://badge.fury.io/js/postcss-button.svg
[npm]: https://badge.fury.io/js/postcss-button
[dep-img]: https://david-dm.org/francoisromain/postcss-button.svg
[dep]: https://david-dm.org/francoisromain/postcss-button
---
This plugin outputs a lot of the repetitive css code necessary to create clean buttons. It also uses `box-shadow` to create borders which does not break the vertical rhythm.
---
## Examples
There are two ways to declare a button:
#### With specific declarations
```css
.my-button-class {
/* short-hand syntax example */
/* color: default | active | hover */
button-color: skyblue white white;
/* background-color: default | active | hover */
button-background: white skyblue silver;
/* border: size | default | active | hover */
button-border: 4px skyblue skyblue silver;
/* classes: active class name | disabled class name | apply classes and pseudo classes to the parent selector */
button-class: active disabled true;
}
```
#### With a configuration
```css
@button my-button-name {
/* detailed-syntax example */
/* color */
button-color: orange;
button-color-active: white;
button-color-hover: white;
/* background-color */
button-background-color: white;
button-background-color-active: silver;
button-background-color-hover: orange;
/* border */
button-border-width: 1px;
button-border-color: silver;
button-border-color-active: silver;
button-border-color-hover: orange;
/* classes */
button-class-active: active;
button-class-disabled: disabled;
button-class-parent: true;
}
```
```css
.my-button-class {
button: my-button-name;
}
```
01: [input](https://github.com/francoisromain/postcss-button/blob/gh-pages/test/src/01.css), [output](https://github.com/francoisromain/postcss-button/blob/gh-pages/test/dist/01.css), [markup](https://github.com/francoisromain/postcss-button/blob/gh-pages/test/01.html), [demo](https://francoisromain.github.io/postcss-button/test/01.html)
02: [input](https://github.com/francoisromain/postcss-button/blob/gh-pages/test/src/02.css), [output](https://github.com/francoisromain/postcss-button/blob/gh-pages/test/dist/02.css), [markup](https://github.com/francoisromain/postcss-button/blob/gh-pages/test/02.html), [demo](https://francoisromain.github.io/postcss-button/test/02.html)
---
## Installation
Install the [npm package](https://www.npmjs.com/package/postcss-button):
```bash
npm install --save-dev postcss postcss-button
```
Require the PostCSS plugin:
```js
postcss([require("postcss-button")]);
```
See [PostCSS docs](https://github.com/postcss/postcss#usage) to setup with Gulp, Grunt, Webpack, npm scripts…
---
## Usage
#### With a configuration (optional)
```css
@button ([name]) {
/* name is a custom identifier to use multiple configurations.
If no name is provided, the default settings are overwritten */
[button-css-rules…]
}
.my-class {
button: [name];
/* use 'default' to apply the default settings */
}
```
#### Without a configuration
```css
.my-class {
[button-css-rules…]
}
```
## Css rules
#### Color
```css
/* Button text color when active */
button-color-active: [color];
/* button text color on hover */
button-color-hover: [color];
/* short-hand syntax */
button-color: [color] ([color-active]) ([color-hover]);
```
#### Background color
```css
/* button background color when active */
button-background-active: [color];
/* button background color on hover */
button-background-hover: [color];
/* short-hand syntax */
button-background: [background-color] ([background-color-active])
([background-color-hover]);
```
#### Border
```css
/* width and units of the border */
button-border-width: [width];
/* color of the border */
button-border-color: [color];
/* color of the border when active */
button-border-color-active: [color];
/* color of the border on hover */
button-border-color-hover: [color];
/* short-hand syntax */
button-border: [border-width] ([border-color]) ([border-color-active])
([border-color-hover]);
```
#### Classes
```css
/* class name to apply the active styles */
button-class-active: [class-name];
/* class name to apply the disabled styles */
button-class-disabled: [class-name];
/* apply the classes and pseudo elements
to the parent element in the selector chain
if it exists. (default to false)
(See test 07 and 08) */
button-class-parent: [boolean];
/* short-hand syntax */
button-class: [active] ([disabled]) ([parent]);
```
Missing declarations fallback to the [_default_ settings](https://github.com/francoisromain/postcss-button/blob/c5bf5e690f12bda8a2a353392dae50e22897e3b3/src/index.js#L93-L106).