使用 Stylus 取得樣式

安裝 Stylus 非常容易，只要您有 Node.js 即可。因此，取得您平台的二進位檔，並確定它們也包含 npm，也就是 Node 的套件管理員。

現在，在您的終端機中輸入

# npm
$ npm install stylus -g

# pnpm
$ pnpm add -g stylus

# npm
$ npm install stylus -g

# pnpm
$ pnpm add -g stylus

如果您想要一個具備這些功能或下方列出功能的 Node.js 表達式 CSS 語言，請前往 GitHub 取得更多資訊。

Stylus cli

Stylus 附帶 stylus 可執行檔，用於將 Stylus 轉換為 CSS。

Usage: stylus [options] [command] [< in [> out]]
              [file|dir ...]

Commands:

  help [<type>:]<prop> Opens help info at MDC for <prop> in
                        your default browser. Optionally
                        searches other resources of <type>:
                        safari opera w3c ms caniuse quirksmode

Options:

  -i, --interactive       Start interactive REPL
  -u, --use <path>        Utilize the Stylus plugin at <path>
  -U, --inline            Utilize image inlining via data URI support
  -w, --watch             Watch file(s) for changes and re-compile
  -o, --out <dir>         Output to <dir> when passing files
  -C, --css <src> [dest]  Convert CSS input to Stylus
  -I, --include <path>    Add <path> to lookup paths
  -c, --compress          Compress CSS output
  -d, --compare           Display input along with output
  -f, --firebug           Emits debug infos in the generated CSS that
                          can be used by the FireStylus Firebug plugin
  -l, --line-numbers      Emits comments in the generated CSS
                          indicating the corresponding Stylus line
  -m, --sourcemap         Generates a sourcemap in sourcemaps v3 format
  --sourcemap-inline      Inlines sourcemap with full source text in base64 format
  --sourcemap-root <url>  "sourceRoot" property of the generated sourcemap
  --sourcemap-base <path> Base <path> from which sourcemap and all sources are relative
  -P, --prefix [prefix]   Prefix all css classes
  -p, --print             Print out the compiled CSS
  --import <file>         Import stylus <file>
  --include-css           Include regular CSS on @import
  -D, --deps              Display dependencies of the compiled file
  --disable-cache         Disable caching
  --hoist-atrules         Move @import and @charset to the top
  -r, --resolve-url       Resolve relative urls inside imports
  --resolve-url-nocheck   Like --resolve-url but without file existence check
  -V, --version           Display the version of Stylus
  -h, --help              Display help information

Usage: stylus [options] [command] [< in [> out]]
              [file|dir ...]

Commands:

  help [<type>:]<prop> Opens help info at MDC for <prop> in
                        your default browser. Optionally
                        searches other resources of <type>:
                        safari opera w3c ms caniuse quirksmode

Options:

  -i, --interactive       Start interactive REPL
  -u, --use <path>        Utilize the Stylus plugin at <path>
  -U, --inline            Utilize image inlining via data URI support
  -w, --watch             Watch file(s) for changes and re-compile
  -o, --out <dir>         Output to <dir> when passing files
  -C, --css <src> [dest]  Convert CSS input to Stylus
  -I, --include <path>    Add <path> to lookup paths
  -c, --compress          Compress CSS output
  -d, --compare           Display input along with output
  -f, --firebug           Emits debug infos in the generated CSS that
                          can be used by the FireStylus Firebug plugin
  -l, --line-numbers      Emits comments in the generated CSS
                          indicating the corresponding Stylus line
  -m, --sourcemap         Generates a sourcemap in sourcemaps v3 format
  --sourcemap-inline      Inlines sourcemap with full source text in base64 format
  --sourcemap-root <url>  "sourceRoot" property of the generated sourcemap
  --sourcemap-base <path> Base <path> from which sourcemap and all sources are relative
  -P, --prefix [prefix]   Prefix all css classes
  -p, --print             Print out the compiled CSS
  --import <file>         Import stylus <file>
  --include-css           Include regular CSS on @import
  -D, --deps              Display dependencies of the compiled file
  --disable-cache         Disable caching
  --hoist-atrules         Move @import and @charset to the top
  -r, --resolve-url       Resolve relative urls inside imports
  --resolve-url-nocheck   Like --resolve-url but without file existence check
  -V, --version           Display the version of Stylus
  -h, --help              Display help information

STDIO 編譯範例

stylus 從 stdin 讀取並輸出至 stdout，因此例如

$ stylus --compress < some.styl > some.css

$ stylus --compress < some.styl > some.css

在終端機中嘗試 Stylus！在下方輸入並按下 CTRL-D 以取得 __EOF__

$ stylus
body
  color red
  font 14px Arial, sans-serif

$ stylus
body
  color red
  font 14px Arial, sans-serif

編譯檔案範例

stylus 也接受檔案和目錄。例如，名為 css 的目錄將編譯並在同一個目錄中輸出 .css 檔案。

$ stylus css

$ stylus css

以下將輸出至 ./public/stylesheets

$ stylus css --out public/stylesheets

$ stylus css --out public/stylesheets

或幾個檔案

$ stylus one.styl two.styl

$ stylus one.styl two.styl

在開發期間，您可以使用 linenos 選項來發出註解，指出產生的 CSS 中的 Stylus 檔名和行號

$ stylus --line-numbers <path>

$ stylus --line-numbers <path>

或 firebug 選項，如果您想要使用 Firebug 的 FireStylus 擴充功能

$ stylus --firebug <path>

$ stylus --firebug <path>

為類別加上前綴

stylus 可執行檔提供一種方法，可用 --prefix 選項加上指定的 [prefix] 為所有產生的樣式加上前綴，

$ stylus --prefix foo-

$ stylus --prefix foo-

用於此程式碼

.bar
  width: 10px

.bar
  width: 10px

會產生

.foo-bar {
  width: 10px;
}

.foo-bar {
  width: 10px;
}

所有類別都會加上前綴：內插、擴充等。

轉換 CSS

如果您想將 CSS 轉換為簡潔的 Stylus 語法，請使用 --css 旗標。

透過 stdio

$ stylus --css < test.css > test.styl

$ stylus --css < test.css > test.styl

輸出與基本檔名相同的 .styl 檔案

$ stylus --css test.css

$ stylus --css test.css

輸出到特定目的地

$ stylus --css test.css /tmp/out.styl

$ stylus --css test.css /tmp/out.styl

CSS 屬性說明

在 OS X 上，stylus help <prop> 會開啟您的預設瀏覽器，並顯示指定 <prop> 的說明文件。

$ stylus help box-shadow

$ stylus help box-shadow

互動式殼層

Stylus REPL（讀取-評估-列印-迴圈）或「互動式殼層」讓您可直接從終端機使用 Stylus 表達式。

請注意，這僅適用於表達式，不適用於選擇器等。若要使用，請簡單新增 -i 或 --interactive 旗標

$ stylus -i
> color = white
=> #fff
> color - rgb(200,50,0)
=> #37cdff
> color
=> #fff
> color -= rgb(200,50,0)
=> #37cdff
> color
=> #37cdff
> rgba(color, 0.5)
=> rgba(55,205,255,0.5)

$ stylus -i
> color = white
=> #fff
> color - rgb(200,50,0)
=> #37cdff
> color
=> #fff
> color -= rgb(200,50,0)
=> #37cdff
> color
=> #37cdff
> rgba(color, 0.5)
=> rgba(55,205,255,0.5)

解析匯入中的相對網址

預設情況下，Stylus 不會解析匯入的 .styl 檔案中的網址，因此如果您碰巧有一個 foo.styl 檔案，其中包含 @import "bar/bar.styl"，而該檔案中包含 url("baz.png")，則在產生的 CSS 中也會是 url("baz.png")。

但是，您可以使用 --resolve-url（或僅 -r）選項來變更此行為，以便在產生的 CSS 中取得 url("bar/baz.png")。

列出相依性

你可以使用 --deps（或僅 -D）旗標取得已編譯檔案的相依性清單。

例如，假設我們有 test.styl

@import 'foo'
@import 'bar'

@import 'foo'
@import 'bar'

而在 foo.styl 內部

@import 'baz'

@import 'baz'

執行

$ stylus --deps test.styl

$ stylus --deps test.styl

將會提供給我們匯入路徑清單

foo.styl
baz.styl
bar.styl

foo.styl
baz.styl
bar.styl

請注意，目前這不適用於動態產生的路徑.

使用外掛

對於這個範例，我們將使用 nib Stylus 外掛來說明其 CLI 用法。

假設我們有下列 Stylus，它匯入 nib 來使用其 linear-gradient() 函式。

@import 'nib'

body
  background: linear-gradient(20px top, white, black)

@import 'nib'

body
  background: linear-gradient(20px top, white, black)

我們第一次嘗試透過 stdio 使用 stylus(1) 進行渲染可能會像這樣

$ stylus < test.styl

$ stylus < test.styl

這將會產生下列錯誤（因為 Stylus 不知道在哪裡可以找到 nib）。

Error: stdin:3
  1|
  2|
> 3| @import 'nib'
  4|
  5| body
  6|   background: linear-gradient(20px top, white, black)

Error: stdin:3
  1|
  2|
> 3| @import 'nib'
  4|
  5| body
  6|   background: linear-gradient(20px top, white, black)

對於僅提供 Stylus API 的外掛，我們可以將路徑新增至 Stylus 查詢路徑。我們使用 --include 或 -I 旗標來執行此動作

$ stylus < test.styl --include ../nib/lib

$ stylus < test.styl --include ../nib/lib

現在產生下列輸出。（正如你可能注意到的，對 gradient-data-uri() 和 create-gradient-image() 的呼叫輸出為字面值。這是因為當外掛提供 JavaScript API 時，公開函式庫路徑是不夠的。然而，如果我們僅想使用純 Stylus nib 函式，我們會沒問題。）

body {
  background: url(gradient-data-uri(create-gradient-image(20px, top)));
  background: -webkit-gradient(linear, left top, left bottom, color-stop(0, #fff), color-stop(1, #000));
  background: -webkit-linear-gradient(top, #fff 0%, #000 100%);
  background: -moz-linear-gradient(top, #fff 0%, #000 100%);
  background: linear-gradient(top, #fff 0%, #000 100%);
}

body {
  background: url(gradient-data-uri(create-gradient-image(20px, top)));
  background: -webkit-gradient(linear, left top, left bottom, color-stop(0, #fff), color-stop(1, #000));
  background: -webkit-linear-gradient(top, #fff 0%, #000 100%);
  background: -moz-linear-gradient(top, #fff 0%, #000 100%);
  background: linear-gradient(top, #fff 0%, #000 100%);
}

因此，我們需要做的是使用 --use 或 -u 旗標。它預期一個節點模組的路徑（有或沒有 .js 副檔名）。這個 require() 模組預期一個函式會作為 module.exports 匯出，然後呼叫 style.use(fn()) 來公開外掛（定義其 js 函式等）。

$ stylus < test.styl --use ../nib/lib/nib

$ stylus < test.styl --use ../nib/lib/nib

產生預期的結果

body {
  background: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAUCAYAAABMDlehAAAABmJLR0QA/wD/AP+gvaeTAAAAI0lEQVQImWP4+fPnf6bPnz8zMH358oUBwkIjKJBgYGNj+w8Aphk4blt0EcMAAAAASUVORK5CYII=");
  background: -webkit-gradient(linear, left top, left bottom, color-stop(0, #fff), color-stop(1, #000));
  background: -webkit-linear-gradient(top, #fff 0%, #000 100%);
  background: -moz-linear-gradient(top, #fff 0%, #000 100%);
  background: linear-gradient(top, #fff 0%, #000 100%);
}

body {
  background: url("data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAAUCAYAAABMDlehAAAABmJLR0QA/wD/AP+gvaeTAAAAI0lEQVQImWP4+fPnf6bPnz8zMH358oUBwkIjKJBgYGNj+w8Aphk4blt0EcMAAAAASUVORK5CYII=");
  background: -webkit-gradient(linear, left top, left bottom, color-stop(0, #fff), color-stop(1, #000));
  background: -webkit-linear-gradient(top, #fff 0%, #000 100%);
  background: -moz-linear-gradient(top, #fff 0%, #000 100%);
  background: linear-gradient(top, #fff 0%, #000 100%);
}

如果您需要將參數傳遞給外掛程式，請使用 --with 選項。--with 會評估任何有效的 javascript 表達式，並將其值傳遞給外掛程式。例如

$ stylus < test.styl --use ../node_modules/autoprefixer-stylus --with "{ browsers: ['ie 7', 'ie 8'] }"

$ stylus < test.styl --use ../node_modules/autoprefixer-stylus --with "{ browsers: ['ie 7', 'ie 8'] }"

使用 Stylus 取得樣式 #

Stylus cli #

STDIO 編譯範例 #

編譯檔案範例 #

為類別加上前綴 #

轉換 CSS #

CSS 屬性說明 #

互動式殼層 #

解析匯入中的相對網址 #

列出相依性 #

使用外掛 #