An open API service indexing awesome lists of open source software.

https://github.com/zeecoder/z-hook-finder

Finds JS hooks in a given DOM element, inspired by the BEM methodology.
https://github.com/zeecoder/z-hook-finder

Last synced: 10 months ago
JSON representation

Finds JS hooks in a given DOM element, inspired by the BEM methodology.

Awesome Lists containing this project

README

          

# z-hook-finder
[![Build Status](https://travis-ci.org/ZeeCoder/z-hook-finder.svg?branch=master)](https://travis-ci.org/ZeeCoder/z-hook-finder)
[![npm version](https://badge.fury.io/js/z-hook-finder.svg)](http://badge.fury.io/js/z-hook-finder)

## What is it
This module was created to handle a [BEM](http://bem.info)-like solution to find JS "hooks".

Here a JS hook means the same for a module as a BEM element means for a block.

As an additional "convention", I use a `js-` prefix for the classnames, which is
used to differenciate JS classes from classes used solely for design by CSS.

## Example, explanations:

```html






```

```js
var HookFinder = require('z-hook-finder');

var finder = new HookFinder($('#js-module'), 'js-module__');
// Alternatively you can pass the separator "__" or something else as the third
// parameter: `new HookFinder($('#js-module'), 'js-module', '__');`

finder.find('button');
// -> returns the jQuery object for the DOM element

finder.find('button', 2);
// -> returns only the first 2 buttons, and outputs a console error
```

Since this is a CommonJS module, it must be used alongside with [Browserify](http://browserify.org/), or
something similar, like [WebPacker](http://webpack.github.io/).

## License
[MIT](LICENSE)