Extension:Page Forms/Input types/cs

Tato stránka se zabývá různými typy vstupů, které jsou k dispozici v rámci formulářů stránek, a parametry a další přizpůsobení, které lze pro ně nastavit.



text
Výchozí typ vstupu; odpovídá "textovému" vstupu HTML.

Speciální parametry:

textarea
Odpovídá HTML značce.

Speciální parametry:



text s automatickým doplňováním, textová oblast s automatickým doplňováním
These were formerly real input types, but have been aliases for "combobox" or "tokens" (depending on whether the input holds a list of values, or just one) since version 5.0.

combobox
Typ vstupu "combobox" poskytuje rozhraní combo box: vstup, který funguje jako běžné pole automatického doplňování, ale má další ikonu šipky dolů, jako je rozbalovací nabídka, která uživateli umožňuje zobrazit všechny dostupné hodnoty najednou. Je implementován pomocí knihovny.

Speciální parametry:

tokens
Tento typ vstupu "tokenizuje" hodnoty v poli, tj. umístí kolem každé hodnoty blok, aby se z ní stala jedna jednotka namísto pouhého řetězce znaků. Tyto "tokeny"“ pak lze také přeskládat. Tento vstup je implementován pomocí JavaScriptové knihovny Select2.

Speciální parametry:

Ve výchozím nastavení se "tokeny" zobrazují jako jednořádkový vstup a poté se v případě potřeby vertikálně rozšíří, pokud jsou přidány další hodnoty. V některých případech můžete chtít, aby se tento vstup na začátku jevil vyšší než jeden řádek, aby bylo uživatelům jasnější, že se rozšíří. Chcete-li to provést pro jeden vstup, přidejte do značky pole parametr, například " ", a poté do MediaWiki:Common.css přidejte něco jako následující:

Pokud chcete, aby to platilo pro všechny vstupy "tokenů" na wiki, přidejte místo toho do MediaWiki:Common.css něco takového:

radiobutton
Vstup "radiobutton" odpovídá HTML vstupu "radio". Zobrazuje sadu hodnot, ze kterých si uživatel může vybrat pouze jednu.

Ve výchozím nastavení je první hodnota přepínacího tlačítka "None" (žádné), což uživateli umožňuje vybrat prázdnou hodnotu. Chcete-li zabránit zobrazení "None", musíte pole nastavit jako "povinné" (mandatory) a také nastavit jednu z povolených hodnot jako hodnotu "default=" (výchozí).

dropdown
Vstup "dropdown" (rozbalovací) odpovídá HTML značce. Zobrazuje rozbalovací seznam hodnot, z nichž si uživatel může vybrat pouze jednu.

checkboxes
Vstup "checkboxes" (zaškrtávací políčka) zobrazuje zaškrtávací políčka, která umožňují uživateli vybrat libovolný počet hodnot. Pokud je zaškrtávacích políček více než určitý počet, nad sadou zaškrtávacích políček se automaticky zobrazí odkazy"Select all" (vybrat vše) a "Select none" (nevybrat žádné), což uživatelům umožní automaticky zaškrtnout všechna nebo žádná z nich. Toto číslo je diktováno proměnnou, která je ve výchozím nastavení 10, i když ji lze změnit v LocalSettings.php.

Speciální parametry:

listbox
Vstup "listbox" odpovídá HTML značce &lt;select&gt; s přidaným atributem "multiple". Zobrazuje vertikální seznam možností, kde si uživatel může vybrat libovolný počet hodnot.

Speciální parametry:

tree
Typ vstupu "tree" (strom) umožňuje hierarchické zadávání ve stromovém stylu, kde všechny hodnoty mají vedle sebe buď přepínací tlačítka, nebo zaškrtávací políčka, v závislosti na tom, zda pole může obsahovat jednu nebo více položek. Hodnoty mohou pocházet buď ze stromu kategorií v rámci wiki, nebo mohou být nastaveny ručně v definici formuláře.

