Tagi, jonka avulla voit määrittää kontrastivärin toiselle värille.

Kuvaus

Tagin tulostus määritetään antamalla hex-attribuutille HEX-väriarvo, jonka perusteella tagi arvioi, tarvitseeko kyseinen väri vaalean vai tumman kontrastivärin. Arvioinnin perusteella tagi tulostaa joko light- tai dark-attribuutissa määritetyn sisällön (tai oletuksena arvot white/black).

Esimerkiksi:

{ColorContrast(hex:'#000000')} // Väri on musta -> Tulostuu light-attribuutin arvo
{ColorContrast(hex:'#FFFFFF')} // Väri on valkea -> Tulostuu dark-attribuutin arvo

Syntaksi

{ColorContrast(
    hex: string,
    light: string,
    dark: string
)}

Näkyvyys

Toimii näkyvyydessä: globaali

Globaalin näkyvyyden tageja on mahdollista käyttää missä tahansa sivupohjassa ja minkä tahansa tagin sisällä.

Attribuutit

hex:

HEX-väriarvo, jonka perusteella tagi arvioi, tulostaako se kontrastiväriksi light- vai dark-attribuutin arvon.

Sallitut arvot: HEX-väriarvo (esim. #000000)
light:

Määrittää tagin tulostuksen, kun hex-attribuutille on annettu tumma väriarvo.

Jos attribuuttia ei ole asetettu, tagi tulostaa arvon white.

Sallitut arvot: merkkijono (esim. HEX-väriarvo)
dark:

Määrittää tagin tulostuksen, kun hex-attribuutille on annettu vaalea väriarvo.

Jos attribuuttia ei ole asetettu, tagi tulostaa arvon black.

Sallitut arvot: merkkijono (esim. HEX-väriarvo)
before: / after:

Näillä kahdella attribuutilla voit määrittää sisällön, joka tulostuu ennen tagin tuottamaa sisältöä tai sen jälkeen.

Sallitut arvot: teksti, jossa voi olla HTML- ja Interface-merkkausta.

Esim.:

  • before: '<p>Tämä merkkaus näkyy ennen tagin omaa sisältöä.</p>'
  • after: '<p>Tämä taas näkyy tagin oman sisällön jälkeen.</p>'

Jos tagi ei tuota mitään sisältöä, myöskään before- ja after-attribuuttien sisältö ei tulostu.

escape:

Lisää tagin tulostamaan sisältöön pakomerkit, jotta sisältöä on helpompi käyttää JavaScript-koodissa tai JSON-objekteissa.

Sallitut arvot:
  • true: attribuutti lisää pakomerkit ennen lainausmerkkejä
  • false: attribuutti ei tee mitään
  • json: attribuutti lisää tulostukseen pakomerkit, joiden avulla sisältöä voi käyttää JSON-merkkauksessa.
or:

Määrittää vaihtoehtoisen sisällön, joka näkyy, jos tagi ei itse tuota mitään sisältöä.

Sallitut arvot: teksti, jossa voi olla HTML- ja Interface-merkkausta.

Esim. or: 'Sisältöä ei löytynyt.'