ForHosting KIT · Strumenti per sviluppatori

Ordinare i colori per luminanza

Trasformi un gruppo disordinato di colori hex in una scala prevedibile dal buio alla luce.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Lo strumento convalida ogni valore, normalizza la notazione hex breve e completa, converte i canali sRGB in luce lineare e ordina secondo la luminanza relativa WCAG. Ogni risultato include colore normalizzato e luminanza, così Lei può esaminare differenze minime senza affidarsi alla sola vista. I valori a pari luminanza mantengono l’ordine iniziale, i duplicati restano presenti e lo stesso input genera sempre lo stesso output.

Crei una scala di luminosità da una palette disordinata

Le raccolte di colori spesso seguono la creazione dei token o la serializzazione del file, non la luminosità. Invii l’array colors e riceverà record ordinati per luminanza relativa crescente. Le forme a tre cifre vengono espanse, quelle a sei accettano il cancelletto facoltativo e l’output usa #rrggbb minuscolo. La normalizzazione facilita snapshot, file di token, CSS e confronti. I duplicati restano perché possono rappresentare token distinti. I colori con luminanza esattamente uguale conservano l’ordine di input, evitando variazioni tra esecuzioni. La risposta indica anche quantità, direzione e metodo. La usi per creare una palette sequenziale o analizzare campioni vicini. L’operazione modifica soltanto l’ordine: non genera tinte intermedie, non rinomina token e non garantisce passaggi percettivamente uniformi.

Comprenda come la luminanza relativa determina l’ordine

La luminanza relativa non è la semplice media dei byte rosso, verde e blu. I colori hex codificano canali sRGB mediante una curva non lineare; ogni canale viene scalato tra zero e uno e convertito in luce lineare. I valori entro la soglia sRGB sono divisi per 12.92, mentre gli altri usano la funzione di potenza standard. Poi si applicano i coefficienti 0.2126, 0.7152 e 0.0722. Il verde pesa di più e il blu di meno; il risultato va da zero per il nero a uno per il bianco. L’ordinamento usa il valore completo non arrotondato. Le sei cifre mostrate servono alla lettura e alla serializzazione stabile. Il modello compare nei calcoli WCAG, ma ordinare una palette non dimostra l’accessibilità: verifichi separatamente ogni coppia tra primo piano e sfondo.

Convalidi l’input e integri risultati deterministici

Il campo colors deve essere un array non vuoto con un massimo di 1000 elementi. Ogni elemento deve essere una stringa di esattamente tre o sei cifre esadecimali dopo un cancelletto facoltativo. Gli spazi esterni sono ignorati; alfa, nomi CSS, funzioni rgb(), lunghezze errate e tipi diversi vengono rifiutati. L’errore segnala l’indice problematico senza eliminare o interpretare valori. Così una build non accetta una scala parziale apparentemente valida. L’implementazione svolge solo aritmetica locale e ordinamento in memoria, senza rete, orologio, casualità o conservazione. Lo stesso array produce lo stesso JSON nel browser, in CI e via API. Il browser è gratuito; ogni richiesta API costa $0.002. Duplicati conservati e parità stabili consentono di ricollegare con certezza i risultati ai metadati originali.

Ordinare token di design

Converta colori ereditati o generati in una sequenza stabile prima di numerare la scala.

Preparare colori sequenziali per grafici

Disponga i campioni per luminanza relativa affinché la scala visiva proceda in modo coerente.

Verificare la progressione di una palette

Esamini luminanze e colori normalizzati per trovare inversioni, duplicati o intervalli troppo piccoli.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Può anche eseguire gratuitamente nel browser lo stesso risolutore deterministico.

Quali formati di colore sono accettati?

Usi tre o sei cifre hex con cancelletto facoltativo, per esempio #abc, abc, #aabbcc o AABBCC.

Sono ammessi alfa o nomi CSS?

No. Hex con alfa, nomi, rgb(), hsl() e altre sintassi CSS vengono rifiutati per evitare ambiguità.

Cosa accade se due colori hanno la stessa luminanza?

Mantengono l’ordine relativo originale. Questa regola stabile conserva anche i duplicati.

L’ordine scuro-chiaro garantisce un contrasto accessibile?

No. L’ordine descrive colori singoli; l’accessibilità richiede la verifica di coppie precise tra primo piano e sfondo.

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/sort-by-luminance

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/sort-by-luminance \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"colors":["#f8fafc","#0f172a","#22c55e","#64748b"]}'
{
  "colors": [
    "#f8fafc",
    "#0f172a",
    "#22c55e",
    "#64748b"
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.sort_by_luminance",
  "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.

max_items1000
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 →