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

效果：

1850年大西洋颶風季是美國國家颶風中心建立的大西洋颶風資料庫中未予收錄的最近一個大西洋颶風季。雖然這年的氣象有欠完整，但仍然有三場熱帶氣旋對陸地構成顯著影響，每場都造成一定程度的破壞。其中第一個系統於7月18日吹襲北卡羅萊納州，造成嚴重破壞後又給大西洋地區帶去高漲的海潮和狂風暴雨。8月22日，古巴哈瓦那受到一場強烈颶風的衝擊，摧毀果林的同時還擾亂了航運，接下來又在佛羅里達州西北狹長地帶登陸並帶去了高漲的風暴潮。海上有一艘引水船因海況惡劣導致與大船相撞並沉沒。9月7到8日，紐約州到鱈魚角受到一場颶風的衝擊，產生陣風和可觀降水，造成許多船隻遇險。

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

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

可選參數

效果：

（當前時間戳為20240517012824，顯示第2條）

1850年大西洋颶風季是美國國家颶風中心建立的大西洋颶風資料庫中未予收錄的最近一個大西洋颶風季。雖然這年的氣象有欠完整，但仍然有三場熱帶氣旋對陸地構成顯著影響，每場都造成一定程度的破壞。其中第一個系統於7月18日吹襲北卡羅萊納州，造成嚴重破壞後又給大西洋地區帶去高漲的海潮和狂風暴雨。8月22日，古巴哈瓦那受到一場強烈颶風的衝擊，摧毀果林的同時還擾亂了航運，接下來又在佛羅里達州西北狹長地帶登陸並帶去了高漲的風暴潮。海上有一艘引水船因海況惡劣導致與大船相撞並沉沒。9月7到8日，紐約州到鱈魚角受到一場颶風的衝擊，產生陣風和可觀降水，造成許多船隻遇險。

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

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

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