Newton's Programmatic Measurements

    empty-within

    1.1.0 • Public • Published

    Empty Within dom logo

    NPM Version Build Status

    Empty Within lets target elements based on whether they are empty editable text fields or contain empty text editable fields.

    Empty Within applies an empty-within attribute to empty <textarea> and <input> text elements, or elements containing them.

    .form-field label {
      /* style a label to appear above an input */
    }
     
    .form-field[empty-within] label {
      /* style a label differently when .form-field contains an empty input */
    }

    Usage

    Add Empty Within to your build tool:

    npm install empty-within

    Activate Empty Within on the document or some other element:

    import emptyWithin from 'empty-within';
     
    emptyWithin(document);

    You can also limit the scope of the DOM tree affected by Empty Within.

    emptyWithin(document.querySelector('.my-only-form'));

    Options

    attr, className

    Empty Within accepts a secondary paramater to configure the attribute or class name added to elements matching empty editable fields or containing empty editable fields.

    emptyWithin(document, {
      attr: false,
      className: '.empty-within'
    })

    Falsey values on either attr or className will disable setting the attribute or class name on elements matching empty editable fields or containing empty editable fields.

    watchScope, watchValue

    The secondary paramater may also be used to determine how aggressive Empty Within watches the DOM tree. Setting watchScope to false will disable MutationObserver from watching for new editable fields added to the document. Setting watchValue to false will disable Object.defineProperty from capturing changes to editable fields by their value property.

    Install

    npm i empty-within

    DownloadsWeekly Downloads

    3

    Version

    1.1.0

    License

    CC0-1.0

    Unpacked Size

    17.8 kB

    Total Files

    6

    Last publish

    Collaborators

    • jonathantneal