模組:Check for unknown parameters/doc

这是Module:Check for unknown parameters的文档页面

此模块附于模板来检测未知参数的使用。

用法 编辑

基本用法 编辑

{{#invoke:check for unknown parameters|check
|unknown=[[分类:某追踪分类]]
|arg1|arg2|...|argN}}

或使用带预览错误信息的参数来排序追踪分类中的条目

{{#invoke:check for unknown parameters|check
|unknown=[[Category:某追踪分类|_VALUE_]]
|preview=未知参数“_VALUE_”
|arg1|arg2|...|argN}}

或直接显示红色错误信息

{{#invoke:check for unknown parameters|check
|unknown=<span class="error">不好意思,_VALUE_是什么?</span>
|arg1|arg2|...|argN}}

以上代码中,arg1arg2、...、argN为已知参数。任何被使用的未列出参数都会导致模块返回unknown参数中的内容。这样有利于排序追踪列表中的条目,亦有利于提供具体信息。

默认情况下,模块不区分已定义但留空的参数和非空参数。要仅追踪非空参数,请使用|ignoreblank=1

默认情况下,模块忽略空白位置参数。要追踪空白位置参数,请使用|showblankpositional=1

正则表达式 编辑

本模块支持正则表达式,可在使用大量有规律格式的参数时使用。如,template:infobox3cols中有

| regexp1 = header[%d][%d]*
| regexp2 = label[%d][%d]*
| regexp3 = data[%d][%d]*[abc]?
| regexp4 = class[%d][%d]*[abc]?
| regexp5 = rowclass[%d][%d]*
| regexp6 = rowstyle[%d][%d]*
| regexp7 = rowcellstyle[%d][%d]*

即可匹配所有headerNUMlabelNUMdataNUMdataNUMadataNUMbdataNUMc、...、rowcellstyleNUM格式的参数,其中NUM为一段数字。

举例 编辑

{{Infobox
| above = {{{name|}}}

| label1 = Height
| data1 = {{{height|}}}

| label2 = Weight
| data2 = {{{weight|}}}

| label3 = Website
| data3 = {{{website|}}}
}}<!-- 
  end infobox, start tracking
-->{{#invoke:Check for unknown parameters|check
| unknown = [[Category:Some tracking category|_VALUE_]]
| preview = unknown parameter "_VALUE_"
| name
| height | weight
| website
}}


另请参阅 编辑