raw-html-attribute-updater
v1.5.9
Published
This is useful when updating an attribute of all same kinds of elements in raw html saved or edited by Wysiwyg. Moreover, as the core parsing logic is a strong combination of regular expressions, there are more advantages compared to well-known general wa
Downloads
44
Maintainers
Readme
Raw-html-attribute-updater
Overview
Raw-html-attribute-updater is an open source JavaScript library.
This is useful when updating an attribute of all same kinds of elements in raw html saved or edited by Wysiwyg.
The core parsing logic of this is a strong combination of regular expressions, which means it has no dependency on any existing parsing
libraries. Many developers argue that regular expressions can't parse a html (https://stackoverflow.com/questions/1732348/regex-match-open-tags-except-xhtml-self-contained-tags/1732454#1732454), but I would like to show you how to solve the question. One thing that I would like to tell you is a regex indicating tags is not simply '<[^>]+>'. This regex fails to parse some cases such as '<p class="here>to" style="width:100%">'
where '>' is inserted in the class attribute.
Advantages
- Easy-to-use.
- You can use this library for not only html but also any kind of xml-type resources.
- Update only a target part preserving all the other parts as they are.
Example Usage
Installation & Usage
There are parameters as examples to be used in the usage below.
var htmlStr = '<p></p>\n' +
'<img style="max-width: 50%;float:none;width: auto;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>\n' +
'<p></p>\n' +
'<p id="abc" class="def xxx gh" style="text-align:center;"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>\n' +
'<p><img style="float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>\n' +
'<p style="text-align:center;">※Please ask your manager if you have any issues! ※ </p>';
var attrName = 'style';
var attrValue = 'max-width:100%';
var elementName = 'img';
var isIdWay = false; // available from version 1.5.0. if you use the parameter, this enables 'overwriting previous attribute values' regardless of what kind of 'attrName'. (default : false)
var commentsAreaIgnore = true; // available from version 1.5.6. if you use the parameter, this enables 'updating only parts not in comments'. (default : true)
For ES6 npm users, 'npm install --save raw-html-attribute-updater'. (https://www.npmjs.com/package/raw-html-attribute-updater)
import RawHtmlAttributeUpdater from 'raw-html-attribute-updater';
/* @params
* string : attrName, attrValue, elementName, htmlStr (necessary)
* isIdWay (not necessaray, default : false)
*/
RawHtmlAttributeUpdater.storeAttrField(attrName, attrValue, elementName, htmlStr) // returns htmlStr that has been updated with elementName, attrName, attrValue.
For ES5 users,
<html>
<body>
<p id="content"></p>
<p><button id="loadCat">Lazy load <b>Cat</b></button></p>
<script src="../dist/raw-html-attribute-updater.bundle.js"></script>
<script type="text/javascript">
RawHtmlAttributeUpdater.storeAttrField(attrName, attrValue, elementName, htmlStr); // Returns htmlStr that has been updated with elementName, attrName, attrValue.
</script>
</body>
</html>
Syntax Overview
The function above returns different results according to three types of attrName below.
[1] style-way
- attrName : style (before)
attrName = 'style';
attrValue = 'max-width:100%';
elementName = 'img';
htmlStr = '<p></p>\n' +
'<img style="max-width: 50%;float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>\n' +
'<p></p>\n' +
'<p id="abc" class="def xxx gh" style="text-align:center;"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>\n' +
'<p><img style="float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>\n' +
'<p style="text-align:center;">※Please ask your manager if you have any issues! ※ </p>';
The following is the result of the example. (You can see differences for every 'style' for every 'img')
- attrName : style (after)
<p></p>
<img style="max-width:100%;float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>
<p></p>
<p id="abc" class="def xxx gh" style="text-align:center;"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>
<p><img style="float:none;height: 200px;margin-top : 3%;max-width:100%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>
<p style="text-align:center;">※Please ask your manager if you have any issues! ※ </p>
[2] id-way
- attrName : id (before)
attrName = 'id';
attrValue = 'abc';
elementName = 'p';
htmlStr = '<p></p>\n' +
'<img style="max-width: 50%;float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>\n' +
'<p></p>\n' +
'<p id="abc" class="def xxx gh" style="text-align:center;"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>\n' +
'<p><img style="float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>\n' +
'<p style="text-align:center;">※Please ask your manager if you have any issues! ※ </p>';
The following is the result of the example. (You can see differences for every 'id' for every 'p')
- attrName : id (after)
<p id="abc"></p>
<img style="max-width: 50%;float:none;width: auto;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>
<p id="abc"></p>
<p id="abc" class="def xxx gh" style="text-align:center;"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>
<p id="abc"><img style="float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>
<p style="text-align:center;" id="abc">※Please ask your manager if you have any issues! ※ </p>
[3] class-way
- attrName : class (before)
attrName = 'class';
attrValue = 'xyz';
elementName = 'p';
htmlStr = '<p></p>\n' +
'<img style="max-width: 50%;float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>\n' +
'<p></p>\n' +
'<p id="abc" class="def xxx gh" style="text-align:center;"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>\n' +
'<p><img style="float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>\n' +
'<p style="text-align:center;">※Please ask your manager if you have any issues! ※ </p>';
The following is the result of the example. (You can see differences for every 'class' for every 'p')
- attrName : class (after)
<p class="xyz"></p>
<img style="max-width: 50%;float:none;width: auto;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>
<p class="xyz"></p>
<p id="abc" class="def xxx gh xyz" style="text-align:center;"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>
<p class="xyz"><img style="float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>
<p style="text-align:center;" class="xyz">※Please ask your manager if you have any issues! ※ </p>
[Plus] random-way
- attrName : random (before)
All other attrNames except for the three above function like in a 'class' way. For example,
attrName = 'monkey';
attrValue = 'happy';
elementName = 'p';
htmlStr = '<p monkey="kind"></p>\n' +
'<img style="max-width: 50%;float:none;width: auto;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>\n' +
'<p></p>\n' +
'<p id="abc" class="def xxx gh" style="text-align:center;"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>\n' +
'<p><img style="float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>\n' +
'<p style="text-align:center;">※Please ask your manager if you have any issues! ※ </p>';
The following is the result of the example. (You can see differences for every 'monkey' for every 'p')
- attrName : random (after)
<p monkey="kind happy" ></p>
<img style="max-width: 50%;float:none;width: auto;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=12345.png" alt="undefined"/>
<p monkey="happy"></p>
<p id="abc" class="def xxx gh" style="text-align:center;" monkey="happy"><span style="color: rgb(127,127,127);">Please align the paper to the left.</span> </p>
<p monkey="happy"><img style="float:none;height: 200px;margin-top : 3%" src="/image/showWorkOrderImg?fileName=123456.png" alt="undefined"/></p>
<p style="text-align:center;" monkey="happy">※Please ask your manager if you have any issues! ※ </p>