MediaList

Baseline 已廣泛支援

此特性已相當成熟，可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來，各瀏覽器均已提供此特性。

MediaList 介面表示樣式表的媒體查詢，例如透過 <link> 元素的 media 屬性設定的那些。

注意：MediaList 是一個即時列表；使用下方列出的屬性或方法更新列表將立即更新文件的行為。

例項屬性

MediaList.mediaText: 一個 stringifier，它返回表示 MediaList 的文字字串，並且還允許您設定一個新的 MediaList。
MediaList.length 只讀: 返回 MediaList 中媒體查詢的數量。

MediaList.appendMedium(): 將媒體查詢新增到 MediaList。
MediaList.deleteMedium(): 從 MediaList 中移除媒體查詢。
MediaList.item(): 一個 getter，它接收媒體查詢在 MediaList 中的索引值，並返回表示該媒體查詢的文字字串。此方法也可以使用方括號 ([]) 語法呼叫。
MediaList.toString(): 返回此媒體列表的字串表示形式，格式與物件的 MediaList.mediaText 屬性相同。

以下內容會將應用於當前文件的第一個樣式表的 MediaList 的文字表示形式記錄到控制檯。

const stylesheets = document.styleSheets;
let stylesheet = stylesheets[0];
console.log(stylesheet.media.mediaText);

規範
CSS 物件模型 (CSSOM) # the-medialist-interface

此頁面最後修改於 2025年6月24日，由 MDN 貢獻者編輯。