Novice Pokémon Master

    @qc/inject-element

    0.0.0 • Public • Published

    @qc/inject-element

    A promise-based Element injection utility. Great for injecting img, link, and script elements.

    The promise resolves successfully after the resource successfully loads. The promise rejects if an error occurs while loading or if the loading times out.

    Syntax

    type CssSelector = string;
    
    type NodeLike = CssSelector | Node;
    
    type AttachAction = 'after' | 'before' | 'endof' | 'startof';
    
    type AttachableString = AttachAction + '@' + CssSelector;
    
    interface AttachableObject {
      [AttachAction]: NodeLike;
    }
    
    type Attachable = AttachableString | AttachableObject;

    See @qc/attach-node for examples of uses of Attachables.

    Examples

    import injectElement from 'inject-element'
    
    injectElement({
      tag: 'script',
      src: 'https://cdn.example.com/foobar.js',
      attach: 'endof@body', // An `Attachable`.
    })
      .then((elmt) => {
        // Do what is needed now that the dependency successfully loaded.
      })
      .catch((err) => {
        console.error(err)
        // Maybe notify user that something went wrong and should try refreshing.
      })
    
    injectElement({
      tag: 'link',
      href: 'https://cdn.example.com/foobar.css',
      type: 'stylesheet',
      attach: 'endof@head' // An `Attachable`.
    })

    Install

    npm i @qc/inject-element

    DownloadsWeekly Downloads

    1

    Version

    0.0.0

    License

    ISC

    Unpacked Size

    5.02 kB

    Total Files

    4

    Last publish

    Collaborators

    • qc