Skip to content
This repository

a "simple" and unified approch to implement the new HTML5 History Interface & loading content via ajax

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 demo
Octocat-spinner-32 source
Octocat-spinner-32 GPL-LICENSE.txt
Octocat-spinner-32 MIT-LICENSE.txt
Octocat-spinner-32 asfar.min.jquery.js
Octocat-spinner-32 bower.json
Octocat-spinner-32 version.txt

asfar - ajax substitute for (all) requests

asfar is a "simple" approch to implement the new HTML5 History Interface or shebangs (depending on Browser Capability) to load content via AJAX to a specific DOM Target and keep track of that in the History & Adress Bar of the Browser.

In its current Form asfar is an jQuery Plugin and need the Library to function, depending on the feedback this might change in the future.


The main goal of asfar is to provide an easy way (just look at the basic implementation) to Access and Reffer Information/States of Content that is provided via AJAX and work with them, most likely show them in some way on the page, whyle keeping track of thoose changes in the History & Adress Bar of the Browser.

If your Browser does not support the HMLT5 History Interface (yes IE Users, I'm looking at you), the functionality is the same only that shebangs are used (like Facebbok does in general for Example).



Effetcs using Callbacks:

implementation & Examples




         selector : 'a:not(.extern)'


        selector : 'a:not(.extern)',
        before : function(urlFragment,target){
        insert : function(urlFragment,target,data){
        after : function(urlFragment,target){
        success : function(urlFragment,target){
            if(0 > $('a[href="' + urlFragment + '"]').length){
                $('a[href="' + urlFragment + '"]').addClass('active');


Server Side

You can optimize your application to only return the part of the page that you actually want to load, you can do that by recognizing an "ajax" call and delivering different/partial content depending on that.

Client Side

You can place this peace of javascript Code in the header of your page so he can perform redirects without loading & showing the whole (wrong) page first

        if ('#!' === location.hash.substring(0,2)) {
            location.href = location.hash.substring(2);
Something went wrong with that request. Please try again.