MediaWiki API 說明
此頁為自動產生的 MediaWiki API 說明文件頁面。
說明文件與範例:https://www.mediawiki.org/wiki/Special:MyLanguage/API:Main_page
list=categorymembers (cm)
- 此模組需要讀取權限。
- 此模組可作為產生器使用。
- 來源:MediaWiki
- 授權條款:GPL-2.0-or-later
在指定的分類中列出所有頁面。
參數:
- cmtitle
所要列舉的分類(必要)。必須包含 分類: 前綴。不可與 cmpageid 一同使用。
- cmpageid
要列舉的分類之頁面 ID。不能與 cmtitle 同時使用。
- 類型:整數
- cmprop
要包含的資訊部份:
- ids
- 添加頁面 ID。
- title
- 添加標題與頁面的命名空間 ID。
- sortkey
- 添加使用來在分類裡排序的排序鍵值(十六進位字串)。
- sortkeyprefix
- 添加用於在分類裡排序的排序鍵值字首(排序鍵值中人類可讀的部份)。
- type
- 添加頁面已被分類的類型(page、subcat 或 file)。
- timestamp
- 添加在頁面有被包含時的時間戳記。
- 多值 (以 | 或 alternative 分隔):ids、sortkey、sortkeyprefix、timestamp、title、type
- 預設值:ids|title
- cmnamespace
僅包含在這些命名空間的頁面。請注意可能會使用 cmtype=subcat 或 cmtype=file,而非 cmnamespace=14 或 6。
- 多值 (以 | 或 alternative 分隔):0、1、2、3、4、5、6、7、8、9、10、11、12、13、14、15
- 要指定所有值,請使用*。
- cmtype
包含的分類成員類型。當有設定 cmsort=timestamp 時忽略。
- 多值 (以 | 或 alternative 分隔):file、page、subcat
- 預設值:page|subcat|file
- cmcontinue
當有更多結果可用時,使用這個繼續。
- cmlimit
回傳的頁面數量上限。
- 類型:整數或max
- 數值必須在 1 與 500 之間。
- 預設值:10
- cmsort
作為排序順序的屬性。
- 單值:sortkey、timestamp
- 預設值:sortkey
- cmdir
排序的方向。
- 單值:asc、ascending、desc、descending、newer、older
- 預設值:ascending
- cmstart
起始列出的時間戳記。僅能與 cmsort=timestamp 一起使用。
- 類型:時間戳記(允許格式)
- cmend
結束列出的時間戳記。僅能與 cmsort=timestamp 一起使用。
- 類型:時間戳記(允許格式)
- cmstarthexsortkey
開始列出的排序鍵值,由 cmprop=sortkey 所回傳。僅能與 cmsort=sortkey 一起使用。
- cmendhexsortkey
終止列出的排序鍵值,由 cmprop=sortkey 所回傳。僅能與 cmsort=sortkey 一起使用。
- cmstartsortkeyprefix
開始列出的排序鍵值字首,僅能與 cmsort=sortkey 一起使用。覆蓋 cmstarthexsortkey。
- cmendsortkeyprefix
終止列出 before 的排序鍵值字首(並不是 at,若此值有出現將不會被包含到!),僅能與 cmsort=sortkey 一起使用。覆蓋 cmendhexsortkey。
- cmstartsortkey
- 已棄用。
請改用 cmstarthexsortkey。
- cmendsortkey
- 已棄用。
請改用 cmendhexsortkey。
範例:
- 取得在 Category:Physics 裡前 10 項的頁面。
- api.php?action=query&list=categorymembers&cmtitle=Category:Physics [在沙盒中開啟]
- 取得在 Category:Physics 裡前 10 個頁面的頁面資訊。
- api.php?action=query&generator=categorymembers&gcmtitle=Category:Physics&prop=info [在沙盒中開啟]