Siirry sisältöön

14.5.0

Accordion

Haitarielementti sisältöjen piilottamiseen. Soveltuu erityisesti listamaisen sisällön tiivistämiseen.

Julkaistu versiossa 1.2.0

Esikatselu

Käyttötarkoitus

Käytä haitarielementtiä laajojen tietosisältöjen jäsentelyyn ja käyttöliittymän silmäiltävyyden parantamiseen. Haitarissa voidaan piilotetusti esittää sisältöä, jonka ei ole pakollista heti näkyä asiakkaalle. Asiakas voi itse valita, mitä sisältöä haluaa tarkastella.

Oikein käytettynä haitarielementti auttaa asiakasta suorittamaan tehtävänsä tehokkaammin. Tarpeettomasti käytettynä se puolestaan lisää ylimääräisiä klikkauksia.

Otsikoi haitari aina mahdollisimman selkeästi ja kuvaavasti. Näin olennaiset sisällöt eivät jää asiakkaalta vahingossa huomaamatta.

Anna asiakkaan lähtökohtaisesti itse valita kuinka monta haitaria hän haluaa avata. Avattavien osioiden määrää ei kannata rajoittaa ilman perusteltua syytä.

Tee näin
  • Käytä piilottamaan sisältöä, joka ei ole pakollista olla asiakkaalle heti näkyvillä.
  • Käytä piilottamaan sisältöä, joka koskee vain osaa asiakkaista.
  • Käytä tiivistämään sisältöä.
  • Ryhmittele sisältö selkeisiin kokonaisuuksiin.
  • Muotoile otsikko siten, että se kuvaa haitariin piilotettua sisältöä.
Älä tee näin
  • Älä piilota haitariin tietoa, joka ei saa jäädä asiakkaalta huomaamatta.
  • Älä käytä piilottamaan hyvin lyhyttä sisältöä.
  • Älä käytä haitaria, jos sivulla on niin vähän sisältöä, ettei haitarin käyttö ole perusteltua.
  • Älä käytä haitaria, mikäli asiakas todennäköisesti lukee koko sivun sisällön. Jaa sisältö sen sijaan otsikoiden alle.

Saavutettavuus

Komponentti lisää automaattisesti tarvittavat ARIA-attribuutit ruudunlukijoille, kun komponentille välitetään id-attribuutti.

Haitarikomponentin oletusotsikko AccordionTitle on oletuksena leipätekstiä. Joissakin tilanteissa se on hyvä toteuttaa HTML:n otsikkoelementillä, jolloin haitarikomponentti ja sen sisältö on helpommin löydettävissä ruudunlukijalla. Aseta näissä tapauksissa otsikkoelementille sisällön rakenteeseen sopiva otsikkotaso.

<AccordionTitle as="h3">Otsikko</AccordionTitle>

Haitarielementti

Haitarielementti otsikkotyylillä

Haitarin otsikon voi toteuttaa tavanomaisella otsikkotyylillä, jolloin haitari erottuu sivun muusta sisällöstä. Muotoile otsikko napakasti. Valitse otsikko, joka kuvaa haitariin sisältyvää tietoa.

Haitarielementti leipätekstityylillä

Haitarin otsikoinnin voi toteuttaa myös leipätekstiä mukailevalla tyylillä. Kevyempää otsikkotyyli sopii esimerkiksi sisältöihin, joissa otsikot ovat pitkiä tai haitaria ei haluta erityisesti korostaa muusta sisällöstä.

Leipätekstiin perustuvaa otsikkotyyliä voi soveltaa esimerkiksi usein kysyttyjen kysymysten listaamiseen.

Lisätietoteksti otsikon alla

Haitarielementin otsikon alle voi tarvittaessa lisätä lyhyen lisätietotekstin, joka kuvaa haitarin sisältöä.

Kevyt haitarielementti

Kevyt haitarielementti otsikkotyylillä

Haitarin toteutuksessa voi soveltaa myös ilman taustaväriä olevaa, kevyempää visuaalista tyyliä, etenkin jos haitarielementtiä käytetään muiden komponenttien, kuten paneeleiden, sisällä. Kevyempiä haitareita voi muista haitarityyleistä poiketen käyttää myös sisäkkäin. Tällöin hierarkiassa alemman haitarin otsikkotaso on aina pienempi ja sisennetty.

Kevyt haitarielementti linkkipainikkeen tyylillä

Esimerkiksi lomakekenttien laajennettavissa ohjeteksteissä tai chat-kuplissa kannattaa käyttää linkkipainikkeen tyyliä mukailevaa haitarielementtiä.

Useampi haitari linkkipainikkeen tyylillä:

Avaa kaikki -toiminto

Avaa kaikki -toiminto mahdollistaa kaikkien samaan ryhmään kuuluvien haitareiden avaamisen samanaikaisesti. Ryhmälle voi tällöin antaa myös yhteisen otsikon.

Toiminnon soveltaminen haitariryhmässä sopii parhaiten käyttötapauksiin, jossa Avaa kaikki -valinnan tarjoaminen on asiakkaan kannalta hyödyllistä. Haitareiden otsikoiden tulee tällaisessa tapauksessa olla mahdollisimman kuvaavia.