Rules
规则集包含一系列规则,其构造器通过传入的options配置对象获取规则列表并置于array字段中。
字段为:
options:配置项对象,就是用户传进来的那些_keep:保留的规则列表_remove:删除的规则列表array:常规规则列表blankRule:空白节点的规则keepReplacement:保留节点的规则defaultRule:默认规则
function Rules (options) { this.options = options; this._keep = []; this._remove = []; this.blankRule = { replacement: options.blankReplacement }; this.keepReplacement = options.keepReplacement; this.defaultRule = { replacement: options.defaultReplacement }; this.array = []; for (var key in options.rules) this.array.push(options.rules[key]); }
讯享网
Rules.add()
在规则表前端插入指定规则,遍历的顺序是从前向后,所以新插入的规则会优先匹配。
讯享网 add: function (key, rule) { this.array.unshift(rule); },
Rules.keep()
在保留列表中插入指定的过滤器。
keep: function (filter) { this._keep.unshift({ filter: filter, replacement: this.keepReplacement }); },
根据构造器,this.keepReplacement就是options.keepReplacement,然后再看看它:
讯享网 keepReplacement: function (content, node) { return node.isBlock ? '\n\n' + node.outerHTML + '\n\n' : node.outerHTML },
保留列表的作用就是,原封不动保留匹配元素的outerHTML。
Rules.remove()
在移除列表中插入给定的过滤器。移除列表的作用就是保证某个元素被移除。
remove: function (filter) { this._remove.unshift({ filter: filter, replacement: function () { return '' } }); },
Rules.forEach()
等价于this.array.forEach。
讯享网 forEach: function (fn) { for (var i = 0; i < this.array.length; i++) fn(this.array[i], i); }
findRule()
遍历给定规则列表,使用每个规则匹配给定节点,如果匹配则返回当前规则,否则返回空值。
function findRule (rules, node, options) { for (var i = 0; i < rules.length; i++) { var rule = rules[i]; if (filterValue(rule, node, options)) return rule } return void 0 }
Rules.forNode()
寻找第一个匹配给定节点的规则。
顺序为:
- 首先通过
node.isBlank判断节点是否为空白,是的话就返回空白节点规则。 - 依次在规则列表、保留列表、移除列表中匹配该节点,如果匹配成功返回匹配的规则
- 如果全部都不匹配,返回默认规则
讯享网 forNode: function (node) { if (node.isBlank) return this.blankRule var rule; if ((rule = findRule(this.array, node, this.options))) return rule if ((rule = findRule(this._keep, node, this.options))) return rule if ((rule = findRule(this._remove, node, this.options))) return rule return this.defaultRule },
其中空白节点的规则为不保留任何东西:
blankReplacement: function (content, node) { return node.isBlock ? '\n\n' : '' }
默认规则为只保留它的Markdown内容:
讯享网 defaultReplacement: function (content, node) { return node.isBlock ? '\n\n' + content + '\n\n' : content }
filterValue()
考虑三种不同类型的规则(string、string[]和function),判断给定规则是否匹配给定节点。
function filterValue (rule, node, options) { var filter = rule.filter; if (typeof filter === 'string') { if (filter === node.nodeName.toLowerCase()) return true } else if (Array.isArray(filter)) { if (filter.indexOf(node.nodeName.toLowerCase()) > -1) return true } else if (typeof filter === 'function') { if (filter.call(rule, node, options)) return true } else { throw new TypeError('`filter` needs to be a string, array, or function') } }

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/114182.html