重大變更:-moz-document

Firefox 過去有一個 @-moz-document 規則需要特殊的解析方式。由於 Firefox 已移除對它的支援,Sass 也正在移除對其解析的支援。

Sass 長期以來一直支援對 @-moz-document 規則的特殊解析。由於 Firefox 已停止支援,Sass 也將停止支援特殊解析,並將其視為未知的 at-規則。

有一個例外:空的 url 前綴函式仍然允許,因為它用於針對 Firefox 的 hack。

程式碼遊樂場

SCSS 語法

@-moz-document url-prefix() {
  .error {
    color: red;
  }
}
程式碼遊樂場

Sass 語法

@-moz-document url-prefix()
  .error
    color: red


CSS 輸出

@-moz-document url-prefix() {
  .error {
    color: red;
  }
}

過渡期過渡期永久連結

相容性
Dart Sass
自 1.7.2 起
LibSass
Ruby Sass

首先,我們會針對所有 @-moz-document 的使用發出棄用警告,但空的 url-prefix hack 除外。

在 Dart Sass 2.0 中,@-moz-document 將被視為未知的 at-規則。

我可以隱藏警告嗎?我可以隱藏警告嗎? 永久連結

Sass 提供了一套強大的選項,用於管理您看到的棄用警告以及何時看到它們。

簡潔模式和詳細模式簡潔模式和詳細模式 永久連結

Sass 預設以簡潔模式執行,每種類型的棄用警告只會印出五次,之後就會停止顯示更多警告。這有助於確保使用者在不會產生大量控制台訊息的情況下,了解即將發生的重大變更。

如果您以詳細模式執行 Sass,它會印出遇到的*每個*棄用警告。這在修正棄用問題時,對於追蹤剩餘工作非常有用。您可以使用命令列上的 --verbose 旗標 或 JavaScript API 中的 verbose 選項 來啟用詳細模式。

⚠️ 注意!

JS API 執行時,Sass 不會在編譯之間共用任何資訊,因此預設會針對*每個*編譯的樣式表印出五次警告。然而,您可以透過編寫(或請您最愛框架的 Sass 外觀作者編寫)一個 自訂 Logger 來解決此問題,該記錄器每個棄用警告只印出五次錯誤,並且可以在多個編譯之間共用。

隱藏 dependencies 中的棄用警告隱藏 dependencies 中的棄用警告 永久連結

有時,您的 dependencies 會有一些您無法處理的棄用警告。您可以使用命令列上的 --quiet-deps 旗標 或 JavaScript API 中的 quietDeps 選項 來隱藏 dependencies 的棄用警告,同時仍然印出您應用程式中的棄用警告。

就這個旗標而言,「dependency」是指任何並非僅由入口點樣式表一系列相對載入而來的樣式表。這表示任何來自載入路徑的內容,以及大多數透過自訂匯入器載入的樣式表。

隱藏特定棄用警告隱藏特定棄用警告 永久連結

如果您知道某個特定棄用警告對您來說不是問題,您可以使用命令列上的 --silence-deprecation 旗標 或 JavaScript API 中的 silenceDeprecations 選項 來隱藏該特定棄用警告的警告。