Short Text is a PostCSS plugin that lets you use a shorthand text property in CSS.
/* before */
section {
text: bold center uppercase dimgrey 1.25em 1.5 .05em;
}
article {
text: 1.25em * .05em;
}
/* after */
section {
font-weight: bold;
text-align: center;
text-transform: uppercase;
color: dimgrey;
font-size: 1.25em;
line-height: 1.5;
letter-spacing: .05em;
}
article {
font-size: 1.25em;
letter-spacing: .05em;
}Properties are matched into groups that may be written in any order. Once a property is matched to a group, other properties from that group must then be written before properties of another group. Asterisks indicate that an individual property in a group should be skipped. The groups include:
colorfont-style,font-variant,font-weight,font-stretchtext-decoration,text-align,text-rendering,text-transformwhite-spacefont-size,line-height,letter-spacing,word-spacing
Follow these steps to use Short Text.
Add Short Text to your build tool:
npm install postcss-short-text --save-devrequire('postcss-short-text')({ /* options */ }).process(YOUR_CSS);Add PostCSS to your build tool:
npm install postcss --save-devLoad Short Text as a PostCSS plugin:
postcss([
require('postcss-short-text')({ /* options */ })
]);Add Gulp PostCSS to your build tool:
npm install gulp-postcss --save-devEnable Short Text within your Gulpfile:
var postcss = require('gulp-postcss');
gulp.task('css', function () {
return gulp.src('./css/src/*.css').pipe(
postcss([
require('postcss-short-text')({ /* options */ })
])
).pipe(
gulp.dest('./css')
);
});Add Grunt PostCSS to your build tool:
npm install grunt-postcss --save-devEnable Short Text within your Gruntfile:
grunt.loadNpmTasks('grunt-postcss');
grunt.initConfig({
postcss: {
options: {
processors: [
require('postcss-short-text')({ /* options */ })
]
},
dist: {
src: 'css/*.css'
}
}
});Type: String
Default: null
Specifies a prefix to be surrounded by dashes before the declaration (e.g. -x-text).