vojtech-dobes/nette-ajax-history

Adds History API support for Nette Framework.

Maintainers

Details

github.com/vojtech-dobes/history.nette.ajax.js

Homepage

Source

Issues

Installs: 169 490

Dependents: 7

Suggesters: 0

Security: 0

Stars: 30

Watchers: 6

Forks: 27

Open Issues: 15

2.0.0 2015-01-17 21:08 UTC

Requires

MIT f3fab92e5ed17ff6e8d4325401cbf211c4e17dba

  • Vojtěch Dobeš <me.woop@vojtechdobes.com>

ajaxnettenette.ajax.js

This package is not auto-updated.

Last update: 2024-12-21 15:49:50 UTC

README

Adds History API support to nette.ajax.js addon for Nette Framework!

Installation

  1. Link client-side/history.ajax.js after nette.ajax.js.
  2. Load PHP files with Composer: vojtech-dobes/nette-ajax-history
  3. Register config extension in your configuration:
extensions:
	ajaxHistory: VojtechDobes\NetteAjax\HistoryExtension

Usage

Write your application as normal. All redirects and forwards will be properly handled.

To correctly update UI, use snippets. If you plan to ajaxify whole application, consider adding this snippet to your beforeRender() method in BasePresenter.

if ($this->isAjax()) {
	$this->invalidateControl('title');
	$this->invalidateControl('content');
}

And app/@layout.latte might be upgraded accordingly:

<title n:inner-snippet="title">...
{snippet content}
{include content}
{/snippet}

Disabling

If you want specific links or forms exclude from scope of this addon (not make them update the URL), you can use data-ajax-off feature of nette.ajax.js.

<a class="ajax" data-ajax-off="history">

UI Caching

Extension will automatically cache your UI and restore it on Back and Forward buttons without communication with server. If you wish to call server on every Back and Forward, turn caching off.

$.nette.ext('history').cache = false;