<inputbox>
跳到导航
跳到搜索
![]() |
本页面之全部或部分原来自MediaWiki的Extension:InputBox,依 CC BY-SA 3.0 授权引入;原贡献者可以在这里看到。 |
InputBox是一个MediaWiki扩展,可以创建用于搜索、新建、修改页面的输入框。
示例
这个输入框可以创建以输入内容为标题的页面。
<inputbox> type=create break=no </inputbox>
完整参数
输入框像这样构造:
<inputbox> type= bgcolor= width= default= preload= editintro= buttonlabel= hidden= searchbuttonlabel= fulltextbutton= labeltext= break= namespaces= prefix= placeholder= page= minor= summary= id= inline= dir= preloadparams[]= searchfilter= </inputbox>
type参数必须输入。 而其他所有参数均为可选。 preloadparams[]可以出现不止一次。
输入框类型
默认情况下提交按钮位于输入框的下面。
通过设置换行参数可将“提交”按钮移至右侧:break=no
。
将“提交”按钮移至右侧对于使用搜索框时搜索建议覆盖了下方搜索按钮的情况很有用。
类型 | 例子 | 描述 |
---|---|---|
type=search | 创建的搜索框的默认宽度为50字符。 输入的内容为要搜索的关键字。 | |
type=create | 创建新页面。 输入的内容为要编辑的页面名称。 | |
type=comment | 在输入框指定的页面下增加一个新段落。 | |
type=commenttitle | 以输入框中输入的标题增加一个新段落。 标题可以用default= 参数指定。页面必须用page= 参数指定。
| |
type=fulltext | 仅显示全文搜索按钮,不显示“前往”按钮。 | |
type=move | 将页面移动至另一个名字。 |
对于type=search2
,默认的搜索按钮位置在右侧。这种搜索框将搜索其所在的整个维基。
类型 | 例子 |
---|---|
type=search2 |
参数
参数 | 描述 | 适用范围 | 例子 | 结果 | |
---|---|---|---|---|---|
bgcolor= | 设置表格背景色(HTML颜色值)。 不要使用引号。 | 所有类型 | <inputbox> type=search bgcolor=#eeeeff </inputbox> |
||
width= | 设置输入框的宽度,单位为字符。 | 所有类型 | <inputbox> type=create width=24 </inputbox> |
||
default= | 输入框中的默认文本。 | 所有类型 | <inputbox> type=comment default=User_talk:示例用户 </inputbox> |
||
preload= | 当创建新页面时,此标题的页面将会被预先载入进空白编辑框。 | create, comment, commenttitle | <inputbox> type=create preload=Template:页面格式/音乐 </inputbox> |
||
在上面或下面的输入框示例中输入一个不存在的页面标题,并分别点击“创建页面”或“新段落”按钮来测试此功能。 | |||||
editintro= | 通过这一参数指定的页面将会作为编辑指引显示在编辑窗口上方。 |
create, comment | <inputbox> type=comment editintro=Template:Info </inputbox> |
||
buttonlabel= | 此参数将作为表单主按钮显示的文字。 | 所有类型 | <inputbox> type=comment buttonlabel=添加新的段落 </inputbox> |
||
hidden= | 此参数指定不显示输入框。
这需要与参数“default”配合使用,但此参数现在不是默认值,而是作为页面标题的固定值。 |
create, comment | <inputbox> type=comment hidden=yes default=Help_talk:Inputbox buttonlabel=在该页面讨论页留言 </inputbox> |
||
searchbuttonlabel= | 此参数将作为表单“搜索全文”按钮显示的文字。 | search, fulltext | <inputbox> type=search searchbuttonlabel=深入探索 </inputbox> |
||
fulltextbutton= | 在“search2”表单上显示全文搜索按钮。 | search2 | <inputbox> type=search2 searchbuttonlabel=深入探索 fulltextbutton=true </inputbox> |
||
labeltext= | 在左侧显示的文字。 | search2 | <inputbox> type=search2 searchbuttonlabel=深入探索 labeltext=查找: </inputbox> |
||
break= | 是否在输入框和按钮之间插入换行。 默认为yes(使用换行)。 | 所有类型 | <inputbox> type=create width=24 break=no </inputbox> |
||
namespaces= | 在全文搜索中支持选择命名空间。
使用“ |
search, fulltext | <inputbox> type=search namespaces=Main**,Help </inputbox> |
||
prefix= |
注:下划线不等同于空格。 |
search, fulltext, create | <inputbox> type=search prefix=Help: </inputbox> |
下面的按钮以 | |
placeholder= | 设置当输入框为空时的占位文字。 | 所有类型 | <inputbox> type=search placeholder=搜索萌娘百科 </inputbox> |
||
minor= | 将编辑设置为小编辑。 | create | <inputbox> type=create page=Project:Sandbox minor=true </inputbox> |
||
page= | 要发表评论或要移动的页面。 | comment, move | <inputbox> type=comment page=Project:Sandbox </inputbox> |
||
summary= | 编辑摘要或移动理由。 | create, move | <inputbox> type=create default=Special:Mypage/Inputbox_test summary=这是一段预设的编辑摘要 </inputbox> |
||
id= | <form>的id属性。 | 所有类型 | <inputbox> type=comment page=Project:Sandbox summary=Foo id=bar </inputbox> |
||
inline= | 将输入框作为inline元素(在开头不换行)。 | search2 | 在此输入: <inputbox> type=search2 inline=true width=10 </inputbox> |
在此输入: | |
dir= | 输入框内的书写方向,可以是从右到左(rtl)或从左到右(ltr)。 默认与页面语言的方向相同。 | 所有类型 | <inputbox> dir=rtl type=create default=从右向左的文字 </inputbox> |
||
preloadparams[]= | 设置预加载文本的参数。此例中的文本请见这里 | create, comment, commenttitle | <inputbox> type=create preload=Help:Inputbox/预加载样例 preloadparams[]=小明 preloadparams[]=小红 </inputbox> |
||
searchfilter= | 指定在搜索中追加的参数。 | search | <inputbox> type=search searchfilter=insource:foo </inputbox> |
对于已存在的页面使用create只会跳转到编辑界面。
在这种情况下preload
被忽略。
对新页面使用comment是有效的。
对齐
通过使用div标签包裹的方法,可以调整一个输入框的位置。
<div style="float:right; width:42em"> <inputbox> type=create break=no </inputbox> </div>
这时候这个输入框就会浮动到右侧。
解析器函数
输入框可以在模板中使用。 然而,在模板中只有当<inputbox>...</inputbox>
标签以{{#tag:inputbox|...}}
的形式编写时,传递给输入框的模板参数才能够生效。
下面的例子是一个通过指定模板创建新页面的模板:
{{#tag:inputbox| type=create buttonlabel=创建新{{{1|条目}}} preload={{{2|Template:页面格式/音乐}}} }}
实例化此模板时,第一个参数提供一个已经创建好的项(默认为“条目”),就像按钮中显示的那样。第二个参数提供用来创建项的模板名称(默认为“Template:页面格式/音乐”)。
|