Skip to content

Latest commit

 

History

History
348 lines (254 loc) · 8.94 KB

README.md

File metadata and controls

348 lines (254 loc) · 8.94 KB
Raw

TypeScript Styled Plugin

TypeScript server plugin that adds intellisense to styled component css strings

Build Status

Usage

This plugin requires TypeScript 2.4 or later. It can provide intellisense in both JavaScript and TypeScript files within any editor that uses TypeScript to power their language features. This includes VS Code, Sublime with the TypeScript plugin, Atom with the TypeScript plugin, and others.

With VS Code

To use this plugin with VS Code, first install the plugin and a copy of TypeScript in your workspace:

npm install --save-dev typescript-styled-plugin typescript

Then add a plugins section to your tsconfig.json or jsconfig.json

{
  "compilerOptions": {
    "plugins": [
      {
        "name": "typescript-styled-plugin"
      }
    ]
  }
}

Finally, run the Select TypeScript version command in VS Code to switch to use the workspace version of TypeScript for VS Code's JavaScript and TypeScript language support. You can find more information about managing typescript versions in the VS Code documentation.

Also consider installing the vscode-styled-components extension to get stytax highlighting for styled components.

With Sublime

This plugin works with the Sublime TypeScript plugin.

First install the plugin and a copy of TypeScript in your workspace:

npm install --save-dev typescript-styled-plugin typescript

And configure Sublime to use the workspace version of TypeScript by setting the typescript_tsdk setting in Sublime:

{
	"typescript_tsdk": "/Users/matb/my-amazing-project/node_modules/typescript/lib"
}

Finally add a plugins section to your tsconfig.json or jsconfig.json and restart Sublime.

{
  "compilerOptions": {
    "plugins": [
      {
        "name": "typescript-styled-plugin"
      }
    ]
  }
}

With Atom

This plugin works with the Atom TypeScript plugin.

First install the plugin and a copy of TypeScript in your workspace:

npm install --save-dev typescript-styled-plugin typescript

Then add a plugins section to your tsconfig.json or jsconfig.json and restart Atom.

{
  "compilerOptions": {
    "plugins": [
      {
        "name": "typescript-styled-plugin"
      }
    ]
  }
}

To get sytnax highlighting for styled strings in Atom, consider installing the language-babel extension.

Configuration

Tags

This plugin adds styled component IntelliSense to any template literal tagged with styled or css:

import styled from 'styled-components'

styled.button`
    color: blue;
`

You can enable IntelliSense for other tag names by configuring "tags":

{
  "compilerOptions": {
    "plugins": [
      {
        "name": "typescript-styled-plugin",
        "tags": [
          "styled",
          "css",
          "sty"
        ]
      }
    ]
  }
}

Now strings tagged with either styled, css, or sty will have styled component IntelliSense:

import sty from 'styled-components'

sty.button`
    color: blue;
`

Linting

To disable error reporting, set "validate": false in the plugin configuration:

{
  "compilerOptions": {
    "plugins": [
      {
        "name": "typescript-styled-plugin",
        "validate": false
      }
    ]
  }
}

You can also configure how errors are reported using linter settings.

{
  "compilerOptions": {
    "plugins": [
      {
        "name": "typescript-styled-plugin",
        "lint": {
          "vendorPrefix": "error",
          "zeroUnits": "ignore"
        }
      }
    ]
  }
}

The following lint options are supported:

compatibleVendorPrefixes

"ignore" | "warning" | "error"

When using a vendor-specific prefix make sure to also include all other vendor-specific properties. Default is "ignore".

vendorPrefix

"ignore" | "warning" | "error"

When using a vendor-specific prefix also include the standard property. Default is "warning".

duplicateProperties

"ignore" | "warning" | "error"

Do not use duplicate style definitions. Default is "ignore".

emptyRules

"ignore" | "warning" | "error"

Do not use empty rulesets. Default is "ignore".

importStatement

"ignore" | "warning" | "error"

Import statements do not load in parallel. Default is "ignore".

boxModel

"ignore" | "warning" | "error"

Do not use width or height when using padding or border. Default is "ignore".

universalSelector

"ignore" | "warning" | "error"

The universal selector (*) is known to be slow. Default is "ignore".

zeroUnits

"ignore" | "warning" | "error"

No unit for zero needed. Default is "ignore".

fontFaceProperties

"ignore" | "warning" | "error"

@font-face rule must define 'src' and 'font-family' properties. Default is "warning".

hexColorLength

"ignore" | "warning" | "error"

Hex colors must consist of three or six hex numbers. Default is "error".

argumentsInColorFunction

"ignore" | "warning" | "error"

Invalid number of parameters. Default is "error".

unknownProperties

"ignore" | "warning" | "error"

Unknown property. Default is "warning".

ieHack

"ignore" | "warning" | "error"

IE hacks are only necessary when supporting IE7 and older. Default is "ignore".

unknownVendorSpecificProperties

"ignore" | "warning" | "error"

Unknown vendor specific property. Default is "ignore".

propertyIgnoredDueToDisplay

"ignore" | "warning" | "error"

Property is ignored due to the display. E.g. with 'display: inline', the width, height, margin-top, margin-bottom, and float properties have no effect. Default is "warning"

important

"ignore" | "warning" | "error"

Avoid using !important. It is an indication that the specificity of the entire CSS has gotten out of control and needs to be refactored. Default is "ignore".

float

"ignore" | "warning" | "error"

Avoid using 'float'. Floats lead to fragile CSS that is easy to break if one aspect of the layout changes. Default is "ignore".

idSelector

"ignore" | "warning" | "error"

Selectors should not contain IDs because these rules are too tightly coupled with the HTML. Default is "ignore".

Contributing

To build the typescript-styled-plugin, you'll need Git and Node.js.

First, fork the typescript-styled-plugin repo and clone your fork:

git clone https://github.com/YOUR_GITHUB_ACCOUNT_NAME/typescript-styled-plugin.git
cd typescript-styled-plugin

Then install dev dependencies:

npm install

The plugin is written in TypeScript. The source code is in the src/ directory with the compiled JavaScript output to the lib/ directory. Kick off a build using the compile script:

npm run compile

And then run the end to end tests with the e2e script:

npm run e2e

You can submit bug fixes and features through pull requests. To get started, first checkout a new feature branch on your local repo:

git checkout -b my-awesome-new-feature-branch

Make the desired code changes, commit them, and then push the changes up to your forked repository:

git push origin my-awesome-new-feature-branch

Then submit a pull request against the Microsoft typescript-styled-plugin repository.

Please also see our Code of Conduct.

Credits

Code originally forked from: https://github.com/Quramy/ts-graphql-plugin