posthtml-rename-id

PostHTML rename plugin

Plugin to rename id attributes and it's references. Inspired by grunt-svgstore.

Handle following cases:

• href="#id" and xlink:href="#id"
• style attribute values like style="fill: url(#id)"
• <style> tag values like .selector {fill: url(#id)"}
• any other attribute value like attr="url(#id)"

Install

npm install posthtml-rename-id --save

Usage

const posthtml = require('posthtml');
const rename = require('posthtml-rename-id');

posthtml()
  .use(rename('prefix_[id]'))
  .process('<div id="qwe"></div> <a href="#qwe"></a>')
  .then((result) => {
    console.log(result);
  });

// <div id="prefix_qwe"></div> <a href="#prefix_qwe"></a>

Configuration

plugin(pattern: string|Function) (optional, [id] by default)

Renaming pattern. [id] placeholder can be used as current id of an element. If pattern provided as a function it will be called with current id as first argument. Function should return the new id as string ([id] can be used as well).

Uppercase all ids:

posthtml([
  renameId(id => id.toUpperCase())
]);

Rename all ids to elem_{counter}:

let c = 0;
posthtml([
  renameId((id) => { c++; return 'elem_' + c; })
]);