Jak tento vstup pozná, zda může obsahovat jednu nebo více hodnot, a měl by tedy zobrazovat přepínací tlačítka vs. zaškrtávací políčka? Kontroluje, zda je pole v šabloně definováno jako pole obsahující seznam hodnot (pomocí #arraymap) nebo ne. Tato kontrola však není dokonalá. Pokud stromový vstup zobrazuje přepínací tlačítka místo zaškrtávacích políček, stačí přidat parametr "|list" do značky pole v definici formuláře, abyste zjistili, že se jedná o seznam.

V závislosti na zdroji hodnot musíte zadat jeden z těchto dvou dalších parametrů:


 * - nastaví název kategorie v horní části "stromu".
 * - nastavuje celou stromovou strukturu. K nastavení úrovně hloubky by se měly používat odrážky ve stylu wikitextu.

Pokud použijete parametr "structure" (struktura), měl by vypadat nějak takto:

Volitelně můžete také nastavit tyto parametry:


 * - nastavuje výšku pole, ve kterém se strom objeví, v pixelech.
 * - nastavuje šířku pole, ve kterém se strom objeví, v pixelech.
 * - nastavuje oddělovač, kdy pole může obsahovat seznam hodnot. Výchozí hodnota je ','.
 * - skryje název nejvyšší kategorie.
 * - nastavuje počet úrovní stromu, které jsou zobrazeny na začátku. Výchozí hodnota je 10.

Zde si můžete prohlédnout vzorový formulář, který používá tento typ vstupu.



Pro názvy kategorií
Pokud k zobrazení stromu kategorií používáte typ vstupu "strom", uvědomte si, že tento vstup vytiskne pouze názvy vybraných kategorií bez jmenného prostoru "Category:" před ním. Takže pokud chcete, aby se zobrazil i na stránce, šablona jej bude muset přidat.

Pokud pole určuje více kategorií a šablona k tomu používá #arraymap, mělo by volání #arraymap vypadat nějak takto:

...jinými slovy, musíte zadat konečný paramet "delimiter"r (oddělovač) pro #arraymap a vytvořit z něj mezeru, prázdnou nebo něco podobného, ​​abyste se vyhnuli tisku čárek mezi značkami kategorií.

checkbox
Jediné zaškrtávací políčko používané pro booleovské hodnoty.

Speciální parametry:

date
Tento vstup obsahuje tři samostatné položky pro rok, měsíc a den.

datetime
Vstup "datetime" je podobný vstupu "date", ale obsahuje další položky pro hodiny, minuty, sekundy a AM/PM.

Speciální parametry:

year
"year" je jednoduchý textový vstup, který se používá k získání hodnoty pouze pro rok pro pole data.

datepicker
"datepicker" umožňuje uživateli vybrat si datum pomocí vyskakovacího kalendáře založeného na JavaScriptu.

Special parameters:

Počáteční den týdne (např. sobota, neděle nebo pondělí) je nastaven na základě jazyka wiki. To bohužel nelze nastavit nezávisle na jazyku. Pokud je vaše wiki v angličtině a chcete, aby týdny v kalendáři začínaly v pondělí místo v neděli (což je výchozí nastavení), můžete to udělat nastavením jazyka vaší wiki na "en-gb" místo "en".

datetimepicker
"datetimepicker" je typ vstupu založený na JavaScriptu velmi podobný "datepicker", ale obsahuje vyskakovací okna pro výběr data i času. Výchozí hodnota je. Jeho sada parametrů zahrnuje všechny tyto "datepicker" a také následující:

rating
Typ vstupu "rating" zobrazuje sadu hvězdiček, aby mohl uživatel zadat hodnocení.

Speciální parametry:

googlemaps, leaflet, openlayers
Typy vstupu "googlemaps", "leaflet" a "openlayers" vám umožňují zobrazit mapu pro získání hodnoty souřadnic pomocí služeb Google Maps, Leaflet nebo OpenLayers.

Pokud používáte vstup "googlemaps", možná budete muset získat Google Maps API klíč a poté jej nastavit na LocalSettings.php pomocí nastavení, aby se vstup zobrazil.

Volitelně můžete také nastavit tyto parametry pro tyto typy vstupů:

Typ vstupu "leaflet" (leták) také umožňuje jeden další parametr:

Všechny mapové vstupy vám umožňují zadat adresu pro snadnější nalezení souřadnic. Pokud však formulář již obsahuje jedno nebo více polí pro zadání adresy, uživatel je možná bude muset zadat dvakrát – jednou pro skutečné uložení dat a podruhé pro nalezení souřadnic. Abyste se vyhnuli tomu, že by uživatelé museli dělat tuto dvojí práci, můžete pole adresy (polí) zadat své hodnoty přímo do mapy při lokalizaci bodu. Můžete to udělat pomocí parametru "feeds to map=" - hledejte "cesty do mapy" zde.

Všechny tyto formáty ve výchozím nastavení spoléhají na externí kód JavaScript. Můžete však nechat formát "openlayers" místo toho používat místní kód JavaScript, stačí nainstalovat rozšíření OpenLayers.

Zákazy
Všimněte si, že všechny tyto typy vstupů odesílají data vaší wiki (tj. data obsažená ve výsledcích dotazu) externím službám. Jsou jedinou částí kódu Page Forms, která odesílá data externě, kromě automatického doplňování na externích hodnotách, i když tato vyžaduje ke spuštění další konfiguraci. Pokud máte soukromou wiki a máte velké obavy z toho, aby se žádná data nedostala ven, možná budete chtít k LocalSettings.php přidat následující:

To znemožní používání jakýchkoliv externích služeb stránkovými formuláři - což v tuto chvíli znamená zakázání těchto tří typů vstupu.

regexp
Typ vstupu "regexp" není skutečný typ vstupu, ale spíše schopnost zobrazit jiný vstup (nejčastěji "text") s dalším ověřením založeným na regulárních výrazech. Podívejte se na podrobnější vysvětlení tohoto typu vstupu a jeho parametrů.



Povolené vstupní typy pro datové typy
Každý definovaný datový typ při použití Cargo nebo Semantic MediaWiki má výchozí typ vstupu a případně také výchozí velikost vstupu. Některé datové typy mají navíc speciální zpracování, pokud pole obsahuje seznam hodnot s oddělovači, nikoli pouze jednu hodnotu.

Zde jsou výchozí hodnoty a další povolené typy vstupu pro každý typ dat pro jednotlivé hodnoty:

A zde jsou výchozí a další povolené typy vstupu pro "oddělené seznamy" určitého datového typu:



Nahrávání souborů
Pokud má pole ve formuláři obsahovat název nahraného souboru (řekněme obrázek), můžete uživatelům umožnit nahrát tento soubor přímo prostřednictvím formuláře. To se provádí jednoduše přidáním parametru "uploadable" do deklarace tohoto pole v definici formuláře. Tím se vedle tohoto pole ve formuláři přidá odkaz "Upload file" (nahrát soubor). Pokud uživatel klikne na tento odkaz, zobrazí se okno ve stylu "lightbox" (pomocí knihovny JavaScript FancyBox), které uživateli umožní nahrát soubor. Jakmile tak uživatel učiní, okno se zavře a pole bude obsahovat název nahraného souboru. Pokud je pole nakonfigurováno tak, aby obsahovalo seznam hodnot, bude nový název souboru připojen k tomu, co tam bylo předtím, Jinak název souboru přepíše jakékoli pole obsažené dříve.

Pamatujte, že parametr "uploadable" lze použít pouze v polích typu "text", "text s automatickým doplňováním", "combobox" nebo "tokens".

U polí, která lze nahrát, můžete také nastavit výchozí název souboru nahraných souborů nastavením parametru "default filename=" v definici pole. Hodnota tohoto parametru může zahrnovat funkce parseru, magická slova a podobně. Může také obsahovat proměnnou "&lt;page name>", která je nahrazena názvem přidávané nebo upravované stránky. Přidání parametru "default filename=Image for &lt;page name>" do definice pole, například pro stránku s názvem "Abc", by tedy nastavilo výchozí název jakéhokoli nahraného souboru na "Image for Abc". Všimněte si, že pokud chcete pouze zadat výchozí soubor, který se má použít, například "Imageneeded.png", postačí běžný parametr "default=Imageneeded.png".

Zde můžete vidět ukázku nahrávání souboru.

Upozorňujeme, že okno nahrávání nebude fungovat, pokud je  ve vašem souboru LocalSettings.php nastaveno na.

Můžete také nastavit pole, do kterých lze nahrávat, tak, aby přímo používala vlastní nahrávání operačního systému namísto použití systému nahrávání MediaWiki – to dává uživateli méně možností, ale je to jednodušší proces a na mobilních zařízeních může představovat některé zajímavé možnosti, jako je nahrávání fotografií ihned po jejich pořízení. Chcete-li to provést, přidejte do souboru LocalSettings.php následující řádek:

Speciální parametry pro pole, která lze nahrát, jsou:
 * - Určuje, že se jedná o pole, které lze nahrát.
 * - Určuje, že pod polem ve formuláři má být umístěna miniatura nahraného obrázku.
 * filename - Určuje výchozí název souboru pro soubory nahrané pomocí tohoto pole.