Vite Plugin: Hex Color Transform
Overview
The hexColorTransform
plugin for Vite transforms "#RRGGBB"
, "#RGB"
, "#RRGGBBAA"
, and "#RGBA"
into 0xRRGGBBAA
format and handling optional alpha values correctly. This documentation provides instructions for configuring the plugin with include and exclude filters.
Removing hexColor
If you were using hexColor, you can find and replace all instances with:
Use VSCode to remove hexColor
hexColor\("(#[A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})"\)
"$1"
Additionally, Enable default color decorators
in VScode in your settings (Command + , to search for the setting) to get built in color highlighting
Installation
npm i @lightningtv/vite-hex-transform -D
Usage
Plugin Configuration
Create or update the vite.config.js
file in your Vite project to include the hexColorTransform
plugin with options for including and excluding files.
import { defineConfig } from 'vite';
import hexColorTransform from './hexColorTransform';
export default defineConfig({
plugins: [
hexColorTransform({
include: '**/*.js',
exclude: 'node_modules/**',
}),
],
});
Plugin Options
The hexColorTransform
plugin accepts an options object with the following properties:
include
: A glob pattern or an array of glob patterns specifying which files to include. The default is to include all files.exclude
: A glob pattern or an array of glob patterns specifying which files to exclude. The default is to exclude no files.
Example
Here are some examples of how to use the include
and exclude
options:
import { defineConfig } from 'vite';
import hexColorTransform from './hexColorTransform';
export default defineConfig({
plugins: [
hexColorTransform({
include: '**/*.js',
exclude: 'node_modules/**',
}),
hexColorTransform({
include: ['src/**/*.js', 'src/**/*.ts'],
exclude: 'src/ignore-this-directory/**',
}),
],
});
How It Works
Example Code Transformation
Before
const color = "#f6f6f6";
const shortColor = '#fff';
const alphaColor = "#f6f6f680";
After
const color = 0xF6F6F6FF;
const shortColor = 0xFFFFFFFF;
const alphaColor = 0xF6F6F680;
Conclusion
The hexColorTransform
plugin for Vite provides a convenient way to transform hex color strings in your code. By configuring include and exclude patterns, you can control which files are processed by the plugin, making it flexible and easy to use in various project setups.
For more information and advanced configuration options, refer to the official Vite documentation and the plugin source code.