Hayden Library - PQ7123.W6 E88 2018

Australia. Parliament. House of Representatives. Standing Committee on Agriculture and Water Resources, author

Australia. Parliament. House of Representatives. Standing Committee on the Environment and Energy, author, issuing body

Shkul, Minna, author

Did you know that you can build your own CSS preprocessor with Node.js libraries? They can be used alongside established preprocessors like Sass, and are useful for defining tasks beyond preprocessing.

Libraries like Rework and PostCSS let you create and assemble an arbitrary collection of plugins that can inspect or manipulate CSS.

At the time of writing, Twitter uses Rework to perform various tasks against our CSS source code for twitter.com.

Creating a CSS preprocessor with Rework

At its core, Rework is a module that accepts a string of CSS, produces a CSS abstract syntax tree (AST), and provides an API for manipulating that AST. Plugins are functions that have access to the AST and a Rework instance. Rework lets you chain together different plugins and generate a string of new CSS when you’re done.

The source string is passed into the rework function and each plugin is applied with .use(fn). The plugins transform the data in the AST, and .toString() generates the new string of CSS.

Below is an example of a custom preprocessor script using Rework and Autoprefixer. It’s a simplified version of the transformation step we use for twitter.com’s CSS.

var autoprefixer = require('autoprefixer');
var calc = require('rework-calc');
var rework = require('rework');
var vars = require('rework-vars')();

var css = fs.readFileSync('./css/main.css', 'utf-8');

css = rework(css)
  .use(vars)
  .use(calc)
  .toString();

css = autoprefixer().process(css);

fs.writeFileSync('./build/bundle.css', css)

The script runs rework-vars, rework-calc, and then passes the CSS to Autoprefixer (which uses PostCSS internally) to handle the addition of any necessary vendor prefixes.

rework-vars provides a limited subset of the features described in the W3C-style CSS custom property spec. It’s not a polyfill!

Variables can be declared as custom CSS properties on the :root element, prefixed with --. Variables are referenced with the var() function, taking the name of a variable as the first argument and an optional fallback as the second.

For example, this source:

:root {
  --width-button: 200px;
}

.button {
  width: var(--width-button);
}

yields:

.button {
  width: 200px;
}

There are many different Rework plugins that you can use to create a custom preprocessor. A more complete list is available on npm. In order to limit the chances of long-term divergence between our source code and native CSS, I’ve chosen to stick fairly closely to features that are aligned with future additions to native CSS.

Creating your own Rework plugin

Rework plugins are functions that inspect or mutate the AST they are provided. Below is a plugin that rewrites the value of any font-family property to sans-serif.

module.exports = function plugin(ast, reworkInstance) {
  ast.rules.forEach(function (rule) {
    if (rule.type != 'rule') return;

    rule.declarations.forEach(function (declaration, index) {
      if (declaration.property == 'font-family') {
        declaration.value = 'sans-serif';
      }
    });
  });
};

Rework uses css-parse to create the AST. Unfortunately, both projects are currently lacking comprehensive documentation of the AST, but it’s not difficult to piece it together yourself.

Beyond preprocessing

Since Rework and PostCSS expose an AST and provide a plugin API, they can be used for other CSS tasks, not just preprocessing.

At Twitter, our CSS build pipeline allows you to perform custom tasks at 2 stages of the process: on individual files and on generated bundles. We use Rework at both stages.

Individual files are tested with rework-suit-conformance to ensure that the SUIT-style CSS for a component is properly scoped.

/** @define MyComponent */

:root {
  --property-MyComponent: value;
}

.MyComponent {}

Bundles are preprocessed as previously described, and also tested with rework-ie-limits to ensure that the number of selectors doesn’t exceed IE 8/9’s limit of 4095 selectors per style sheet.

Other tasks you can perform include generating RTL style sheets (e.g., css-flip) and extracting detailed information about the perceived health of your CSS (e.g., the number of different colours used, duplicate selectors, etc.).

