模板文档    什么是模板? 编辑 刷新
本模板调用模块:Item/Link来生成物品链接。

请在维基中生成指向物品页的链接时使用本模板。

如果是在其他模块中调用,请点击此处参考说明

如果指定显示的ID或是中文名是货币的话,将会转而调用模板:货币

使用中文名进行调用时,每调用一次模板,都会进行一次数据查询,Mediawiki为了保证页面性能,每个页面限制了调用的数量为100个。如果单页调用大量物品时,应该通过存储、查询数据的方式减少数据查询次数。

调用模板使用

基本语法:

{{物品|物品中文名或ID|参数1|参数2|参数3...}}

可用参数:

参数 说明
中文名或ID 必填,可以直接填写,也可以写成name=中文名名称=中文名ID=物品编号
hqhq=1 如果物品存在HQ版,则显示物品HQ版的图标,并添加HQ标记
size=xx 目前只支持20和40,不是这2个值的话,会强制使用20
noicon 不生成物品的图标,只生成名称(可以包括HQ标记和数量)
noname 不生成物品的名称(所以也不会生成名称中的HQ标记、类型、等级等)
nodetail 不生成物品的细节(只对20以上的模式有效,包括例如类型、等级之类的信息)
nolink 不生成链接
nott 不弹出物品相信信息的浮层
#xxx 生成数量信息
blockdisplay=block 默认生成的div为display:inline-block,如果需要block形式的请填写此参数
css=xxx 可以为最外层div额外添加inline-style
first 在“size=20并且显示图标的情况”下,会默认有一个padding-left:4px;,以使图标与前面的文字有一些间隔。如果物品链接出现在行首第一位的话,请添加该参数来消除这个内边距。
td 当该物品链接出现在td标签内时,可以通过该参数,添加一个margin-bottom:-7px;来消除inline-block在td内出现的额外下内边距。该参数暂时处于测试中

例子:

示例代码 运行效果 说明
{{物品|重合金战斧}} 060051.png重合金战斧 使用名称调用
{{物品|16629}} 060051.png未知物品 使用物品编号调用
{{物品|重合金战斧}} 这是060051.png重合金战斧哟! 物品链接前面会有内边距来与前面的文字有所间隔
{{物品|重合金战斧}} 060051.png重合金战斧
上面是一把重合金战斧的链接。
因为上述内边距,导致图标处于行首时,无法与下一行的首字对齐
{{物品|重合金战斧|first}} 060051.png重合金战斧
上面是一把重合金战斧的链接。
使用first消除了上述内边距
{{物品|重合金战斧|hq}} 060051.png重合金战斧 显示HQ版本的该物品
{{物品|重合金战斧|hq|#5}} 060051.png重合金战斧 ×5 带数量显示
{{物品|重合金战斧|hq|#5|noname}} 060051.png ×5 不显示名称,只显示图标
{{物品|重合金战斧|size=40}} 40px版本的该物品链接
{{物品|重合金战斧|size=40|hq}} 40px + HQ版本的该物品,可以看到该单元格内部下方有明显多余的内边距,这是因为td内显示display:inline-block造成的,在td标签内使用时,最好使用display:block
{{物品|重合金战斧|size=40|block|hq}} 使用display:block模式就正常了。不过在某些旧浏览器中,td中使用block模式时,会因为block的默认width是100%,整个td标签内都会变成链接。如果不希望这样的话,也可以参考下面的方法添加负数的margin-bottom
{{物品|重合金战斧|size=40|css=margin-bottom:-7px;|hq}} 使用负数的margin-bottom的效果。请根据需要自行调节
{{物品|重合金战斧|size=40|td|hq}} 这个测试中的参数td也会起到同样的效果(但现在不确认是否所有情况下都是-7px)
{{物品|重合金战斧|size=40|block|hq|nodetail}} 不需要显示细节,只需要显示名字的时候
{{物品|重合金战斧|size=40|block|hq|#4}} 带数量显示
{{物品|重合金战斧|size=40|block|hq|#4|noname}} 不显示名称(同时也不显示括类型和等级)

在模块中使用

如果需要在模块中生成指向物品页的链接,可以使用下面的方法

其中item_args是类似模板中传入的参数。使用模块调用时,可以额外以“data”为键值,传入已经查询好的物品数据(如果这样的话,可以省略中文名),避免二次查询,节省服务器资源

local item_link = require('Module:Item/Link').item_link
local item_args = {
	'中文名',
	'hq',
	size=40,
	'noicon',
	'noname',
	'nodetail',
	'nolink',
	'#10',
	data={
		['中文名']='',
		['ID']='',
		['HQ']='',
		['中文名']='',
		['图标ID']='',
		['图标']='',
		['图标HQ']='',
		['主类型ID']='',
		['装备等级']='',
		['类型']='',
		['品级']='',
	}
}

local item_link_html = item_link(args)
进入 模板:物品/doc 页面来编辑这个模板的说明文档。(这个说明框是怎么回事?)
修改完毕后,请刷新上面的文本。(为什么?
avatar