grunt-dom-munger
Advanced tools
Read and manipulate HTML with jsdom and jquery. Ex. read <script> tags from your html. Remove nodes, add nodes, and more.
Read and manipulate HTML documents with jsdom and jquery.
Use this task to read and transform your HTML documents. Typical use cases include:
script or link tags and have those passed to concat,uglify, etc automatically.This plugin requires Grunt ~0.4.1
npm install grunt-dom-munger --save-dev
One the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:
grunt.loadNpmTasks('grunt-dom-munger');
The dom-munger reads one or more HTML files and performs one or more operations on them.
grunt.initConfig({
dom_munger: {
your_target: {
options: {
//You typically would only specify one option per target but they may be combined
read: {selector:'link',attribute:'href',task:'concat',target:'dist/concated.css',isPath:true},
remove: '#removeMe',
update: {selector:'html',attribute:'appmode',value:'production'},
append: {selector:'body',html:'<div id="appended">Im being appended</div>'},
prepend: {selector:'body',html:'<span>Im being prepended</span>'},
text: {selector:'title',text:'My App'},
callback: function($){
$('#sample2').text('Ive been updated via callback');
}
},
src: 'index.html', //could be an array of files
dest: 'dist/index.html' //optional, if not specified the src file will be overwritten
},
},
})
Note: each option (except callback) requires a selector. This can be any valid JQuery selector.
Extract the value of a given attribute from the set of matched elements then set the values into a grunt config of another task. A typical use-case is to grab the script references from your html file and pass that to concat.
grunt.initConfig({
dom_munger: {
your_target: {
options: {
read: {selector:'script',attribute:'src',task:'uglify',target:'dist/app_full_min.js',isPath:true}
},
src: 'index.html'
},
},
})
Run uglify after this task and uglify will create dist/app_full_min.js using the references from your script. No need to have any uglify config in your Gruntfile.js beforehand.
task and target are where you want the extracted values to be written. When isPath is true, the extracted values are assumed to be file references and their path is made relative to the file they're read from. This is usually necessary when writing the values to another grunt task like concat or uglify.
Removes one or more matched elements.
grunt.initConfig({
dom_munger: {
your_target: {
options: {
remove: '#removeMe' //remove an element with the id of removeMe
},
src: 'index.html',
dest: 'dist/index.html'
},
},
})
Updates the value of a given attribute for the set of matched elements.
grunt.initConfig({
dom_munger: {
your_target: {
options: {
update: {selector:'html',attribute:'appmode',value:'production'} //set a appmode="production" on <html>
},
src: 'index.html',
dest: 'dist/index.html'
},
},
})
Appends the content to each matched element.
grunt.initConfig({
dom_munger: {
your_target: {
options: {
append: {selector:'body',html:'<div id="appended">Im being appended</div>'}
},
src: 'index.html',
dest: 'dist/index.html'
},
},
})
Prepends the content to each matched element.
grunt.initConfig({
dom_munger: {
your_target: {
options: {
prepend: {selector:'body',html:'<span>Im being prepended</span>'}
},
src: 'index.html',
dest: 'dist/index.html'
},
},
})
Updates the text content of the matched elements.
grunt.initConfig({
dom_munger: {
your_target: {
options: {
text: {selector:'title',text:'My App'} //Updates the <title> to "My App"
},
src: 'index.html',
dest: 'dist/index.html'
},
},
})
When you feel like bustin loose. Set a callback function and use the passed JQuery object to do anything you want to the HTML.
grunt.initConfig({
dom_munger: {
your_target: {
options: {
callback: function($){
//do anything you want here
}
},
src: 'index.html',
dest: 'dist/index.html'
},
},
})
FAQs
Read and manipulate HTML with CSS selectors. Ex. read <script> tags from your html. Remove nodes, add nodes, and more.
The npm package grunt-dom-munger receives a total of 8,867 weekly downloads. As such, grunt-dom-munger popularity was classified as popular.
We found that grunt-dom-munger demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Research
Security News
Socket researchers uncover a malicious npm package posing as a tool for detecting vulnerabilities in Etherium smart contracts.
Security News
Research
A supply chain attack on Rspack's npm packages injected cryptomining malware, potentially impacting thousands of developers.
Research
Security News
Socket researchers discovered a malware campaign on npm delivering the Skuld infostealer via typosquatted packages, exposing sensitive data.