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:

before- ja after-attribuuteilla 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>'

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

escape:

Asettaa tulostuvassa sisällössä pakomerkin ennen lainausmerkkejä. Attribuutin tarkoitus on helpottaa tagin palauttaman sisällön käyttämistä JavaScriptin avulla.

Sallitut arvot: true/false. Oletusarvo false.

or:

Määrittää vaihtoehtoisen sisällön, joka näkyy mikäli 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.'