Have ideas to improve npm?Join in the discussion! »

    najaxjs

    1.1.0 • Public • Published

    MIT License

    najaxjs - Ajax simple library

    any series   https://any-js.github.io/

    Features

    • najaxjs. Ajax simple library. You can use ajax easily and customize request & response behaviors.

    • Supported response-type is raw text / json / jsonp / html / script / csv / or others... And it has many ajax options, async / sync / retry / timeout / cache / or others by Nx object.

    • Cross-domain requests supported by $najax.scriptTag / $najax.jsonpTag.

    • There are various helper methods, $najax.url, $najax.query, $najax.submit. And $najax@helper, Singular, Pager, Reflector classes support 'ajax + ui'.

    • $najax.history can easily operate url-history(push / replace / listen).

    • Relay / Linker class. It can bundle responses.

    Requirements

    • None. Any other library is unnecessary.
      (Only $najax.sendex method requires anyjs and jQuery library.)

    Browser Support

    • Modern web-browsers(Chrome, IE, Firefox, Safari, Opera) support.
    • IE browser: Support IE9. Loose support in IE8. (You can use most of the functions.)
    • Legacy browser partially support.

    Basic usage(code example)

    // Ajax by $najax.request
    $najax.request(url).done();
    //
    // Set request and response behaviors by Nx
    $najax.request(url).type('text').timeout(5).retry(3).done();
    $najax.csv(url).done();
    $najax.sync(url).param('stone', 'age').done();
    //
    // It's possible to set success / fail / complete function
    $najax.request(url).success(sccs).complete(cmp).done();
    $najax.request(url).fail(fail).complete(cmp).done();
    $najax.request(url).done(sccs);
    //
    //
    // Others
    // See tutorials.

    Tutorials / Demos / Reference

    There are many tutorials.

    | Reference | Tutorial | Description | Default ver | Tiny ver | Micro ver | RLK ver | |:---|:---|:---|:---|:---|:---| | $najax | tutorial-static-najax.html | $najax various methods tutorials. | Yes | Part | - | - | | $najax@ex | tutorial-najax-ex.html | $najax.send / $najax.sendex tutorials. | Yes | - | - | - | | $najax@helper | tutorial-najax-helper.html | $najax helper methods. | Yes | Yes | - | - | | $najax@read | tutorial-najax-read.html | $najax.require / $najax.load / $najax.module tutorials. | Yes | Yes | - | - | | $najax@class | tutorial-najax-class.html | Singular / Pager / Reflector class tutorials. | Yes | - | - | - | | $najax.history | tutorial-static-history.html | $najax.history tutorials. | Yes | - | - | - | | Micro version | tutorial-static-najax-micro.html | Micro version. | - | - | Yes | - | | Relay / Linker | tutorial-relaylinker.html
    tutorial-rlk-standalone.html | Relay and Linker class tutorials. | Yes | Yes | - | Yes | | --- | tutorial-demo-ui-ajax.html | Ajax and UI demo. Used various methods. | - | - | - | - |

    Distributions

    For detail, see reference. In dist directory,

    Distribution Introduction
    najax.js / najax.min.js Default version.
    najax-tiny.js / najax-tiny.min.js Tiny version. Not include the below.

    $najax.history
    $najax.send / $najax.sendex
    $najax.scriptTag / $najax.jsonpTag
    $najax@class(Singular, Pager, Reflector)
    najax-micro.js / najax-micro.min.js Micro version. Not include helper methods.
    rlk.js / rlk.min.js Relay / Linker standalone version.

    Ajax response type

    See Nx.type for detail.

    Type Description Value type
    json(*) Json. assoc
    raw Raw data. string
    text Text. text is same as raw. string
    html HTML. Element
    script Execute script. null
    func Function. function
    jsonp Jsonp. null
    csv Csv(Tsv). array
    xml Xml. XMLDocument
    blob Blob. Blob
    other XMLHttpRequest.responseType. Varies.

    Nx class specification

    Nx class. This class is created automatically by $najax various method.

    Specification

    • Specify ajax request and response behaviors by Nx object.
    • Specify by Nx object's various method or Nx opt method.
    • Begin ajax connection by Nx done.
    • Nx done returns Relay object.
    • Relay provide operating response-data, and bundling multiple Relay.
    • Nx implement ajax by using XMLHttpRequest.

    Relation library(any-js series)

    Library Introduction Requirements
    anyjs Basic methods and UI helper library. jQuery library
    najaxjs Simple ajax library. None
    nviewjs View template engine. jQuery library / anyjs

    License

    Released under the MIT license. See LICENSE.

    ChangeLog

    See CHANGELOG.

    Install

    npm i najaxjs

    DownloadsWeekly Downloads

    59

    Version

    1.1.0

    License

    MIT

    Last publish

    Collaborators

    • avatar