ForHosting KIT · Strumenti per sviluppatori

Espanda un colore hex abbreviato

Lo strumento espande un colore CSS esadecimale abbreviato di tre cifre nel corrispondente formato completo di sei cifre.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

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.

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.

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.

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.

POSThttps://api.kit.forhosting.com/color/hex-shorthand-expand

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

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"}'
{
  "hex": "#3a7"
}
{
  "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.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →