Espanda un colore hex abbreviato
Lo strumento espande un colore CSS esadecimale abbreviato di tre cifre nel corrispondente formato completo di sei cifre.
Esegui gratis nel browser
Inserendo #3a7, Lei ottiene #33aa77, pronto per fogli di stile, token di design, file di configurazione o API che richiedono la notazione estesa. L’intero input viene convalidato prima dell’espansione: colori di sei cifre, varianti alfa, caratteri errati e valori incompleti producono quindi un errore chiaro. L’output viene normalizzato in minuscolo e include sempre il cancelletto iniziale per l’uso diretto in CSS.
Come funziona l’espansione esadecimale a tre cifre
Un colore esadecimale CSS descrive normalmente rosso, verde e blu con due cifre per canale. Nella forma abbreviata ogni canale usa una sola cifra. L’espansione non aggiunge zeri e non stima una tonalità vicina: ripete ogni cifra originale. Pertanto #3a7 diventa #33aa77: il 3 del rosso diventa 33, la a del verde diventa aa e il 7 del blu diventa 77. La ripetizione conserva esattamente il colore rappresentato dall’abbreviazione secondo le regole CSS. Sono accettate lettere esadecimali maiuscole o minuscole, mentre la risposta viene normalizzata in minuscolo per rendere coerenti le configurazioni senza cambiare il colore. Il cancelletto iniziale è facoltativo nell’input, poiché valori provenienti da fogli di calcolo, riga di comando o moduli spesso non includono la punteggiatura CSS. Il valore completo restituito include sempre il cancelletto; un altro campo offre le stesse sei cifre senza prefisso. Non avvengono conversioni dello spazio colore o arrotondamenti: l’operazione è una trasformazione diretta e deterministica dei caratteri.
Quali input sono validi
Un input valido contiene esattamente tre cifre esadecimali dopo un eventuale cancelletto iniziale. Sono ammessi i numeri da 0 a 9 e le lettere da A a F, maiuscole o minuscole. #09f, abc e F0C sono validi; #12, #1234, #112233, red, 0xabc e #ggg non lo sono. La regola rigorosa è importante perché formati simili hanno significati differenti. Quattro cifre possono indicare un’abbreviazione con canale alfa, mentre sei cifre sono già espanse; accettarle silenziosamente cambierebbe lo scopo della capacità. Gli spazi esterni vengono rimossi per agevolare moduli e appunti, ma gli spazi interni restano vietati. L’input deve essere una stringa, perché un numero può perdere zeri iniziali significativi prima dell’elaborazione. Se la convalida fallisce, l’API restituisce un errore di input non valido con la forma richiesta. In questo modo i flussi automatici rilevano gli errori e non scrivono valori malformati in fogli di stile o raccolte di token.
Uso del colore espanso in un flusso di lavoro
Lei può usare il valore espanso quando uno strumento successivo, uno schema o una convenzione aziendale richiede colori di sei cifre. Uno script di migrazione può normalizzare vecchi token prima del confronto; un importatore di sistemi di design può convertire valori compatti prima di memorizzare token canonici; una pipeline può rifiutare nomi involontari o forme alfa al proprio confine. Poiché l’output è testo stabile in minuscolo, chiamate con maiuscole diverse producono lo stesso risultato canonico, mantenendo ordinati diff e chiavi cache. L’esecutore nel browser usa la medesima logica pura dell’API, quindi un valore controllato interattivamente si comporta allo stesso modo nell’automazione. Non vi sono dipendenze di rete né consultazioni di database esterni. Invii una forma breve nel campo hex e legga expanded per un valore CSS, oppure expanded_no_hash quando un altro formato aggiunge il prefisso. L’esecuzione API costa $0.002 per richiesta. Per RGB, HSL, nomi, miscele o contrasto, utilizzi una capacità di conversione dedicata.
Casi d'uso
Normalizzare i token di design
Converta valori compatti in colori coerenti di sei cifre e minuscoli prima di archiviarli o confrontarli.
Preparare CSS per una pipeline rigorosa
Espanda i colori abbreviati per linter, generatori o schemi che richiedono la notazione completa #RRGGBB.
Convalidare colori importati
Rifiuti caratteri e lunghezze errati mentre converte valori legittimi di tre cifre provenienti da un flusso.
Domande frequenti
Che cosa fa l’espansione?
Duplica ogni cifra abbreviata. Per esempio, #3a7 diventa #33aa77.
Il cancelletto iniziale è obbligatorio?
No. Sono accettati #abc e abc; il campo expanded include sempre il cancelletto iniziale.
Sono accettate lettere maiuscole?
Sì. Le lettere esadecimali da A a F possono essere maiuscole o minuscole; l’output è normalizzato in minuscolo.
Posso inviare un colore di sei o quattro cifre?
No. La capacità accetta esattamente tre cifre esadecimali. Le altre lunghezze causano un errore di input non valido.
Quanto costa una richiesta API?
Ogni richiesta API costa $0.002. La stessa espansione deterministica è disponibile anche nell’esecutore del browser.
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/color/hex-shorthand-expand \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"hex":"#3a7"}'const res = await fetch("https://api.kit.forhosting.com/color/hex-shorthand-expand", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"hex": "#3a7"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/color/hex-shorthand-expand",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"hex": "#3a7"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/hex-shorthand-expand", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"hex":"#3a7"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"hex":"#3a7"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/hex-shorthand-expand", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"hex": "#3a7"
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "color.hex_shorthand_expand",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |