 | This code base is maintained by theReader Experience team.Code review only for UBNs or security fixes. |
 Stav rozšíření: stabilní | |
|---|---|
 | |
| Implementace | Značka,Akce stránky, Hledání |
| Popis | Umožňuje uživatelům přidat předdefinovanéHTML formuláře do wiki stránek |
| Autoři |
|
| Nejnovější verze | Continuous updates |
| MediaWiki | >= 1.45 |
| Změny v databázi | Ne |
| Licence | Licence MIT |
| Stáhnout | |
| |
| Přeložte rozšíření InputBox, používá-li lokalizaci z translatewiki.net | |
| Problémy | Otevřené úkoly ·Nahlásit chybu |
RozšířeníInputBox přidává již vytvořenéformuláře HTML do wiki stránek.Uživatelé mohou "doplnit" formulář (vkládání textu, vybírání položek z menu atd.) vložením textu do políčka.
InputBox byl původně vytvořen uživatelemErik Möller z důvodu přidání poleVytvořit článek doWikinews.
InputBox ve vaší složceextensions/.cdextensions/gitclonehttps://gerrit.wikimedia.org/r/mediawiki/extensions/InputBoxwfLoadExtension('InputBox');
Dokončeno – Přejděte na stránkuSpecial:Version vaší wiki a zkontrolujte, zda bylo rozšíření úspěšně nainstalováno.Formulář pro založení nového článku.
<inputbox>type = createwidth = 30px<!-- with unit of measurement -->break = noplaceholder = Page title</inputbox>
Input boxy jsou konstruovány třeba takto:
<inputbox>type =<!-- <input> type == search search2 create comment commenttitle fulltext move -->bgcolor =<!-- Background color of parent <form>. -->width =<!-- Width of text field (searchbox) in 'characters'. Unit: Characters #Default: 50 -->page =<!-- Wiki pagename (i.e. page title) to post comment to, or move page to. No [[X]]. -->default =<!-- Initial value of the text field. -->preloadtitle =<!-- Content to prepopulate the title field with for a new comment -->preload =<!-- Content to prepopulate the source editor with for a new topic/comment, or new page. -->editintro =<!-- Wiki pagename of page to be transcluded as 'help text' shown above source editor window. -->hidden =<!-- Any value will hide the text field, but not buttons whose links will still work. -->searchbuttonlabel =<!-- Visual label for "Search full text" in type == search == fulltext. -->searchengine =<!-- Either 'MediaSearch' or 'Search'. Defaults to the wiki's value for the search-special-page preference. -->searchtype =<!-- If 'MediaSearch' is selected for searchengine, the result type. One of 'image' (default), 'video', 'audio', 'page', or 'other'. -->fulltextbutton =<!-- Visual label for "Search full text" -->labeltext =<!-- labeltext -->break =<!-- break -->namespaces =<!-- namespaces -->prefix =<!-- prefix -->placeholder =<!-- placeholder -->minor =<!-- minor -->nosummary =<!-- nosummary -->summary =<!-- summary -->id =<!-- id -->inline =<!-- inline -->dir =<!-- dir -->preloadparams[] =<!-- preloadparams[] -->searchfilter =<!-- searchfilter -->useve =<!-- useve -->usedt =<!-- usedt -->arialabel =<!-- arialabel -->buttonlabel =<!-- Visual label for primary search button. --></inputbox>
Tlačítka nejsou přístupná asistenčním technologiím: Prvky tlačítek generované touto šablonou v současné době nemají žádný přístupný popisek. Čtečky obrazovky proto oznamují pouze roli prvku (například "Tlačítko."), nikoli smysluplný popisek.Neexistuje spolehlivý způsob, jak přidat přístupný štítek bez přístupu k HTML kódu.
Parametrtype je povinný.Všechny ostatní parametry jsou nepovinné.preloadparams[] se mohou objevit více než jednou.
Výchozí umístění tlačítek "Odeslat" je pod vstupním polem.
Tlačítko "Odeslat" lze přesunout doprava pomocí parametru zalomení řádku, čímž se odstraní zalomení řádku mezi rámečkem a tlačítkem:break=no.
Tlačítko "Odeslat" vpravo je užitečné pro vyhledávací pole, kdy by návrhy vyhledávání jinak zakryly tlačítko vyhledávání pod vyhledávacím polem.
| typ | Příklad | Popis |
|---|---|---|
search | Vytvoří vyhledávací pole, které má výchozí šířku 50 znaků. Informace přidané do textového pole se hledají podle přesného názvu stránky (první tlačítko) nebo textu v článcích (druhé tlačítko). | |
create | Vytvoří novou stránku. Informací přidanou do textového pole je název stránky, která má být vytvořena (nebo stránky, kterou chcete upravit, pokud již existuje). | |
comment | Přidá novou sekci na konec stránky zadané v textovém poli (vytvoří stránku, pokud je nová). | |
commenttitle | Přidá nový oddíl se záhlavím oddílu napsaným do textového pole. Titulek lze zadat parametremdefault=. Stránka musí být specifikována parametrempage=. Z nějakého důvodu to NEFUNGUJE při použití rozšíření jeho vyvoláním pomocí {{#tag}}, pouze při použití<inputbox>.(zavedeno odrev:47203) | |
fulltext | Hledejte pouze pomocí tlačítka fulltextového vyhledávání, bez tlačítka přesné shody (tlačítko "Jít na").(zavedeno odrev:45269) | |
move | Změní název nebo přesune stránku. This also doesn't work when creating it by invoking a tag.(zavedeno odgerrit:97559) |
Protype=search2 je výchozí umístění tlačítka vyhledávání vložené vpravo.V současné době se nezdá, že by bylo možné do tohoto typu vstupního pole přidat další parametry.Toto vyhledávací pole prohledává celou wiki, na které je umístěno.
| typ | Příklad |
|---|---|
search2 |
| Parametr | Popis | Rozsah | Výsledek | Příklad | Kompatibilita | |
|---|---|---|---|---|---|---|
arialabel= | Zadejte atribut aria-label do vstupního pole, aby bylo vygenerované označení přístupné pro programy pro čtení z obrazovky VizARIA: atribut aria-label. | Všechny typy | <inputbox>type=searcharialabel=Search the wiki</inputbox> |
| ||
bgcolor= | Nastaví barvu pozadí tabulky (hodnoty barev HTML). Nepoužívejte uvozovky. | Všechny typy | <inputbox>type=searchbgcolor=gray</inputbox> | ? | ||
width= | Nastaví šířku InputBox ve znacích. | Všechny typy | <inputbox>type=createwidth=24</inputbox> | ? | ||
default= | Výchozí text pro vložení do InputBoxu. | Všechny typy | <inputbox>type=commentdefault=User talk:Eloquence</inputbox> | ? | ||
preloadtitle= | Výchozí text, který se má přidat jako název nového komentáře. | comment | <inputbox>type=commentpreloadtitle=My comment titledefault=Extension talk:InputBox</inputbox> |
| ||
preload= | Stránka pod tímto názvem bude při vytvoření nové stránky předem načtena (vizPříručka:Vytváření stránek s přednačteným textem) do prázdného editboxu. | create, comment, commenttitle | <inputbox>type=createpreload=Log</inputbox> | ? | ||
| Zadejte název neexistující stránky do příkladu InputBox výše nebo níže a kliknutím na "Vytvořit článek" nebo "Nová sekce" otestujte tento efekt. | ||||||
editintro= | Stránka, která je uvedena pod tímto parametrem, se zobrazí podle pokynůnad editačním oknem. | create, comment | <inputbox>type=commenteditintro=MediaWiki:Missingcommenttext</inputbox> | ? | ||
buttonlabel= | Tento štítek bude použit pro hlavní tlačítko formuláře. | Všechny typy | <inputbox>type=commentbuttonlabel=Přidání nového zdroje</inputbox> | ? | ||
hidden= | To určuje, že neexistuje žádný InputBox. Používá se s parametrem | create, comment | <inputbox>type=commenteditintro=Extension:InputBox/editintro commentpreloadtitle=Comment titlepreload=Extension:InputBox/preloadhidden=yesdefault=Extension talk:InputBoxbuttonlabel=Napište komentář na diskusní stránce</inputbox> | ? | ||
searchbuttonlabel= | Tento štítek bude použit pro tlačítko "Hledat celý text" vyhledávacího formuláře. | search, fulltext | <inputbox>type=searchsearchbuttonlabel=Hledej hlouběji</inputbox> | ? | ||
searchengine= | Pokud je nainstalován parametrExtension:MediaSearch, tento parametr nastaví speciální stránku vyhledávání na hodnotuSearch neboMediaSearch. Pokud se tento parametr nepoužije, použije se preference uživatele (nebo výchozí preference wiki). | search, search2 | <inputbox>type=searchsearchengine=MediaSearch</inputbox> |
| ||
searchtype= | Ifsearchengine=MediaSearch, this parameter configures which results' tab to display.One of the following:image,video,audio,page,other | search, search2 | <inputbox>type=searchsearchengine=MediaSearchsearchtype=audio</inputbox> |
| ||
fulltextbutton= | Zobrazit tlačítko fulltextového vyhledávání ve formuláři vyhledávání2 | search2 | <inputbox>type=search2searchbuttonlabel=Hledej hloubějifulltextbutton=true</inputbox> | ? | ||
labeltext= | Text, který se zobrazí vedle tlačítka | search2 | <inputbox>type=search2searchbuttonlabel=Hledej hloubějilabeltext=Hledat:</inputbox> | ? | ||
break= | Zda se má vložit zalomení řádku mezi vstupní pole a tlačítka. Výchozí hodnota jeyes (použijte zalomení řádku). | Všechny typy | <inputbox>type=createwidth=24break=no</inputbox> | ? | ||
namespaces= | Podpora zaškrtávacích políček jmenného prostoru ve fulltextovém vyhledávání. S " | search, fulltext | <inputbox>type=searchnamespaces=Main**,Help</inputbox> | ? | ||
prefix= |
Poznámka: Podtržítka nejsou rozpoznána jako mezery. | search, fulltext, create | Tlačítko níže uvádí před názvem | <inputbox>type=searchprefix={{FULLPAGENAME}}/Archive</inputbox> | ? | |
placeholder= | Definujte zástupný text, který se zobrazí ve vstupním poli, pokud je prázdné. | Všechny typy | <inputbox>type=searchplaceholder=Prohledejte tuto wiki</inputbox> |
| ||
page= | Stránka, na kterou chcete přidat komentář, nebo stránka, kterou chcete přesunout. | comment, move | <inputbox>type=commentpage=Project:Sandbox</inputbox> | |||
minor= | Malá editace. | comment, create | <inputbox>type=commentpage=Project:Sandboxminor=true</inputbox> | |||
nosummary= | Upravit souhrn (nadpis) není pro nový komentář vyžadováno. | comment | <inputbox>type=commenttitlepage=Special:Mypage/inputbox testnosummary=true</inputbox> | |||
summary= | Upravit souhrn nebo důvod přesunu. | create, move | <inputbox>type=createdefault=Special:Mypage/inputbox testsummary=Foo</inputbox> | |||
id= | Atribut ID pro<form>. | Všechny typy | <inputbox>type=commentpage=Project:Sandboxsummary=Fooid=bar</inputbox> |
for some types | ||
inline= | Nastavte InputBox jako vložený prvek (bez zalomení řádku na začátku). Jakákoli hodnota znamenáyes/true (ano/pravda). | search2 | Zde je text: | Zde je text:<inputbox>type=search2inline=truewidth=10</inputbox> | ||
dir= | Zprava doleva (rtl) nebo zleva doprava (ltr). Výchozí je směrovost jazyka stránky. | Všechny typy | <inputbox>dir=rtltype=commentpage=Project:Sandboxsummary=Foo</inputbox> | |||
preloadparams[]= | Zadejte parametry pro text předběžného načtení. VizVytváření stránek s předem načteným textem. | create, comment, commenttitle | <inputbox>type=createpreload=Logpreloadparams[]=param1preloadparams[]=param2</inputbox> |
| ||
searchfilter= | Zadejte parametry, které se mají připojit k vyhledávání | search, fulltext | <inputbox>type=searchsearchfilter=insource:foo</inputbox> |
| ||
useve= | Při vytváření stránky použije vstupní pole nový vizuální editor, pokud je rozšíření nainstalováno a tento parametr je nastaven na libovolnou hodnotu. | create, comment | <inputbox>type=createbreak=nouseve=true</inputbox> | |||
usedt= | Při přidávání nové sekce otevře vstupní poleNástroj nového tématu Diskusní nástroje, pokud je rozšíření nainstalováno a tento parametr je nastaven na libovolnou hodnotu. | comment, commenttitle | <inputbox>type=commenttitlepage=Project:Sandboxusedt=true</inputbox> | |||
Použitícreate na existující stránku jednoduše poskytne editační stránku.V takovém případě jepreload ignorován.Použitícomment pro novou stránku funguje.
Texty převzaté z jmenného prostoruMediaWiki: jsou samozřejmě pouze příklady, proeditintro nebopreload lze použít jakoukoli existující stránku.Bohuželpreload zatím nefunguje pro souhrnUpload.
Vstupní pole v šablonách si můžete přizpůsobit pomocí CSS. Nejprve jej obalte tagy<div> s jedinečným ID a poté pomocí selektorů CSS změňte jeho vzhled.Také byste mohli samotnému vstupnímu poli přiřadit ID a toto ID použít v selektorech CSS. Můžete také přidat vlastní tlačítko nebo ikonu vyhledávání.
<templatestylessrc="Template:Example/styles.css"/><divid="inputbox-search-wrapper">{{#tag: inputbox|type= searchid = inputbox-searchplaceholder = Search all pagesnamespaces = Main**,Help**}}<divclass="inputbox-search-icon"></div></div>
#inputbox-search-wrapper{box-sizing:border-box;height:32px;display:flex;border:1pxsolidvar(--border-color-base,#a2a9b1);border-radius:10px;}#inputbox-search-wrapperinput{all:unset;padding-left:8px;padding-top:6px;padding-bottom:6px;width:180px!important;font-family:'Helvetica Neue','Helvetica','Liberation Sans','Arial',sans-serif;;font-size:14px;line-height:20px;color:var(--color-base--subtle,#72777d);}#inputbox-search-wrapperinput::placeholder{font-family:'Helvetica Neue','Helvetica','Liberation Sans','Arial',sans-serif;;font-size:14px;line-height:20px;color:var(--color-base--subtle,#72777d);}#inputbox-search-wrapperinput.mw-ui-button,.searchbox.cdx-checkbox--inline,#inputbox-search-wrapper.cdx-button,#inputbox-search-wrapperdiv.mw-ui-checkbox{display:none;}.inputbox-search-icon{padding-left:8px;width:25px;background-image:url("https://upload.wikimedia.org/wikipedia/commons/thumb/7/7e/Vector_search_icon.svg/18px-Vector_search_icon.svg.png");background-repeat:no-repeat;background-position:center;cursor:pointer;}
Pokud chcete vytvořit vstupní pole na pravé straně stránky, udělejte něco jako:
<divstyle="float:right; width:42em"><inputbox>type=create</inputbox></div>
Dává:
Aby bylo možné vytvořit mnoho podobných vstupních polí, lze InputBox použít v šabloně.Předávání parametrů šablony parametrům InputBoxu však funguje pouze v případě, že je tag<inputbox>...</inputbox> použit prostřednictvím funkce parseru#tag s tagem{{#tag:inputbox | ...}} uvnitř šablony.
Následující příklad je šablona pro vytvoření nové stránky wiki z pojmenované šablony:
{{#tag:inputbox|type=createbuttonlabel=Vytvořit nový{{{1|článek}}}preload={{{2|Template:Article}}}}}
Při vytváření instance šablony první parametr udává položku, která je vytvořena (výchozí:article), jak je uvedeno v tlačítku, druhý parametr udává název šablony použité k vytvoření položky (výchozí:Template:Article).
Například kód pro vstupní pole pro vytvoření nového projektu ze šablony projektu může vypadat takto:
{{Template:CreateNew|project|Template:Project}}Toto rozšíření rozdělujecache parseru na základějazyka uživatelského rozhraní (git:e18b7e6), aby se zobrazily lokalizované texty popisků.
 | Toto rozšíření se používá na jednom nebo víceprojektech Wikimedia. Pravděpodobně to znamená, že rozšíření je stabilní a funguje dostatečně dobře, aby jej mohly používat weby s tak vysokou návštěvností. Vyhledejte tento název rozšíření v konfiguračních souborechCommonSettings.php aInitialiseSettings.php Wikimedie, abyste viděli, kde je nainstalováno. Úplný seznam rozšíření nainstalovaných na konkrétní wiki lze vidět na stránce wikiSpecial:Version. |
| Toto rozšíření je zahrnuto v následujících wiki farmách/hostitelích a/nebo balíčcích:Toto není autoritativní seznam. Některé wiki farmy/hostitelé a/nebo balíčky mohou toto rozšíření obsahovat, i když zde nejsou uvedeny. Pro potvrzení se vždy obraťte na své wiki farmy/hostitele nebo balíček. |