重大變更:重複的變數旗標

變數只允許單個 !global!default 旗標。重複的旗標從未產生任何額外效果,這只是為了確保樣式表更加一致。

階段 1階段 1 永久連結

相容性
Dart Sass
自 2.0.0 起
LibSass
Ruby Sass

從 Dart Sass 2.0.0 開始,如果單個變數宣告中包含多個 !global!default 旗標,則會產生語法錯誤。這表示 $var: value !default !default 將會被禁止。$var: value !global !default 仍然允許。

過渡期過渡期永久連結

相容性
Dart Sass
自 1.62.0 起
LibSass
Ruby Sass

在 Dart Sass 2.0.0 發布之前,多個旗標只會產生棄用警告。

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

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

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

預設情況下,Sass 以簡潔模式運行,其中每種類型的棄用警告只會打印五次,之後就會靜默其他警告。這有助於確保使用者知道何時需要注意即將發生的重大變更,而不會產生大量的控制台 訊息。

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

⚠️ 注意!

JS API 執行時,Sass 不會在編譯之間共享任何資訊,因此預設情況下,它會針對*每個*編譯的樣式表打印五次警告。 但是,您可以通過編寫(或請您最喜歡的框架 Sass 插件的作者編寫)一個 自訂 Logger 來解決此問題,該記錄器每個棄用只打印五次錯誤,並且可以在多個 編譯之間共用。

靜默依賴項中的棄用警告靜默依賴項中的棄用警告 永久連結

有時,您的依賴項中會有一些您無能為力的棄用警告。您可以使用命令列上的 --quiet-deps 旗標 或 JavaScript API 中的 quietDeps 選項 來靜默依賴項中的棄用警告,同時仍然為您的應用程式打印它們。

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

靜默特定棄用警告靜默特定棄用警告 永久連結

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