FANDOM


添加侧栏模块可以让您将自定义模块添加到您wiki的侧栏中。默认情况下,脚本会将存储在Template:RailModule的内容添加到侧栏底部(在循环模块的上方)。通过配置,您可以添加多个模块,最多可以将两个模块添加到侧栏顶部(在顶部广告模块的下方)。每个模块都包装在一个section.railModule.rail-module中。

侧栏模块的数量和高度是有限制的。添加的侧栏模块整体高度不能高于普通侧栏模块。新增侧栏模块的外形大小和整体高度不应高于常规侧栏模块的外形大小和高度。另外,只允许一个侧栏模块位于(预先设置的)最近Wiki活动模块的上方。

安装方法

配置

想要将Template:RailModule的内容作为模块添加到侧栏顶部,请添加以下内容:

window.AddRailModule = [{prepend: true}];

想要向侧栏底部添加多个模块(例如:Template:甲Template:乙Template:丙的内容),请添加以下内容:

window.AddRailModule = ['Template:甲', 'Template:乙', 'Template:丙'];

想要同时向侧栏顶部和底部添加多个模块,请添加以下内容:

window.AddRailModule = [
    {page: 'Template:甲', prepend: true},
    'Template:乙',
    'Template:丙',
];

注意:如果您向侧栏顶部添加了两个以上的模块,那么只有您设置添加的前两个模块会被允许添加。

window.AddRailModule = [
    {page: 'Template:甲', prepend: true},  // 没有问题
    {page: 'Template:乙', prepend: true},  // 没有问题
    {page: 'Template:丙', prepend: true},  // 问题很大,不会添加到侧栏顶部而会添加到侧栏底部
];

每个模块的内容最多可以缓存maxAge秒,默认为300秒(5分钟)。如果您的模块是短暂性的,例如:模块内容需要保持最新(比如投票)、模块内容随机或依赖页面名称变量(比如{{PAGENAME}}),那么请设置maxAge为0秒。相反,如果您的模块是长效性的,可以设置maxAge为86400秒(1天)。

window.AddRailModule = [
    {page: 'Template:随机问候语', prepend: true, maxAge: 0},
    {page: 'Template:常见问题解答', maxAge: 86400},
];

在Fandom Developers Wiki的脚本中使用配置选项

这个页面是用来说明介绍如何在脚本中使用配置选项。在Fandom Developers Wiki上,许多脚本提供了可选配置设置,以更改或增强脚本的默认行为。在JavaScript文件中安装配置选项时,请注意要将其放置于导入(import)语句之外才会正常运作(除非另有说明)。 如果使用MediaWiki:ImportJS加载脚本,其将被最后加载

配置选项加载缓慢,无法运作
// 1. AjaxRC import statement
importScriptPage('AjaxRC/code.js','dev');
 
// 2. AjaxRC configuration option
var ajaxRefresh = 30000;
正确放置配置选项
// 1. AjaxRC configuration option
var ajaxRefresh = 30000;
 
// 2. AjaxRC import statement
importScriptPage('AjaxRC/code.js','dev');

样式

要针对所有自定义模块,请使用选择器.railModule

要针对特定的自定义模块,可以考虑在您的模板中将每个模块的内容包装在自己独特的容器元素中,然后选择这个元素来代替。

高级用法

如果您的模块使用了像<gallery/><twitter/>这样的解析器扩展标签,您可能会发现其解析器扩展标签无法正常加载。如果是这种情况,请检查其解析器扩展标签是否列在Rewire § Support中,如果列入其中,您可以将dev:Rewire.js添加到您wiki的MediaWiki:ImportJS页面中。

Community content is available under CC-BY-SA unless otherwise noted.

Fandom may earn an affiliate commission on sales made from links on this page.

Stream the best stories.

Fandom may earn an affiliate commission on sales made from links on this page.

Get Disney+