git地址:开发一个psotcss插件
节点类型
postcss会将我们的css生成ast,然后会去遍历它,在遍历的过程中会传给我们一些不同类型的节点对象,我们主要需要了解的几个类型:
-
css ast主要有3种父类型
- AtRule: @xxx的这种类型,如@screen
- Comment: 注释
- Rule: 普通的css规则
-
还有几个个比较重要的子类型:
- decl: 指的是每条具体的css规则
- rule:作用于某个选择器上的css规则集合
这是test的地方的,不熟悉ast的可以先了解一下:css ast结构
postCss操作方法
postCss为我们提供了一些方便的操作方法
遍历
- walk: 遍历所有节点信息,无论是atRule、rule、comment的父类型,还是rule、 decl的子类型
- walkAtRules:遍历所有的atRule
- walkComments:遍历所有的注释节点
- walkDecls:遍历所以的属性
-
walkRules:遍历所有的css代码块
root.walkDecls(decl => { decl.prop = decl.prop.split('').reverse().join(''); });
postcss在遍历的过程中,会将当前遍历的对象的cell传给回调函数,该参数是对应的rule,decl或者comment等Constructor等构造函数的实例,根据遍历的节点不同,该实例可能会有如下属性:
-
nodes: css规则的节点信息集合
-
decl: 每条css规则的节点信息
- prop: 样式名,如width
- value: 样式值, 如10px
-
- type: 类型
- source: 包括start和end的位置信息,start和end里都有line和* column表示行和列
- selector: type为rule时的选择器
- name: type为atRule时@紧接rule名,譬如@import 'xxx.css'中的import
- params: type为atRule时@紧接rule名后的值,譬如@import 'xxx.css'中的xxx.css
- text: type为comment时的注释内容
同样还有继承的一些方法,给我操作css的, 比如操作每条具体css属性的declaration:
after
before
cleanRaws
clone
cloneAfter
cloneBefore
error
next
prev
raw
remove
replaceWith
root
toString
warn
postcss plugin
postcss插件如同babel插件一样,有固定的格式
export default postcss.plugin('postcss-plugin-name', function (opts) {
opts = opts || {};
return function (root, result) {
// 处理逻辑
};
});
注册个插件名,并获取插件配置参数opts
返回值是个函数,这个函数主体是你的处理逻辑,有2个参数,一个是root,css ast的根节点。另一个是result,返回结果对象,譬如result.css,获得处理结果的css字符串,result.message包含组件里创建的warnings和自定义信息,result.warn()创造一个warning实例并将其加入到result.message中,result.warnings()获得所有创建过的warning。
注意组件的异常信息处理,不要直接console,因为一些 postcss 处理器会过滤掉console的输出导致异常信息丢失,用node.warn或者node.error创造CssSyntaxError 实例,会自动带上源码中的位置信息帮助debug,加到异常信息队列里。
直接调用postcss下的方法
可以用postcss.parse来处理一段css文本,拿到css ast,然后进行处理,再通过调用toResult().css拿到处理后的css输出,在一些简单的处理中可以用这种方法。
写在最后:
- 想写一下的可以按照这里的指引,很详细https://github.com/postcss/postcss-plugin-boilerplate
- 这是我写的一个将px转为vw的插件vw-by-px
参考:
**粗体** _斜体_ [链接](http://example.com) `代码` - 列表 > 引用
。你还可以使用@
来通知其他用户。