ForHosting KIT · Imágenes

Hex a variable CSS

Convierta un color suelto en una variable CSS reutilizable: #3366ff con el nombre brand-primary queda como --brand-primary: #3366ff;, con la forma abreviada ampliada y el hex en minúsculas. Gratis en su navegador.

  • Gratis
  • Funciona en su navegador
  • Sin registro
  • Sus datos no salen de su equipo
Úselo desde WebAPIEmailTelegramApp pronto
Si escribe
Hex
#3366ff
Nombre
brand-primary
Obtiene
Valor
#3366ff
Hex6
3366ff
Hex sin procesar
#3366ff
Nombre
--brand-primary

Una propiedad personalizada CSS —también llamada variable CSS— es un token reutilizable que usted declara una vez y consulta con var() en toda una hoja de estilo, un archivo de tema o una tubería de tokens de diseño.

Qué es una propiedad personalizada CSS y por qué envolver un color hex

Las propiedades personalizadas CSS son declaraciones CSS ordinarias cuyos nombres empiezan por dos guiones. El hex sigue siendo el formato de intercambio que la mayoría de selectores, PDF de marca y archivos de tokens aún exportan, pero un #3366ff crudo no es un contrato de hoja de estilo: no tiene nombre, no tiene prefijo -- y no tiene punto y coma final.

Envolverlo como declaración de ident con guiones es una transformación pequeña y exacta que aun así falla en las tuberías: almohadillas ausentes, mezcla de mayúsculas, abreviatura de tres dígitos sin expandir, nombres que empiezan por un dígito, $variables de Sass pegadas por costumbre o un envoltorio var() donde solo corresponde el ident. Cada uno de esos errores produce CSS que parece casi correcto y luego falla al analizarse o en una revisión.

El resultado es una línea de definición lista para pegar en :root, una clase de tema o un tokens.css generado, sin rederivar la gramática en cada repositorio.

Dónde un formateador de hex a variable CSS aporta valor real

Los repositorios de tokens de diseño y las tuberías Style Dictionary convierten objetos de paleta estructurados en propiedades personalizadas CSS; un formateador compartido mantiene cada paquete en la misma gramática de declaración en lugar de plantillas ad hoc que discrepan sobre mayúsculas del hash, abreviatura o el espacio tras los dos puntos. Las bibliotecas de componentes y la documentación de Storybook pueden exponer un selector de color más un campo de nombre y copiar el declaration exacto a fragmentos que coinciden con las hojas que irá a producción.

Los generadores de tema que emiten bloques :root claros y oscuros necesitan un paso final que nunca invente un ident con guiones ilegal ni omita el punto y coma. Prefiera esta capacidad cuando ya tiene un token hex y un nombre elegido y solo necesita la línea de definición; no convierte hex a HSL, no resuelve colores CSS con nombre como rebeccapurple y no acepta hex alfa de ocho dígitos.

Fije la cadena declaration en las pruebas, mantenga los nombres en kebab-case o en la convención de la casa, y obtendrá líneas de propiedad personalizada reproducibles para sistemas de diseño, workers en el borde y generadores de documentación sin montar una biblioteca completa de ciencia del color solo para envolver.

Documentación de Storybook y componentes

Permita que los autores elijan un hex y un nombre de token y luego copien el campo declaration exacto a fragmentos de código que coinciden con el bloque :root de producción.

Generadores de temas y paletas

Tras calcular una rampa hex clara u oscura, envuelva cada parada como propiedad personalizada CSS con nombre para que el archivo de tema sea CSS válido en la primera emisión.

¿Cómo envuelvo un color hex como propiedad personalizada CSS?

