Skip to content

A vscode extension to help visualize css colors in files

License

Notifications You must be signed in to change notification settings

cbanack/vscode-colorize

 
 

Repository files navigation

Colorize

codebeat badge Build Status Build status Licence Version License Installs Ratings

Instantly visualize css colors in your css/sass/less/postcss/stylus/XML... files.

This extension your styles files looking for colors and generate a colored background (using the color) for each of them.

💡 How to enable variables support

Features

  • Generate colored background for css variables
  • Generate colored background for preprocessor variables
  • Generate colored background for hsl/hsla colors
  • Generate colored background for cross browsers colors
  • Generate colored background for css hexa color
  • Generate colored background for rgb/rgba color
  • Color background live update

Options (settings)

The following Visual Studio Code settings are available for the Colorize extension. These can be set in user preferences (cmd+,) or workspace settings (.vscode/settings.json).

colorize.enable_search_variables BOOLEAN _default: true

By default colorize read and parse all files, in your workspace, that are targeted by the settings colorize.languages, colorize.include, colorize.exlude and colorize.files_extensions) and extract all variables. Thanks to this behavior all variables will have colored background even if you never open the file containing the declaration. ⚠️ This setting can slown down vscode at opening

colorize.languages ARRAY

Configure a list of languages that should be colorized. You can learn about languages at https://code.visualstudio.com/docs/languages/overview.

For example, if you want to colorize colors in javascript files, you just need to include it:

  "colorize.languages": [
    "javascript",
    // ...
  ]

colorize.include

Configure glob patterns for including files and folders. By default Colorize is enable for files matching one the languages defined in the colorize.languages config, with this config you can enable colorize for other files or folders. Read more about glob patterns here.

colorize.exclude

Configure glob patterns for excluding files and folders. Colorize will not colorized colors in these files and folders and it'll also not search for variables inside. Read more about glob patterns here.

[DEPRECATED] colorize.files_extensions ARRAY

⚠️ this setting is deprecated, you should use colorize.include instead Modified this option to activate colorize for files with the matching extension.

For example if you want to colorize .diff files:

  "colorize.files_extensions": [
    ".diff"
  ]

colorize.hide_current_line_decorations BOOLEAN default: true

By default, decorations for the current line are hidden. Set this setting to false if you want to deactivate this behavior.

colorize.colorized_colors ARRAY

This options allow you to enable/disable colorization for a type of colors.

Available colors are :

  • HEXA: for hexadecimal colors: #RGB, #RGBA, #RRGGBB, #RRGGBBAA, 0xRGB, 0xRGBA, 0xRRGGBB or 0xRRGGBBAA
  • ARGB: for argb colors: #RGB, #ARGB, #RRGGBB or #AARRGGBB
  • RGB: for rgb colors: rgb(r,g,b) or rgba(r,g,b,a)
  • HSL: for HSL colors: hsl(h,s,l) or hsla(h,s,l,a)
  • BROWSERS_COLORS: for native browser's colors like white, red, blue...

For example, if you want to only colorize hexa colors (#fff, #ffffff, 0xFFF) in your files you can update the option like this :

  "colorize.colorized_colors": [
    "HEXA"
  ]

colorize.colorized_variables

This options allow you to enable/disable colorization for a type of variables.

For example if you use less in your project you setup the option like this

  "colorize.colorized_variables": [
    "LESS"
  ]

This way all @variables will be colorized

Roadmap

  • Generate background for hexa colors
  • Update background on color updates
  • Generate background for rgb colors
  • Generate background for rgba colors (~ missing transparency)
  • Generate background for hsl colors
  • Generate background for hsla colors (~ missing transparency)
  • Generate background for Predefined/Cross-browser colors
  • Generate background for preprocessor variables
  • Generate background for css variables
  • Config livereload

Release

See CHANGELOG for more information.

Contributing

Bugs, feature requests and more are welcome here GitHub Issues.

About

A vscode extension to help visualize css colors in files

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 100.0%