Éste es un widget de referencia para una implementación de visor de canal de información Atom que capta un canal de información del URL proporcionado y muestra, en orden cronológico, los títulos de entrada y los elementos actualizados. Este widget da soporte a los sucesos de pulsación para resaltar una entrada y publica la entrada seleccionada en el tema dado.
Variables del widget | ||
---|---|---|
Serie | url | El URL desde el que se recupera el canal de información Atom |
Serie | entrySelectionTopic | El tema para la suscripción y la publicación. Esto permite una comunicación bidireccional entre los widgets FeedViewer y FeedEntryViewer o FeedEntryEditor. |
Booleano | localSaveOnly | Determina si se deben enviar las entradas actualizadas (si se utiliza FeedEntryEditor para visualizar o editar entrada) de nuevo al servidor |
Funciones del widget | |
---|---|
void | clear() Borra todas las entradas actuales en la vista del canal de información |
void | setFeedFromUrl(String url) Establece el canal de información de un URL |
void | setFeed(ibm_atom.io.atom.Feed feed) Establece los datos del canal de información que se van a visualizar |
void | appendGrouping(String titleText) Añade una nueva agrupación de entradas con el texto de título dado |
void | appendEntry(ibm_atom.io.atom.Entry entry) Añade una entrada a la vista del canal de información |
void | onEntrySelected(ibm_atom.io.Entry entry) Especialmente indicada como un punto de conexión, esta función se invoca cuando se selecciona una entrada |
void | addCategoryIncludeFilter(Object filter) Añade un filtro para la inclusión de la entrada en la vista del canal de información |
void | removeCategoryIncludeFilter(Object filter) Elimina un filtro para la inclusión de la entrada en la vista del canal de información |
void | destroy() Destruye el widget, incluidos todos los descendientes y las suscripciones |
Detalles de las funciones del 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("Friday, January 6, 2007");
Este widget muestra elementos de entrada individuales. Se proporciona una barra en la parte superior con un menú para activar o desactivar elementos específicos. Todos los elementos visualizables pueden dictarse en el momento de su creación. Además de las funciones que se describen en la tabla siguiente, existen varias funciones adicionales que se utilizan principalmente de forma interna para establecer el valor de los distintos nodos de la página.
Variables del widget | ||
---|---|---|
Booleano | enableMenu | Determina si se habilita el menú, lo que permite conmutar la pantalla de los elementos de entrada. |
Booleano | enableMenuFade | Indica si se utiliza un efecto de atenuación moderno para el menú descrito anteriormente. |
Booleano | enableEdit | Indica si están habilitadas las funciones de edición. Este distintivo sólo se utiliza si se emplea el widget FeedEntryEditor, que amplía este widget. |
Serie | displayEntrySections | Los elementos de entrada que se visualizan como una lista separada por comas. Las secciones disponibles son título, autores, colaboradores, resumen, contenido, ID y actualizado. |
Serie | entrySelectionTopic | El tema para la suscripción y la publicación. Esto permite una comunicación bidireccional entre los widgets FeedViewer y FeedEntryViewer o FeedEntryEditor. |
Funciones del widget | |
---|---|
void | clear() Borra el estado total de este widget, incluido el borrado de la entrada específica visualizada y el canal de información al que pertenece |
void | clearNodes() Borra los nodos de visualización de este widget |
void | setEntry(ibm_atom.io.atom.Entry entry, ibm_atom.io.atom.Feed feed,
Boolean leaveMenuState) Establece la entrada que muestra este visor |
Detalles de las funciones del widget |
---|
Esta función borra todos los datos asociados con el estado del widget, incluida la entrada específica que muestra el widget, el canal de información al que pertenece, etc. También invoca la función clearNodes para borrar los datos visualizados.
Esta función borra los nodos de visualización de los datos relacionados con la entrada y establece el widget en su estado de visualización inicial.
Establece la entrada que muestra este widget. El valor leaveMenuState indica si se debe mantener el estado actual del menú o restablecerlo a los valores por omisión.
Este widget muestra los elementos de una persona, a la vez que permite realizar ediciones en esta entrada, si la entrada tiene un enlace con un atributo rel igual a "edit". El widget no vuelve a enviar las ediciones de nuevo como peticiones. En su lugar, el widget actualiza la representación y envía las actualizaciones en entrySelectionTopic, y permite que el widget FeedViewer maneje el envío de los datos.
Como se ha descrito, el widget amplía el FeedEntryEditor; por lo tanto, todas sus variables y funciones son heredadas. No obstante, este widget altera temporalmente las funciones no documentadas citadas previamente que establecen los valores de nodo de visualización, ya que debe sustituir el valor por un objeto de editor en el caso de que se edite esta entrada. El widget no tiene variables o funciones adicionales comparado con FeedEntryViewer. Para ver las variables y funciones correspondientes, pulse aquí y aquí, respectivamente.