najaxjs

najaxjs - Ajax simple library

  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.