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
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
- vaidark
-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
- jaafter
-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
- jaafter
-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.'