|
L'API Netvibes permet de rapidement mettre en place un module fonctionnel, sous forme de fichiers XHTML hébergés sur votre site. Un module peut fonctionner aussi bien sur le portail Netvibes qu'en dehors, sur un site tiers. Pour que cela soit possible, il faut respecter quelques principes de développement.
Les modules Netvibes sont composés de fichiers XHTML et XML. Ceux-ci doivent être valides (syntaxe correcte et bien formée), et les textes doivent être encodés en UTF-8 (pas en ISO-8859-1, par exemple). Enfin, l'en-tête du document doit déclarer un profil HTML particulier, sans que cela soit obligatoire. Il est à noter que si les CSS sont autorisées, le module ne pourra cependant pas faire appel aux feuilles CSS externes. Il en va de même pour JavaScript.
Côté JavaScript, l'API fournit quelques fonctions particulières, parmi lesquelles saveValue(nom, valeur) pour enregistrer le contenu d'une variable, et getValue(nom) pour la charger. Il est par ailleurs demandé de ne pas faire appel à document.getElementById() (ni à l'équivalent $() de Prototype), mais de faire des sélections d'objets DOM par référence relative. De la même manière, il n'est pas possible de placer un événement type onclick ou onmouseover sur un élément : il faut définir ce comportement depuis le code JavaScript.
Enfin, les formulaires sont une grande partie du fonctionnement d'un module Netvibes. Un formulaire ayant une classe CSS "configuration" sera affiché de manière particulière par le portail (en cliquant sur le bouton Edit du module). Le contenu d'un formulaire de configuration, une fois envoyé, est accessible par le module via getValue() ou au sein du cookie de session, sous le même nom. Les formulaires peuvent utiliser les protocoles GET ou POST, mais doivent renvoyer un document XHTML correspond à un module Netvibes complet.
|