Hopefully this has given you a small glimpse into some of the benefits and flexibility of using these tools to work with CSS.

Schoner, Bernd

Duening, Thomas N

Geraldi, Joana G., 1979- author

Deprez, Frank Lekanne

Interview with Andreas Walther, PhD, author of Association of Testosterone Treatment With Alleviation of Depressive Symptoms in Men: A Systematic Review and Meta-analysis

Interview with Pim Cuijpers, PhD, author of Effectiveness and Acceptability of Cognitive Behavior Therapy Delivery Formats in Adults With Depression: A Network Meta-analysis

Interview with Emma B. Holliday, MD, author of Women’s Representation Among Lead Investigators of Clinical Trials in Oncology

Available Sessions for this Seminar:

ipwebinar.aspx?tab=1&smid=1710, February 10, 2015

Online Resource

Rotch Library - KF3060.1.R54 2019

Rotch Library - KF5709.3.H35 M35 2018

Dewey Library - K3778.L39 2018

Australia. Parliament. House of Representatives. Standing Committee on Infrastructure, Transport and Cities, author, issuing body

As the founder of multiple biotech firms, C&EN's guest editor has learned a thing or two about the challenges and triumphs of starting a company. We asked her to share her best advice for budding academic entrepreneurs

Barred as a woman from becoming a brewer in India, Mazumdar-Shaw instead founded biotech firm Biocon and today focuses on affordable health care

Dozens of women lead CRISPR-based projects worldwide. Here are a few who've built start-ups around the technology

With guest editor Jennifer Doudna, CRISPR pioneer

The coronavirus crisis has sent U.S. unemployment surging to 14.7%, a level last seen when the country was in the throes of the Depression and President Franklin D. Roosevelt was assuring Americans that the only thing to fear was fear itself.

The coronavirus crisis has sent US unemployment surging to 14.7%, a level last seen when the country was in the throes of the Depression and President Franklin D

Heidelberg : Springer Medizin, 2007

Boston, MA : Springer US, 1999

According to the report by Centre for Economic Policy Research (CEPR), a rapid increase in the volume of data requires auditors to be equipped with the latest available technological tools to analyse a much higher volume of data in their audits than previously required.

Online Resource

Rotch Library - HT151.U73 2018

Cham : Springer, 2020

Online Resource

Dewey Library - LC1085.B85 2014

In a step towards conducting examinations for the current academic session, Delhi University set up a “working group” to review preparedness and take

The two sides agreed to maintain communication going forward, the Chinese commerce ministry said in its statement.

The figures are stark evidence of the damage the coronavirus has done to a now-shattered economy

Pooja Bhatt's irrepressible cuteness, Rekha's amusing cartoon, Asha Bhosle's super songstress power, Akshay Kumar's sparkling white sneakers and shaved chest find a mention in Sukanya Verma's weekly column.

PHD Chamber of Commerce webinar discusses women's roles as leaders and entrepreneurs

Interview with Laura Weiss Roberts, MD, MA, author of Understanding Depression and Distress Among Medical Students

Interview with John H. Krystal, MD, author of Adjunctive Risperidone Treatment for Antidepressant-Resistant Symptoms of Chronic Military Service-Related PTSD

Interview with David C. Mohr, PhD, author of Effect of Telephone-Administered vs Face-to-face Cognitive Behavioral Therapy on Adherence to Therapy and Depression Outcomes Among Primary Care Patients: A Randomized Trial

Interview with James A. Blumenthal, PhD, author of Effects of Exercise Training on Depressive Symptoms in Patients With Chronic Heart Failure: The HF-ACTION Randomized Trial

Interview with Laura P. Richardson, MD, MPH, author of Collaborative Care for Adolescents With Depression in Primary Care

Interview with Krista F. Huybrechts, MS, PhD, author of Antidepressant Use Late in Pregnancy and Risk of Persistent Pulmonary Hypertension of the Newborn