阿西河

所有教程

公众号
🌙
阿西河前端的公众号

我的收藏

    最近访问  (文章)

      教程列表

      抓包专区
      测试专区

      PostCSS 和 Source Maps

      PostCSS 和 Source Maps

      PostCSS 对 source maps 支持很好。它能够读取和解析从之前转换步骤生成的映射,自动检测你期望的格式,并且输出外联和内联映射。

      为了保证你生成准确的 source map (源码映射),你必须写明输入与输出的 CSS 文件路径 —— 分别使用 fromto 参数。

      如果用默认配置生成新的源码映射,只要设置 map: true 即可。这会生成一个内联的源码映射,包含源码的内容。如果你不想将映射内联,你可以设置 map.inline: false.

      processor
        .process(css, {
          from: 'app.sass.css',
          to:   'app.css',
          map: { inline: false }
        })
        .then(result => {
            result.map //=> '{ "version":3,
                       //      "file":"app.css",
                       //      "sources":["app.sass"],
                       //       "mappings":"AAAA,KAAI" }'
        })
      

      如果 PostCSS 从之前的转变中发现源码映射,它会自动用同样的配置更新源码映射。

      配置

      如果你想要对源码映射的生成有更多的控制,可以定义一个 map 对象作为配置,并配置以下的参数:

      • inline boolean: 表明源码映射会以 Base64 编码注释的方式被内置到输出的 CSS 中。该参数默认为 true。 但如果先前的所有映射都是外联而不是内联的,那么 PostCSS 则不会内置映射即使你不设置这个参数。

        如果你有一个内联的资源映射,那么 result.map 属性则会为空,因为源码映射被包含在 result.css 的文本中。

      • prev string, object, boolean or function: 源码映射来自先前的处理步骤(例如,Sass 编译)。 PostCSS 将尝试自动读取之前的源码映射(基于源 CSS 中的注释),但您可以使用此配置来手动识别它。如果需要,您可以省略以前的源码映射,使用 prev:false 参数。

      • sourcesContent boolean: 表示 PostCSS 应设置源码映射的源内容(例如,Sass 源)。默认值为 true 。 但如果以前的所有源码映射都不包含源内容,即使您没有设置此配置,PostCSS 也会将其忽略。

      • annotation boolean or string: 表示 PostCSS 应添加注释评论到 CSS 中。默认情况下,PostCSS 将始终添加带路径的注释 到源码映射。 PostCSS 不会为没包含任何评论的 CSS 文件添加注释。

        默认情况下,PostCSS 假定您要将源码映射另存为到 opts.to +'.map' 并将在注释注释中使用此路径。 可以通过为 annotation 提供字符串值来设置不同的路径。

        如果你设置 inline: true, 那么注释则无法禁用。

      • from string: 默认情况下,PostCSS 将设置映射的 sources 属性为 from 选项的值。如果要覆写此行为,则你可以使用 map.from 来显式设置源码映射的 sources 属性。路径应该是生成文件的绝对或相对路径(process() 方法中的 to 选项)。

      目录
      目录