模組:Carousel/doc

頁面輪展模塊，可用於首頁特色條目、優良條目展示。

用法

Step 1: 創建JSON頁面

首先，需要創建一個JSON頁面，其中記錄了要輪展嵌入的頁面，以及輪展的順序。以下是一個例子（User:PhiLiP/carousel-example.json）：

[
    {
        "title": "1689年波士顿起义",
        "displayTimeRanges": [
            [
                20150304123013,
                null
            ]
        ]
    },
    {
    	"title": "孔子鸟属",
    	"displayTimeRanges": [
    		[20060313005324, 20090614110222]
    	]
    },
    {
        "title": "1850年大西洋飓风季",
        "displayTimeRanges": [
            [
                20141030151730,
                null
            ]
        ]
    },
    {
        "title": "1873年铸币法案",
        "displayTimeRanges": [
            [
                20160805143015,
                null
            ]
        ]
    },
    {
        "title": "1880年民主党全国大会",
        "displayTimeRanges": [
            [
                20141213150114,
                null
            ]
        ]
    }
]

Step 2: 調用輪展模塊

效果：

1689年波士頓起義是一場發生在1689年4月18日的起義，旨在反對新英格蘭自治領總督埃德蒙·安德羅斯爵士的統治。在自治領民兵和波士頓市民的精心組織下，「暴民」在城內逮捕自治領官員。被清教徒認為支持自治領政府統治的英國聖公會教徒也遭拘捕。不過這次起義期間雙邊都沒有出現人員傷亡。前馬薩諸塞灣殖民地的領導人重新取得政府控制權。之前被自治領政府撤職的其他殖民地政府官員重新掌握了權力。1686年獲命成為自治領總督的安德羅斯上任後無視地方代表權、對鎮民大會設限、積極推行聖公會、強制執行航海法案，還否認馬薩諸塞殖民地已有土地所有權的合法性，種種極其不得人心的行徑和英國發生的光榮革命共同影響，導致殖民地清教徒決定揭竿而起，推翻他的統治。

在要顯示輪展內容的位置，按下述方式調用模塊：

{{#invoke:Carousel|main|candidateList=User:PhiLiP/carousel-example.json}}

可選參數

效果：

（當前時間戳為20241116065829，顯示第3條）

除了candidateList外，有兩個可選參數timeStart和timeInterval。timeStart定義輪展的起始時間（以MediaWiki時間戳規定的UTC時間，默認值19700101000000，即UTC時間1970年1月1日0時0分0秒）；timeInterval定義每輪展示的秒數（默認值86400秒，即1天）。下為示例：

（從UTC時間2024年11月16日0時0分0秒起，每小時更換一次。）

{{#invoke:Carousel|main|candidateList=User:PhiLiP/carousel-example.json|timeStart=20241116000000|timeInterval=3600}}