View source for Extension:Details/cs

<languages/>
{{Extension
|status               = stable
|type1                = tag
|hook1                = ParserFirstCallInit
|username             = kirbylover4000
|author               = Adam Demasi
|description          = Sémantický, prohlížečem podporovaný sbalitelný obsah v článcích MediaWiki s použitím tagů {{tag|details|open}}, {{tag|summary|open}}
|update               = 2026-03-10
|compatibility policy = main
|download             = {{GithubDownload|theapplewiki|mediawiki-extensions-Details|translatewiki=0}}
|readme               = [https://github.com/theapplewiki/mediawiki-extensions-Details/blob/main/README.md README]
|example              = [https://theapplewiki.com/wiki/Template:Collapse The Apple Wiki]
|tags                 = &lt;details&gt;, &lt;summary&gt;
}}
'''Details''' poskytuje sémantický, prohlížečem podporovaný sbalitelný obsah v článcích MediaWiki pomocí tagů {{tag|details|open}}, {{tag|summary|open}}.

Klíčový rozdíl oproti tradičnímu přístupu <code>{{ll|Manual:Collapsible elements|mw-collapsible}}</code> spočívá v tom, že prohlížeč chápe, že detaily jsou stále ''obsahem'' – částí stránky, o kterou by uživatel mohl mít zájem.
Když je prohlížeč požádán o přechod na obsah nalezený v elementu <code>&lt;details&gt;</code>, tento element se automaticky rozbalí.
To zahrnuje kotvy, vyhledávání na stránce a [https://developer.mozilla.org/docs/Web/Text_fragments zvýraznění s funkcí scroll-to-text] (v závislosti na [[#Auto-expanding|podpoře prohlížeče]]).
Naproti tomu se nedoporučuje používat <code>mw-collapsible</code> u obsahu, který by měl být uživateli přístupný, protože obsah je ve sbaleném stavu pro tyto funkce prohlížeče považován za sémanticky neviditelný, a proto může být skryt i před vyhledávači.

Detaily se snaží zachovat kompatibilitu se stávajícími wiki skripty/styly, které mohou očekávat názvy tříd a chování třídy <code>mw-collapsible</code>.

<span id="Installation"></span>
== Instalace ==
{{ExtensionInstall
|registration = required
|download-link = [https://github.com/theapplewiki/mediawiki-extensions-Details/releases/latest Ke stažení]
}}

<span id="Usage"></span>
== Použití ==
Jednoduše použijte ve svém wiki obsahu standardní tagy [https://developer.mozilla.org/docs/Web/HTML/Element/details &lt;details&gt;] a [https://developer.mozilla.org/docs/Web/HTML/Element/summary &lt;summary&gt;].
Prvek {{tag|details|open}} obaluje celou sbalitelnou oblast a prvek {{tag|summary|open}} funguje jako rozbalovací prvek.

Například:

<syntaxhighlight lang="html">
<details class="wikicollapse">
<summary>Nějaký šíleně dlouhý obsah</summary>
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore ...
</details>
</syntaxhighlight>

Všechny HTML parametry, které MediaWiki podporuje u prvků {{tag|div|open}}, jsou podporovány i u prvků {{tag|details|open}} a {{tag|summary|open}}.
Kromě toho můžete ve výchozím nastavení použít {{tag|details|open|params={{attr|open}}}} k rozšíření obsahu.

Ve výchozím nastavení není k dispozici žádný styl.
Ve většině případů chcete použít <code class="mw-highlight">{{attr|class|"wikicollapse"}}</code>.
To platí pro styly podobné {{ll|Help:Tables#class="wikitable"|wikitable}}.

Rozšíření Details posouvá nativní podporu prohlížeče pro třídu {{tag|details|open}} dále tím, že přidává kompatibilitu s třídou {{ll|ResourceLoader/Core modules#jquery.makeCollapsible|jquery.makeCollapsible}}, lépe známou pod názvem třídy <code>mw-collapsible</code>..
Stávající styly a skripty postavené na tomto by měly většinou fungovat.
Také obdržíte standardní skládací přepínací tlačítko '''<nowiki>[</nowiki>{{int|collapsible-expand}}]''' a '''<nowiki>[</nowiki>{{int|collapsible-collapse}}]''' a jeho umístění v DOMu lze přizpůsobit pomocí třídy <code>{{ll|Manual:Collapsible elements#Custom toggle link placement|mw-collapsible-toggle-placeholder}}</code>.

Články se sbalitelným obsahem budou přidány do kategorie sledování "Stránky používající tag Details parser".

<span id="Parameter_and_template_expansion"></span>
=== Rozšíření parametrů a šablon ===
Protože Details je {{ll|Manual:Tag extensions|rozšíření tagu}}, je rozbaleno ''před'' {{ll|Manual:Templates|šablonami}} a {{ll|Manual:Parser functions|funkcemi parseru}}.
Pokud tedy chcete upravit parametry u tagů {{tag|details|open}} nebo {{tag|summary|open}}, musíte použít funkci parseru {{ll|Help:Magic words#tag|{{code|lang=wikitext|inline=1|1=<nowiki>{{#tag:...}}</nowiki>}} }}:

<syntaxhighlight lang="wikitext">
{{#tag: details
 | {{#tag: summary
  | Nějaký šíleně dlouhý obsah
  | class={{{summaryclass|my-summary-class}}}
 }}
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore ...
 | class={{{detailsclass|my-details-class}}}
}}
</syntaxhighlight>

Nezapomeňte, že při použití {{code|lang=wikitext|inline=1|1=<nowiki>{{#tag:...}}</nowiki>}} se obsah nachází '''před''' parametry.

Protože se zdá být obtížné volitelně specifikovat atribut <code>open</code> pomocí tohoto přístupu, od verze 1.1 můžete specifikovat hodnoty "false" pro negaci (uzavření) ve výchozím nastavení.
Šablona by to mohla použít takto:

<syntaxhighlight lang="wikitext">
{{#tag: details
 | ...
 | open={{#ifeq: {{{expand|}}} | expand | yes | no}}
}}
</syntaxhighlight>

<span id="Multi-part_mode"></span>
=== Vícedílný režim ===
V mnoha případech je užitečné zabalit tabulku, konverzaci nebo jiný velký segment stránky do sbaleného bloku.
To je obvykle možné s <code>mw-collapse</code>, protože to lze provést s {{tag|div|params={{attr|class|"mw-collapse"}}}} nebo {{ll|Help:Tables|syntaxí tabulky}}, které lze rozdělit do více šablon.
Wikipedia frequently uses [[w:Template:Collapse top|<nowiki>{{Collapse top}}</nowiki>]] and [[w:Template:Collapse bottom|<nowiki>{{Collapse bottom}}</nowiki>]] to achieve this.
To však není možné s rozšířeními tagů kvůli pořadí, ve kterém je MediaWiki analyzuje.

Prvek Details rozšiřuje element {{tag|details|open}} o atribut <code>part</code>.
Lze jej použít následovně:

<syntaxhighlight lang="html">
<details part="head" class="wikicollapse" />
<summary>Nějaký šíleně dlouhý obsah</summary>
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore ...
<details part="foot" />
</syntaxhighlight>

Zdá se, že tento trik není kompatibilní s rozšířením {{ll|Parsoid}}, které nesprávně "opraví" fragmenty HTML vytvořené tímto rozšířením.

<span id="Configuration"></span>
== Konfigurace ==
V {{ll|Manual:LocalSettings.php|LocalSettings.php}} lze nastavit následující možnosti konfigurace:

{| class="wikitable"
! Proměnná
! Výchozí
! Popis
|-
| <code>$wgDetailsMWCollapsibleCompatibility</code>
| <code>true</code>
| Řídí, zda Details načítá CSS a JavaScript pro vylepšení tagů {{tag|details|open}} a {{tag|summary|open}}.
Díky tomu se chovají podobně jako třída <code>mw-collapsible</code> a zavádí třídu <code>wikicollapse</code>, která má styl podobný <code>wikitable</code>.
Pokud je tato možnost zakázána, použije se výchozí styl a chování prohlížeče.
|}

<span id="Compatibility"></span>
== Kompatibilita ==

Podporuje MediaWiki 1.39 a novější.

Pro fungování sbalitelného obsahu je vyžadována podpora prohlížeče:

<span id="Fully_supported"></span>
=== Plně podporováno ===
Všechny prohlížeče od roku 2017 jsou plně podporovány.
Konkrétně je pro implementaci přepínacího tlačítka pro sbalení/rozbalení vyžadována [https://caniuse.com/?search=HTMLDetailsElement <code>HTMLDetailsElement</code> událost přepínač].

* Chrome 36+ (37+ na Androidu)
* Firefox 49+
* Safari 10.1+ (iOS 10.3+)

<span id="Auto-expanding"></span>
==== Automatické rozbalování ====
Novějším přírůstkem webové platformy je [https://html.spec.whatwg.org/multipage/interaction.html#interaction-with-details-and-hidden=until-found "skrytý, dokud nebude nalezen"].
To umožňuje skrýt prvek, ale stále je vidět pro funkce, jako je vyhledávání na stránce a ukotvení (hash) navigace.
Prohlížeč zobrazí prvek, pokud se v něm nachází relevantní obsah.
Toto je žádoucí funkce pro skryté části článku.

* [https://chromestatus.com/feature/5032469667512320 Chrome 97+] (2021)
* [https://bugzilla.mozilla.org/show_bug.cgi?id=1724299 Firefox 139+] (2025)
* [https://developer.apple.com/documentation/safari-release-notes/safari-26_2-release-notes#HTML Safari 26.2+] (2025)

Od verze 1.1 podporují rozšíření polyfilly funkci "skryté, dokud nebude nalezeno" pro hashové kotvy.
Podpora polyfillingu pro vyhledávání na stránce a zvýraznění textu pravděpodobně nebude možná.

<span id="Partially_supported"></span>
=== Částečně podporováno ===
Tyto prohlížeče nepodporují událost přepnutí, ale [[Wikipedia:Fault tolerance|elegantně přejdou]] na používání vestavěné funkce přepínání prohlížeče.
Kliknutím kamkoli v řádku {{tag|summary|open}} se přepne jeho obsah.

* Chrome 10+ (2011)
* Safari 6.0+ (2012, iOS 6.0+)

<span id="No_support"></span>
=== Bez podpory ===
Tyto prohlížeče vůbec nepodporují {{tag|details|open}} a {{tag|summary|open}}.
Obsah obou tagů bude zobrazen tak, jak je.

* Internet Explorer
* EdgeEdge založený na HTML (18 a starší)
* Opera založená na Prestu (12 a starší)
* Opera Mini

<span id="See_also"></span>
== Související odkazy ==
* {{ll|Manual:Collapsible elements}}
* [[phab:T31118|T31118]] - Přidat sémantické prvky HTML 5 'details' a 'summary' do whitelistu Sanitizeru