Code Monkey home page Code Monkey logo

postcss-pseudo-classes's Introduction

PostCSS Pseudo Classes

PostCSS plugin to automatically add in companion classes where pseudo-selectors are used. This allows you to add the class name to force the styling of a pseudo-selector, which can be really helpful for testing or being able to concretely reach all style states.

Example:

.some-selector:hover {
  text-decoration: underline;
}

yields

.some-selector:hover,
.some-selector.\:hover {
  text-decoration: underline;
}

Credits

This plugin is a port of rework-pseudo-classes written by Alex Sexton.

Installation

$ npm install postcss-pseudo-classes

Options

require('postcss-pseudo-classes')({
  // default contains `:root`.
  blacklist: [],

  // (optional) create classes for a restricted list of selectors
  // N.B. the colon (:) is optional
  restrictTo: [':nth-child', 'hover'],

  // default is `false`. If `true`, will output CSS
  // with all combinations of pseudo styles/pseudo classes.
  allCombinations: true,

  // default is `true`. If `false`, will generate
  // pseudo classes for `:before` and `:after`
  preserveBeforeAfter: false

  // default is `\:`. It will be added to pseudo classes.
  prefix: '\\:'
});

Edge cases

  • This plugin escapes parenthesis so :nth-child(5) would look like .class.\:nth-child\(5\) and can be used as a regular class: <button class=":nth-child(5)">howdy</button>.
  • Pseudo-selectors with two colons are ignored entirely since they're a slightly different thing.
  • Chained pseudo-selectors just become chained classes: :focus:hover becomes .\:focus.\:hover.

Tests

$ npm test

Contributors

@ai

License

(MIT)

postcss-pseudo-classes's People

Contributors

ai avatar giuseppeg avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

postcss-pseudo-classes's Issues

Pseudo-selectors?

Hi,
I really like this package, we recently integrated it for generating a state table, showing links and inputs in various states. I stumbled upon an article about considering contrast for various scenarios (https://css-tricks.com/a-whole-bunch-of-places-to-consider-contrast-in-a-single-paragraph/) lately, so I tried to integrate ::selection in this state table, too, using your package. As this did not work, I checked the docs, source code and pull requests, so I'm now aware, that pseudo-selectors are excluded on purpose (I probably could have also guessed it from the name ๐Ÿ™„ ), but I am curious about the background, why this decision was made and if you could consider some exceptions, like mentioned ::selection, or e.g. ::placeholder?

Support appending pseudoclasses through a wrapper

When designing reusable components, I prefer not to expose classNames as a prop, as it breaks encapsulation and encourages the modification of a finalized design.

It would be great if the following approach worked:

<!-- "hover" may also be called "hover-all" -->
<div class="hover">
  <custom-button>Iโ€™m hovered</custom-button>
</div>

Blacklisted pseudo class not excluded correctly

Hi,

I encountered a problem while using Angular:

The :host pseudo class is in the blacklist configuration.

The following element is given:

<my-button class="vairant"></mybutton>

where <my-button> is the host tag and could be styled with :host {...}

Imagine the following scss as used in Angular

:host {
    &.variant {
          .block .element:active { color: blue} 
    }
}

The same as css:

:host.hostVariant .block .element:active {
  color: blue;
}

The result is:

:host.hostVariant .block .element:active,
.\:host.hostVariant .block .element.\:active {
  color: blue;
}

The expected result:

:host.hostVariant .block .element:active,
:host.hostVariant .block .element.\:active {
  color: blue;
}

The styling is broken when using a class (.) on the host (:host) element.
The same problem will occur when using IDs (#) on the host (:host) element.

I will submit my PR in a few minutes.

I would really appreciate to get the next release published on npm, too.

All the best,
Philipp

Preserve css pseudo class functions

Hello,

I would like to preserve css pseudo class functions like :host() but currently all pseudo class functions are escaped.

Example:

:host(.selector) {...}

:host(:active) {...}

is resolved to:

:host(.selector),
// `host` is in blacklist: last parenthesis is escaped
:host(.selector\) {...}
// `host` not in blacklist:
./:host\(.selector\) {...}

:host(:active),
.\:host\(.\:active\) {...}

I need the following output:

// function remains unchanged
:host(.selector) {...}

:host(:active),
// function remains unchanged, only pseudo state is resolved
:host(.\:active) {...}

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.