Ajile 1.2.1

Copyright (c) 2003-2008 Michael Lee, ajile.iSkitz.com

All rights reserved.

URL: http://ajile.iskitz.com/

Description

AJILE, the Advanced JavaScript Importing & Loading Extension brings immediate support for load, import, include and namespace to a wide variety of JavaScript-enabled browsers.

Ajile simplifies and enhances web development by supporting efficient, interoperable, and unobtrusive JavaScript. Developers will also find help protecting their code's intellectual property via Ajile's configurable runtime source-code cloaking.

As the name implies, Ajile can be used to make web sites and applications fast and responsive via highly interoperable scripts capable of loading and importing functionality as needed.

Features

Asynchronous script loading from any location.
Unobtrusive scripting via MVC-styled page/script separation.
Configurable auto-loading of site and per-page scripts.
Namespace support to encapsulate & uniquely identify functionality.
Namespace & module including for full-name access.
Namespace & module importing for short-name access.
Namespace & module importing with aliases.
Namespace & module importing with versioning.
Automatic path resolution for namespaced modules.
Dependency Definition with runtime enforcement.
Import notification via event listening.
Flexible packaging via namespaced files and/or structured directories.
Load-time & runtime cache management.
Load-time & runtime name collision management.
Load-time & runtime source code cloaking.

Target Environment

Supported Browsers:

Desktop:
- Firefox 0.1+ (All)
- IE 4.01+
- Opera 5+
- Safari 1.2+
- Camino 1.0.1+
- iCab 3.0.3+
- Mozilla 0.9.1+
- Netscape 6.1+
- OmniWeb 5.6+
- SeaMonkey 1.0+
- Microsoft HTML Applications (HTAs)

Mobile:
- Safari on iPhone
- Blazer 3.0 on Treo 600
- Opera Mini 2.0+

Supported Specifications:

ECMA-262, Edition 3+
JavaScript 1.3+
JScript 3.0+

Directives

Import	: Used to import JavaScript modules with full & shortened-name access.
ImportAs	: Used to import JavaScript modules with aliased shortened-name or full-name access.
Include	: Used to include JavaScript modules with full-name access only.
Load	: Used to load JavaScript modules from a specific location.
Namespace	: Used to define a JavaScript namespace.

(See Docs for detailed information, and Examples for usage.)

Functions

Ajile.AddImportListener()	: Allows adding an import event listener.
Ajile.EnableCloak()	: Toggles on/off source code cloaking.
Ajile.EnableDebug()	: Toggles on/off logging of Ajile's debug information.
Ajile.EnableLegacy()	: Toggles on/off support for code using legacy releases (i.e. JSPackaging & Ajile 0.5.5 and earlier).
Ajile.EnableOverride()	: Toggles on/off silently overriding similarly named modules.
Ajile.EnableRefresh()	: Toggles on/off guaranteed refreshing of loaded scripts and imported modules.
Ajile.GetVersion()	: Retrieves Ajile's version number.
Ajile.RemoveImportListener()	: Allows removing an import event listener.
Ajile.SetOption(<option name>, [true\|false])	: Toggles on/off the specified option (i.e. cloak, debug, legacy, mvc, mvcshare, override, refresh).
Ajile.ShowLog()	: Displays Ajile's debug information.
Ajile.Unload([moduleName\|namespace])	: Unloads the specified module, namespace, or Ajile and its resources from memory.

(See Docs for detailed information, and Examples for usage.)

Load-time Options

The following options are used to enable/disable Ajile features at load time:

cloak	: Toggles on/off source code hiding.
debug	: Toggles on/off logging of Ajile's debug information.
legacy	: Toggles on/off support for code using legacy releases (i.e. JSPackaging & Ajile 0.5.5 and earlier).
mvc	: Toggles on/off the auto-loading of a page's control module.
mvcshare	: Toggles on/off the auto-loading of a site's shared control module.
override	: Toggles on/off silently overriding similarly named modules.
refresh	: Toggles on/off guaranteed refreshing of loaded scripts and imported modules.

(See Docs for detailed information, and Examples for usage.)

Thanks

Thanks for using Ajile. Feel free to post questions, suggestions or information about how you're using it within other applications, libraries or other creations. Special thanks to those who've given feedback and helped troubleshoot, including andrea, cameron, danny. levani, mark, samir, and thomas.

- Michael