Wikipedia:WikiProject User scripts/Guide/Ajax

This is an old revision of this page, as edited by TheFearow (talk | contribs) at 23:07, 17 August 2007 (Misc: Added untested warning, info on cookies in the URL actions section). The present address (URL) is a permanent link to this revision, which may differ significantly from the current revision.


To create the object you could use cross-browser example from the article but it's easier to utilize built-in ajax.js functionality:

xmlhttp = sajax_init_object();


Data sources

See mw:API. Usually used with JSON format.

See User:Yurik/Query_API. This is older verison of API, can be used for some queries not yet implemented in API. Some Javascript examples can be found at User:Yurik/Query_API/User_Manual#JavaScript.

HTML

You could fetch the whole artcile page or use &action=render URL parameter to get the content without all the menus (example). Also see Parameters to index.php.

The result you could treat as a text but it's usually convenient to parse it as HTML document, e.g. using DOMParser object (examples needed).

Wiki code

To get the wiki code you use &action=raw URL parameter (example).

The result you treat as a text.

Preview

Sometimes you might want to use preview. For example, Special:Prefixindex won't work with &action=render. To get rid of the unnecessary menus you could submit {{Special:Prefixindex/somepage}} for a preview and get a "clean" list


Implementations

Mediawiki


AjaxFunctions.php has 2 main functions:

  • wfAjaxWatch - server part of ajaxwatch.js
  • wfSajaxSearch - disabled on WMF projects. If it was enabled, ajaxsearch.js would be responsible for the client side. Also see mw:Manual:$wgAjaxSearch.


Another disabled feature is Live preview (preview.js)

Userscripts


Misc

Some alternatives to XMLHttpRequest:

  • IFrame: almost nobody uses this, but if you're interested, here's a small library: User:TheFearow/ajax.js (Warning: Untested)
  • URL actions: this is not Ajax at all, but this method is also widely used for one-click-do-all scripts. 1st part of the script goes to another page using additional "dummy" URL parameters (not recognized and so ignored by Mediawiki). 2nd part of the script analyzes that URL and then does something. Because of the way MediaWiki redirects after edits, cookies may also be used to transfer data and instructions. An example library (unmaintaned) can be found at User:Lupin/autoedit.js