模組: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: 調用輪展模塊

效果：

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

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

可選參數

效果：

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

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

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

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