This plugin allows to reload parts of a page, either automatically or manually.
%JQREQUIRE{"loader"}% macro to the page that you want to use this module on.
Then add the jqLoader css class to the div element which will serve as
a container for the content to be loaded. Any jqLoader container requires either
an url or a section parameter to specify the location from where to load the content.
Parameter are specified using HTML5 data, as in
<div class="jqLoader" data-key1="value1" data-key2="value2" ...></div>
| Parameter | Description |
Default |
|---|---|---|
| beforeload | a JavaScript function called before the content is requested | |
| onload | a JavaScript function called when the content has been loaded | |
| finished | a JavaScript function called when the content has been loaded and displayed on the page | |
| delay | additional time in miliseconds to delay fetching the content from the content; specifying 0 means load the content immediately; any other value will wait that time until issuing the request |
0 |
| caching | boolean if disabled will prevent browser caching | true |
| select | jQuery selector to extract a specific node from the retrieved data | |
| reload-after | reload the content after the given milliseconds | 0 |
| mode | specify whether the content is either loaded automatically or by clicking on the container; possible values: auto, manual |
manual |
| show-effect | the effect used when showing the loaded content; possible values are listed in JQueryAnimate | fadeIn |
| hide-effect | the effect when hiding the loaded content; possible values are listed in JQueryAnimate | fadeOut |
| url | the full url from where the content, e.g. url:'https://wiki.alexander-weimer.com/bin/view/MyWeb/MyTopic |
%SCRIPTURLPATH{"view"}/<web>/<topic> |
| section | the section within the topic (see VarSTARTSECTION) | |
| topic | the topic from where to load content | current topic |
| web | the web from where to load content | current web |
| params | url parameter that are sent to the server | {"skin":"text"} |
jqLoader element is able to receive JavaScript events and process them accordingly. Similarly these
events can be used to hook your own callbacks to be processed when they are fired.
| Event | Description |
|---|---|
| refresh.jqloader | when triggered will reload the content from the backend |
| beforeload.jqloader | is triggered before requesting the content from the backend (see beforeload parameter above) |
| afterload.jqloader | is triggered when the content has been successfully been loaded (see onload parameter above) |
| finished.jqloader | is triggered when content has been loaded and finally been displayed on the page (see finished parameter above) |
%JQREQUIRE{"loader"}%
<div class="jqLoader" data-section="recentchanges" id="myLoader">
%STARTSECTION{"recentchanges"}%%SEARCH{
"'1'"
web="%BASEWEB%"
type="query"
nonoise="on"
order="modified"
reverse="on"
limit="10"
format="<p class='foswikiSearchResult'>[[$web.$topic]] $date - $rev - $wikiusername</p>"
}%%ENDSECTION{"recentchanges"}%
</div>
… if installed: