Mercurial > nebulaweb3

comparison default/assets/scss/vendors/bourbon/library/_font-face.scss @ 0:1d038bc9b3d2 default tip

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
Up:default
author Liny <dev@neowd.com>
date Sat, 31 May 2025 09:21:51 +0800
parents
children
comparison
equal deleted inserted replaced
-1:000000000000 0:1d038bc9b3d2
1 @charset "UTF-8";
2
3 /// Generates an `@font-face` declaration. You can choose the specific file
4 /// formats you need to output; the mixin supports `eot`, `ttf`, `svg`, `woff2`
5 /// and `woff`. The mixin also supports usage with the Rails Asset Pipeline,
6 /// which you can enable per use, or globally in the `$bourbon()` settings.
7 ///
8 /// @argument {string} $font-family
9 ///
10 /// @argument {string} $file-path
11 ///
12 /// @argument {string} $asset-pipeline [false]
13 /// Set to `true` if you’re using the Rails Asset Pipeline (place the fonts
14 /// in `app/assets/fonts/`).
15 ///
16 /// @argument {string | list} $file-formats [("ttf", "woff2", "woff")]
17 /// Pass a list of file formats to support,
18 /// for example ("eot", "ttf", "svg", "woff2", "woff").
19 ///
20 /// @content
21 /// Any additional CSS properties that are included in the `@include`
22 /// directive will be output within the `@font-face` declaration, e.g. you can
23 /// pass in `font-weight`, `font-style` and/or `unicode-range`.
24 ///
25 /// @example scss
26 /// @include font-face(
27 /// "source-sans-pro",
28 /// "fonts/source-sans-pro-regular",
29 /// ("woff2", "woff")
30 /// ) {
31 /// font-style: normal;
32 /// font-weight: 400;
33 /// }
34 ///
35 /// // CSS Output
36 /// @font-face {
37 /// font-family: "source-sans-pro";
38 /// src: url("fonts/source-sans-pro-regular.woff2") format("woff2"),
39 /// url("fonts/source-sans-pro-regular.woff") format("woff");
40 /// font-style: normal;
41 /// font-weight: 400;
42 /// }
43 ///
44 /// @require {function} _font-source-declaration
45 ///
46 /// @require {function} _retrieve-bourbon-setting
47
48 @mixin font-face(
49 $font-family,
50 $file-path,
51 $file-formats: _retrieve-bourbon-setting("global-font-file-formats"),
52 $asset-pipeline: _retrieve-bourbon-setting("rails-asset-pipeline")
53 ) {
54
55 @font-face {
56 font-family: $font-family;
57 src: _font-source-declaration(
58 $font-family,
59 $file-path,
60 $asset-pipeline,
61 $file-formats
62 );
63 @content;
64 }
65 }