Skip to main content

Kvalitet i forklaringer

1. Innledning

En forklaring er en kort beskrivelse/forklaring av et ord. Forklaringer hjelper elevene å forstå begreper og dermed også mer av teksten der de inngår. Elever med lavt ordforråd, lese- og skriveutfordringer eller et annet morsmål enn norsk kan ha særlig god nytte av at tekstene våre har noen ordforklaringer.

Forklaring i løpende tekst, forklaringstjenesten og definisjonslister

Vi kan skrive forklaringer i løpende tekst, bruke forklaringstjenesten eller lage definisjonslister i en artikkel.

Når vi bruker forklaringstjenesten blir et ord klikkbart, og brukeren får opp en kort forklaring av ord i tekster i artikler og oppgaver. Vi kan beskrive ord og konsepter kort, og vi kan også legge ved bilde hvis det er særlig relevant. Bilder i forklaringer må være i breddeformat. Vi kan søke i forklaringsdatabasen, eller opprette nye forklaringer hvis begrepet ikke har blitt forklart før.

Hvis vi lager definisjonslister i en artikkel skriver vi inn forklaringer av ordene i en egen liste i ED som er tilgjengelig i den aktuelle artikkelen og denne konteksten. Definisjonslistene er ikke knyttet til forklaringstjenesten.

Udir kvalitetsveileder læremidler – relevante påstander

    3. Læremiddelet bruker et språk som er tilpasset fagets terminologi og elevene i målgruppen

    Eksempel på kjennetegn:

    Læremiddelet

    • har gode forklaringer på faglige begreper
    • har formuleringer som bygger bro mellom dagligspråk og fagspråk
    • har språk som er tilpasset elevenes alder og behov
    • har språk som i størst mulig grad kan forstås av flerspråklige elever og elever med behov for særskilt tilrettelegging
    • har mulighet for at elever og lærere kan gjøre egne valg i læremiddelet som støtter språkforståelsen (digitale læremidler)

    5. Læremiddelet støtter lærerens arbeid med tilpasset opplæring

    Læremiddelet tilbyr variasjon i innhold som gir elever og lærere mulighet til å gjøre valg som støtter elevenes behov for tilpasning. Flerspråklige elever og elever med særskilt behov for tilrettelegging bør i størst mulig grad kunne bruke samme læremiddel som resten av elevgruppen. Læremiddelet kan utformes fleksibelt, og digitale læremidler kan med fordel ha tilgang til digitale funksjoner som kan aktiveres etter behov.

    Eksempel på kjennetegn:

    Læremiddelet

    • har flere innganger til det faglige stoffet
    • har auditiv og/eller visuell støtte
    • har begrepsforklaringer og/eller ordbok
    • har aktiviteter som kan løses uavhengig av elevenes forutsetninger eller faglige nivå
    • har alternative aktiviteter
    • har mulighet for at elevene kan svare på aktiviteter på ulike måter (for eksempel med tekst, lydfil, film og så videre)

    Udir: veileder for kvalitet i læremidler i alle fag

    2. Pedagogisk kvalitet og faglig ramme

    Når vi lager læringsressurser, må vi alltid tenke på balansen mellom å bruke fagspråk og fagtermer, og å skrive enkelt og klart. Det å lære i et fag betyr også å lære fagspråket, men terskelen kan bli for høy noen ganger, og elever kan miste tråden. Da kan forklaringer hjelpe elever til å forstå og lære fagspråket, samtidig som de kan få utbytte av teksten. Vi må ikke ha altfor mange forklaringer i en tekst, for det kan ødelegge elevenes leseflyt. 

    3. Universell utforming av forklaringer

     Vi bruker et så enkelt og forståelig språk i forklaringer som mulig. Det er lite til hjelp å forklare ett fremmedord med ti ord hvis tre av dem er nye fremmedord. Dersom vi bruker bilde, skal det ha tekstalternativ med alt-tekst og ha gode kontraster. 

    • Forklaringene skal ha vanlig tekstformattering
    • Vi bruker et enkelt og forståelig språk
    • Vi lager korte og konkrete forklaringer
    • Vi bruker kun bilde om det er veldig nødvendig, og det skal ha gode kontraster og alt-tekst

    Les mer
    Uu: tekst
    Uu: bilder og grafikk

    4. Brukerinnsikt om forklaringer

    Vi har gjort en del brukertester der det har vært forklaringer i fagstoffet eller i en oppgave. Vi har derfor fått en del innsikt om forklaringer. Vi har ikke testet kategorien og ulike måter å utforme forklaringer på systematisk, noe som ville vært interessant. 

    • Elever setter pris på få forklart vanskelige ord. 
    • Elever liker korte og klare forklaringer, lange kan bli forstyrrende, og de kan føle seg lurt ("-Det var jo en artikkel i en artikkel").
    • Elever liker godt å få begrepslister som hører til tekst eller film.
    • Hvis det er veldig mange forklaringer i en tekst eller i et tekstparti oppfatter elevene det som en komplisert tekst.

    Les mer: [Lag brukerinnsikt om forklaringer]

    Vi anbefaler dere å lage korte og enkle forklaringer. Bruk maks 25 ord.

    5. Relevant innhold

    Zendesk: Hvordan skrive forklaringer


    Skrevet av Stina Grolid

    Om valg av design for forklaringer.

    Denne teksten er ikke ferdigskrevet enda. 

    Det å markere et vanskelig ord på en eller annen måte ble innført på ndla.no allerede i 2009. Logikken er selvsagt at en vil bruke korrekte begrep, faguttrykk og av og til litt vanskelige ord som elevene kanskje trenger en forklaring på. Det har vært flere ulike design på ordforklaringer i tekst. Vi har valgt det nåværende designet på grunn av lovverket rundt UU som sier at et interaktivt element skal være:

    • tydelig markert visuelt på mer en en måte. (vi har nå en litt annen skriftfarge en på brødtekst, og vi har en dobbeltstrek under ordet med forklaring.)
    • Vi har en tydelig dobbeltstrek for å skille dette fra en vanlig lenke.
    • Vi har så gode kontraster som vi har for å oppfylle WCAG 2.1
      • Kontrastforhold på minst 4,5:1. UU-tilsynet anbefaler allikevel at vi bruker /,0:1
      • De vil ha en "høykontrastversjon"
    • Alt designet er laget med så gode kontraster som WCAG-kravet sier. 
    • Ved mouseover vil ordet bli markert med et mørkt felt og selve bokstavene blir hvite. 
    • Når en trykker på ordet vil det bli markert med en annen blåfarge, og bokstavene blir mørke. 
    • For skjermlesere skal det også være veldig tydelig hva som skjer. Nå får en lest opp ordet, så får en forklart at dette er en "lokalmeny med dialog minimert knapp. Du er på en knapp. Trykk på CTRL + tilvalg + mellomrom for å vise en liste med valg.  " Når du så trykker på dette og aktiverer pop-up vinduet får du lest opp at ordet det gjelder, "begrepsforklaring, etc.