Hjælp:Sammenklappelige elementer

Denne side er en hjælpeside på den danske Wikipedia. Siden indeholder basal eller avanceret information om dansk Wikipedia og eventuelt teknisk vejledning. Se oversigten over alle hjælpesider under Hjælp.

Et sammenklappeligt element er et HTML-element på en Wikipediaside som indeholder en knap, som læseren kan bruge til at vise eller skjule elementets indhold. Elementer gøres sammenklappelige ved at tilføje CSS-klassen mw-collapsible til elementet. Det kan gøres direkte, men oftest indsættes klassen ved hjælp af skabeloner. Med brug af skabeloner behøver skribenterne ikke at kende de tekniske detaljer, og redigering af siden bliver nemmere.

Anvendelse

På diskussionssider og dokumentationssider med meget indhold kan man bruge skabelonen {{Collapse}} eller dens varianter {{Collapse top}} og {{Collapse bund}} for at give et bedre overordnet overblik.

Det er ikke normalt at bruge sammenklappelige elementer i artikler med undtagelse af brug i navigationsbokse, sidenavigationsbokse, infobokse og sjældnere store tabeller. Skabelonerne {{Navboks}} og {{Sidebar with collapsible lists}} har indbygget understøttelse af sammenklappelighed. I infobokse kan man bruge {{Collapsible list}} til at lave sammenklappelige lister, og {{Collapsed infobox section begin}} og {{Collapsed infobox section end}} til at sammenklappe hele afsnit af infoboksen.

{{Hidden}} eller {{Hidden begin}} og {{Hidden end}}, som kan sammenklappe vilkårlig tekst, bør normalt ikke bruges i artikler.

Sammenklapning virker ikke ved mobilvisning hvor indholdet altid vises (se phab:T111565).

Sammenklappelige tabeller

Tabeller er særlig nemme at gøre sammenklappelige. Man tilføjer simpelthen class="mw-collapsible" til starten af tabellen lige efter det indledende {|

Hvis tabeller har en overskrift (caption), som laves med |+, vises kun overskriften når tabellen er sammenklappet. Hvis den ikke har en overskrift, vises den første tabelrække når tabellen er klappet sammen.

I eksemplerne nedenfor bruges også klassen wikitable. Den giver et standardiseret udseende på tabeller i Wikipedia, men er ikke nødvendig for at sammenklapningen kan virke.

Tabelkode	Produceret tabel
{| class="wikitable mw-collapsible" |+ Frugter ! Æbler !! Pærer |- | 3 || 4 |}	Frugter Æbler Pærer 3 4
{| class="wikitable mw-collapsible" ! Æbler !! Pærer |- | 3 || 4 |}	Æbler Pærer 3 4

Sammenklappet fra starten

Normalt vil sammenklappelige elementer vises på en side, når man indlæser siden. Ved også at bruge klassen mw-collapsed vil det sammenklappelige element starte med at være sammenklappet, når siden indlæses. For eksempel med tabeleksemplerne fra afsnittet herover:

Tabelkode	Produceret tabel
{| class="wikitable mw-collapsible mw-collapsed" |+ Frugter ! Æbler !! Pærer |- | 3 || 4 |}	Frugter Æbler Pærer 3 4
{| class="wikitable mw-collapsible mw-collapsed" ! Æbler !! Pærer |- | 3 || 4 |}	Æbler Pærer 3 4

Afhængigt af antal sammenklappelige elementer

Med klassen autocollapse, vil et sammenklappeligt element automatisk blive klappet sammen hvis der er mere end ét sammenklappeligt element på siden, men blive vist hvis det er det eneste sammenklappelige element på siden. Man skal være varsom med at bruge dette, idet sammenklapningen først udføres når siden er indlæst, så visningen af siden vil "hoppe" når sammenklapningen sker, hvilket kan være generende.

kode	Resultat
Dette <code>autocollapse</code>-element: <div class="mw-collapsible autocollapse">... klappes sammes, fordi der er flere sammenklappelige elementer på siden.</div>	Dette autocollapse-element: ... klappes sammes, fordi der er flere sammenklappelige elementer på siden.

Afhængigt af placering i et ydre sammenklappeligt element

Et sammenklappeligt element med klassen innercollapse, vil blive klappet sammen ved indlæsning af siden, hvis det er placeret inden i et andet sammenklappeligt med klassen outercollapse:

kode	Resultat
Dette <code>innercollapse</code>-element ... <div class="mw-collapsible innercollapse">... bliver ikke klappet sammen.</div>	Dette innercollapse-element ... ... bliver ikke klappet sammen.
<div class="mw-collapsible outercollapse" style="padding:1em; background:#ccc;">Dette er et ydre sammenklappeligt div-element med klassen <code>outercollapse</code>. <div class="mw-collapsible innercollapse">Dette indre sammenklappelige div-element med klassen <code>innercollapse</code> bliver klappet sammen.</div></div>	Dette er et ydre sammenklappeligt div-element med klassen outercollapse. Dette indre sammenklappelige div-element med klassen innercollapse bliver klappet sammen.

Det anvendes typisk ved navbokse som kan anbringes inden i hinanden.

Knaptekst

Man kan vælge en anden tekst til knapperne attributterne data-collapsetext og data-expandtext:

Tabelkode	Produceret tabel
{| class="wikitable mw-collapsible" data-collapsetext="Skjul dem!" data-expandtext="Vis dem!" |+ Frugter="Skjul dem!" ! Æbler !! Pærer |- | 3 || 4 |}	Frugter Æbler Pærer 3 4

Flere indstillinger

Der er også mere avancerede indstillingsmuligheder. Man kan for eksempel have mere end én sammenklapningsknap og selv definere hvilke delelementer i det sammenklappelig element som skal sammenklappes og andet. Der er beskrevet på siden mw:Manual:Collapsible elements på mediawiki.org.

Hvor er koden?

• Klassen mw-collapsible og andre klasser med "mw-" er en del MediaWiki-softwaren som driver Wikipedia.
• De tre klasser autocollapse, innercollapse og outercollapse er lokale tilføjelser på Wikipedia som lavet med JavaScript-kode i MediaWiki:Common.js

Tidligere var der er anden klasse collapsible som var implementeret i MediaWiki:Common.js, hvilket blev overflødigt da mw-collapsible blev introduceret i MediaWiki version 1.18. Fordi der stadig er kode som bruger den gamle klasse, er der nu midlertidigt en funktion i MediaWiki:Common.js som konverterer alle tilfælde af collapsible til mw-collapsible.