Il s'agit d'un widget utilisé pour l'implémentation d'un visualiseur de flux Atom. Il récupère un flux depuis une adresse URL donnée, et affiche les titres des entrées et des éléments mis à jour selon un ordre chronologique. Ce widget prend en charge les événements de clic pour mettre une entrée en évidence et publie cette même entrée dans une rubrique donnée.
Variables de widget | ||
---|---|---|
String (chaîne) | url | Adresse URL à partir de laquelle le flux Atom est récupéré |
String (chaîne) | entrySelectionTopic | Rubrique qui traite de l'abonnement et de la publication. Elle permet une transmission bidirectionnelle entre les widgets Feedviewer et FeedEntryViewer ou FeedEntryEditor. |
Booléen | localSaveOnly | Utilisé pour renvoyer des entrées mises à jour (si le widget FeedEntryEditor est utilisé pour afficher ou éditer des entrées) vers le serveur |
Fonctions Widget | |
---|---|
void | clear() Efface toutes les entrées actuelles figurant dans l'affichage du flux |
void | setFeedFromUrl(String url) Définit le flux depuis une adresse URL |
void | setFeed(ibm_atom.io.atom.Feed feed) Définit les données de flux à afficher |
void | appendGrouping(String titleText) Ajoute un nouveau groupe d'entrées avec un texte du titre donné |
void | appendEntry(ibm_atom.io.atom.Entry entry) Ajoute une entrée dans l'affichage du flux |
void | onEntrySelected(ibm_atom.io.Entry entry) Cette fonction étant considérée comme point d'attache, elle peut être utilisée lorsqu'une entrée est sélectionnée |
void | addCategoryIncludeFilter(Object filter) Ajoute un filtre permettant d'insérer une entrée dans l'affichage du flux |
void | removeCategoryIncludeFilter(Object filter) Supprime un filtre permettant d'insérer une entrée dans l'affichage du flux |
void | destroy() Supprime le widget, y compris tous les descendants et les abonnements |
Détails sur les fonctions Widget |
---|
feedViewer.setFeedFromUrl("http://googleblog.blogspot.com/atom.xml") ;
var atomIO = new ibm_atom.io.atom.AtomIO(); atomIO.getFeed(feedURI,feedHandler) ; function feedHandler(feed,domNode){ feedViewer.setFeed(feed) ; }
feedViewer.appendGrouping("vendredi 6 janvier 2007") ;
Ce widget affiche des éléments d'entrée individuelle. Une barre de menu permettant d'activer/désactiver des éléments spécifiques se trouve dans la partie supérieure de ce widget. Les éléments visibles peuvent être dictés lors de la création. Outre les fonctions figurant dans le tableau suivant, il existe plusieurs fonctions supplémentaires, utilisées principalement à l'intérieur du widget, pour définir la valeur des différents noeuds de la page.
Variables du widget | ||
---|---|---|
Booléen | enableMenu | Utilisé pour activer le menu afin de faire basculer l'affichage des éléments d'entrée |
Booléen | enableMenuFade | Indique si un effet estompé est appliqué au menu indiqué ci-dessus. |
Booléen | enableEdit | Indique si les fonctions d'édition sont activées. Cette option est appliquée uniquement lorsque le widget FeedEntryEditor, qui est un complément de ce widget, est utilisé. |
String (chaîne) | displayEntrySections | Eléments d'entrée à afficher sous forme de liste séparée par des virgules. Les sections disponibles correspondent aux éléments suivants : le titre, les auteurs, les collaborateurs, le résumé, le contenu, l'ID et la mise à jour. |
String (chaîne) | entrySelectionTopic | Rubrique qui traite de l'abonnement et de la publication. Elle permet une transmission bidirectionnelle entre les widgets Feedviewer et FeedEntryViewer ou FeedEntryEditor. |
Fonctions Widget | |
---|---|
void | clear() Supprime complètement le widget, y compris les entrées spécifiques affichées, ainsi que le flux correspondant |
void | clearNodes() Supprime les noeuds d'affichage de ce widget |
void | setEntry(ibm_atom.io.atom.Entry entry, ibm_atom.io.atom.Feed feed,
Boolean leaveMenuState) Définit l'entrée affichée par ce visualiseur |
Détails sur les fonctions Widget |
---|
Cette fonction efface toutes les données associées à l'état de ce widget, y compris l'entrée affichée par ce widget, le flux correspondant, etc. Elle utilise également la fonction clearNodes pour supprimer les données affichées.
Cette fonction supprime les noeuds d'affichage de toute donnée relative à l'entrée, puis réinitialise l'état d'affichage du widget.
Définit l'entrée affichée par ce widget. La valeur leaveMenuState indique si vous devez garder l'état actuel du menu ou si vous devez rétablir ses valeurs par défaut.
Ce widget affiche les éléments personnels d'un individu et permet à d'autres utilisateurs de modifier l'entrée, si cette entrée présente un lien avec un attribut qui équivaut à "edit". Ce widget ne renvoie pas les modifications sous forme de demande. En revanche, il effectue la mise à jour de son rendu et envoie les mises à jours vers la chaîne entrySelectionTopic. Il permet ainsi au widget FeedViewer de procéder à l'envoi des données.
Comme mentionné auparavant, ce widget est un complément du FeedEntryEditor. Il présente donc les mêmes variables et les mêmes fonctions que ce dernier. Cependant, ce widget annule les fonctions non répertoriées (mentionnées auparavant) qui définissent les valeurs des noeuds d'affichage, car il doit remplacer ces valeurs à l'aide d'un objet éditeur lorsque l'entrée est en cours de modification. Ce widget ne présente aucune variable ni fonction différente de celles du widget FeedEntryViewer. Pour voir les variables et fonctions appropriées, cliquez respectivement ici et ici.