Envíe hex (3 o 6 dígitos, # opcional) y name (con o sin --).

¿El nombre necesita un -- inicial?

No. brand-primary y --brand-primary se convierten ambos en --brand-primary. Se conserva la capitalización.

¿Qué formatos hex se aceptan?

Colores hexadecimales de tres dígitos (#RGB) y de seis dígitos (#RRGGBB), con o sin # inicial. La abreviatura se expande. No se aceptan formas con alfa (#RGBA, #RRGGBBAA) ni colores CSS con nombre.

¿Cómo es la línea de definición?

Siempre --<ident>: #<seis dígitos hex en minúsculas>; con un espacio tras los dos puntos y un punto y coma final. Ejemplo: --brand-primary: #3366ff;.

¿Qué nombres de variable se rechazan?

El nombre debe empezar por una letra o un guion bajo, con un guion opcional delante, y usar solo letras, dígitos, guiones y guiones bajos. Un nombre que empieza por un dígito o una variable $ de Sass se rechaza en lugar de generar CSS roto.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/color/hex-to-css-var

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

curl -X POST https://api.kit.forhosting.com/color/hex-to-css-var \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hex":"#3366ff","name":"brand-primary"}'
{
  "hex": "#3366ff",
  "name": "brand-primary"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.hex_to_css_var",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_name_len64
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Los equipos siguen guardando los colores de marca como códigos hex en Figma, PDF de marca y paletas JSON, y luego necesitan una sola línea determinista que puedan pegar en :root o en un bloque de tema. Esta herramienta envuelve un color hex validado en una declaración de propiedad personalizada con nombre: usted elige el identificador, el solver normaliza el hex a seis dígitos en minúsculas con almohadilla, comprueba que el nombre sea un ident con guiones legal y devuelve la línea de definición --name: #rrggbb;. Los códigos hex inválidos y los identificadores ilegales fallan con invalid_input en lugar de emitir CSS que no analizaría. La misma lógica pura se ejecuta gratis en el navegador y en la API, de modo que los tokens generados no divergen entre vistas previas locales, integración continua y hojas de producción.

Qué es una propiedad personalizada CSS y por qué envolver un color hex

Usted escribe --brand-primary: #3366ff; en :root o en cualquier selector y luego consume el token con color: var(--brand-primary) en botones, enlaces y superficies. Esa única fuente de verdad es cómo los sistemas de diseño mantienen de acuerdo un hex de Figma, una paleta JSON y una hoja de producción sin cazar decenas de literales incrustados. Un paso dedicado de hex a variable CSS estandariza el contrato: validar el color, validar el nombre, expandir la abreviatura, pasar el hex de seis dígitos a minúsculas, conservar la capitalización del ident y emitir un espacio tras los dos puntos más un punto y coma final.

Contrato de entrada, reglas de validación y la línea de definición

Se recorta el espacio en blanco circundante. En caso de éxito el hex se devuelve siempre como #rrggbb en minúsculas, la abreviatura de tres dígitos se expande (#abc pasa a #aabbcc) y el nombre se devuelve con prefijo -- conservando la capitalización original de las letras. El campo principal declaration es la propia línea de definición: --brand-primary: #3366ff;. Envíe un cuerpo JSON con dos cadenas obligatorias. hex es el color: tres o seis dígitos hexadecimales, almohadilla inicial opcional, letras en mayúsculas o minúsculas. Los alias color, value, text, input y code los acepta el mismo solver. name es el ident de la propiedad personalizada, con o sin -- inicial; los alias incluyen variable, var, var_name, custom_property e ident. La misma cadena se parte en variable y value para tablas de tokens, y root_block la envuelve como :root { --brand-primary: #3366ff; } para sembrar una hoja con un solo pegado. Los canales enteros r, g y b, más los indicadores shorthand, had_hash y had_prefix, describen la forma original. La validación fallida —campo ausente, hex vacío tras una almohadilla, longitud distinta de tres o seis, caracteres no hex, prefijo de programación 0x, espacios dentro del nombre, prefijo $ de Sass, envoltorio var(), ident que no empieza por letra o guion bajo, o un nombre de más de sesenta y cuatro caracteres incluido el prefijo— devuelve invalid_input nombrando el campo y nunca se cobra. El precio es un fijo $0.002 por petición exitosa.

Dónde un formateador de hex a variable CSS aporta valor real

Como la implementación es parse pura de tier A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente, y la validación fallida no consume saldo.

Tuberías de tokens de diseño y hojas de estilo

Convierta entradas hex de un JSON de marca en líneas estables --name: #rrggbb; para Style Dictionary, Theo o un tokens.css propio, sin deriva de mayúsculas ni de abreviatura entre máquinas.

¿Cuánto cuesta la herramienta de hex a variable CSS?

La herramienta del navegador es gratuita. Las solicitudes API usan saldo prepago KIT a $0.002 por llamada exitosa; la entrada inválida no se factura.

Ver la documentación completa del KIT →