|
META TOPICPARENT |
name="WidgetsProjet" |
API d'un widget pour le dashboard
Liste des fonctions qu'un widget doit implémenter pour pouvoir être intégré dans le dashboard
La communication avec postal peut être activée ou désactivée pour chaque widget. C'est la fonction communicateWithOther qui est appelée. Cette fonction est donc l'endroit idéal pour gérer tout ce qui concerne postal , et elle peut être utilisée par la fonction initialisation .
La fonction reset est appelée pour remettre le widget à zéro. Ça veut dire que tout le DOM doit être réinitialiser, toutes les variables remises à leur état initial. C'est aussi une fonction qu'il est utile d'appeler à partir de initialisation .
Nom méthode |
Arguments |
Retour |
Détails |
id |
aucun |
une chaîne de caractère, un identifiant pour ce widget |
C'est à partir de ce mot que sont créés les identifiants des instances de ce widget, en ajoutant un numéro à la fin s'il y a plusieurs instances |
name |
aucun |
une chaîne de caractère |
C'est le texte qui va être affiché à l'utilisateur pour créér un widget de ce type |
description |
aucun |
une chaîne de caractère |
C'est le texte qui va servir de tooltip à ce widget |
|
|
< < |
icon |
aucun |
un caractère |
Le caractère identifie une icône de la fonte FontAwesome. Par exemple : &samp;#f129; |
|
> > |
icon |
aucun |
un caractère |
Le caractère identifie une icône de la fonte FontAwesome . Par exemple : f129; |
|
|
capabilities |
aucun |
un objet |
return {
isIframe: false,
canBeShared: true,
isSampEnabled: true,
canSaveAsPng: true,
canCommunicate: true,
canBeFullscreen: true
} |
|
|
< < |
initialise |
dashboardId : l'identifiant unique de ce widget. Il doit être inclut dans tous id qui sont créé dans le DOM, pour les distinguer des autres widgets du même type. postal : l'objet postal isInDashboard : true si le widget fonctionne à l'intérieur de dashboard, false s'il est seul sur une page |
aucun |
Appeler les fonctions communicateWithOther(true) et reset() |
|
> > |
initialise |
dashboardId : l'identifiant unique de ce widget. Il doit être inclut dans tous les attributs id qui sont créé dans le DOM, pour les distinguer des autres widgets du même type. postal : l'objet postal isInDashboard : true si le widget fonctionne à l'intérieur de dashboard, false s'il est seul sur une page |
aucun |
Appeler les fonctions communicateWithOther(true) et reset() |
|
|
communicateWithOther |
isCommunicating : booleen indiquant s'il faut activer ou désactiver la communication via postal |
aucun |
|
close |
aucun |
aucun |
Une implémentation minimum est this.communicateWithOther(false) |
|
|
< < |
shareUrl |
aucun |
une chaîne de caractère |
Utiliser la fonction utilities.paramsToUrlArguments |
|
> > |
shareUrl |
aucun |
aucun |
Affiche une boîte de dialogue, avec un lien. Peut utiliser la fonction utilities.paramsToUrlArguments |
|
|
reset |
aucun |
aucun |
Réinitialise tout le widget. Ràz des variables, création du DOM, qu'il faut ajouter : $('#' + dashboardId).html(…) |
saveAsPng |
aucun |
aucun |
|
sendSamp |
aucun |
aucun |
|
-- PascalWassong - 2017-03-28 |