pluck-elements

Given a DOM node, pluck child elements into an object structure based on the value of a named attribute.

Given this:

<div id='foo'>
  <ul class='people' data-pluck='list'>
    <li data-pluck='people[]'>Jason</li>
    <li data-pluck='people[]'>Jim</li>
    <li data-pluck='people[]'>John</li>
  </ul>
  <input type='text' data-pluck='input'>
  <input type='button' data-pluck='submit'>
</div>

It produces this (wherein #<...> denotes a real DOM element):

{
  root: #<div#foo>,
  list: #<ul.people>,
  people: [
    #<li>,
    #<li>,
    #<li>
  ],
  input: #<input[type=text]>,
  submit: #<input[type=button]>
}

Installation

Browserify

Get it:

$ npm install pluck-elements

Require it:

var pluckElements = require('pluck-elements');

UMD

Copy and paste either build/pluck-elements.js or build/pluck-elements.min.js into your project.

API

pluck(el, [attr], [map])

Find all descendant nodes of el with attribute attr and add them to an object, keyed by the value of attr and optionally mapping each element via callback map. The attribute's value may contain a list of whitespace separated values; in this case a key for each distinct value will be created in the output dictionary. Where a key is suffixed with [], e.g. people[], multiple plucked elements sharing the same key will be collected into an array.

If unspecified, attr defaults to data-pluck. map defaults to the identity function.

Copyright & License

© 2014 Jason Frame [ @jaz303 / [e-mail] ]

Released under the ISC license.