Um widget de referência para uma implementação de visualizador de feed Atom, esse widget busca um a partir da URL especificada e exibe, em ordem cronológica, títulos de entrada e elementos atualizados. Esse widget suporta eventos de cliente para realçar uma entrada e publica a entrada selecionada no tópico especificado.
Variáveis do Widget | ||
---|---|---|
String | url | A URL a partir da qual o feed Atom é recuperado |
String | entrySelectionTopic | O tópico para assinatura e publicação. Isso ativa uma comunicação bilateral entre os widgets FeedViewer e FeedEntryViewer ou FeedEntryEditor. |
Booleano | localSaveOnly | Indica se entradas atualizadas (se estiver utilizando um FeedEntryEditor para exibir ou editar entradas) devem ser enviadas de volta para o servidor |
Funções do Widget | |
---|---|
void | clear() Limpa todas as entradas atuais na visualização de feed |
void | setFeedFromUrl(String url) Configura o feed a partir de uma URL |
void | setFeed(ibm_atom.io.atom.Feed feed) Configura os dados do feed a serem exibidos |
void | appendGrouping(String titleText) Anexa um novo agrupamento de entradas ao texto do título especificado |
void | appendEntry(ibm_atom.io.atom.Entry entry) Anexa uma entrada à visualização do feed |
void | onEntrySelected(ibm_atom.io.Entry entry) Destinada como um ponto de anexação, essa função é chamada quando uma entrada é selecionada |
void | addCategoryIncludeFilter(Object filter) Inclui um filtro para inclusão de entrada na visualização do feed |
void | removeCategoryIncludeFilter(Object filter) Remove um filtro da inclusão de entrada na visualização do feed |
void | destroy() Destrói o widget, inclusive todos os descendentes e assinaturas |
Detalhes das Funções do 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("Sexta-feira, 6 de janeiro de 2007");
Esse widget exibe um elemento de entrada individual. Uma barra é fornecida no topo com um menu para ativar ou desativar elementos específicos. Os elementos visualizáveis podem ser determinados no tempo de criação. Além das funções descritas na tabela a seguir, existem várias funções adicionais, utilizadas principalmente internamente, para configurar o valor de diversos nós na página.
Variáveis do Widget | ||
---|---|---|
Booleano | enableMenu | Indica se o menu deve ser ativado, permitindo que você comute a exibição dos elementos de entrada. |
Booleano | enableMenuFade | Indica se um efeito de esmaecimento suave é utilizado para o menu descrito acima. |
Booleano | enableEdit | Indica se as funções de edição são ativadas. Esse sinalizador é utilizado apenas se você estiver utilizando o widget FeedEntryEditor, que estende esse widget. |
String | displayEntrySections | Os elementos de entrada a serem exibidos como uma lista separada por vírgula. As seções disponíveis são título, autores, contribuidores, resumo, conteúdo, ID e atualizado. |
String | entrySelectionTopic | O tópico para assinatura e publicação. Isso ativa uma comunicação bilateral entre os widgets FeedViewer e FeedEntryViewer ou FeedEntryEditor. |
Funções do Widget | |
---|---|
void | clear() Limpa o estado completo desse widget, limpando inclusive a entrada específica exibida e o feed ao qual ela pertence |
void | clearNodes() Limpa os nós de exibição desse widget |
void | setEntry(ibm_atom.io.atom.Entry entry, ibm_atom.io.atom.Feed feed,
Boolean leaveMenuState) Configura a entrada que esse visualizador está exibindo |
Detalhes das Funções do Widget |
---|
Essa função limpa todos os dados associados ao estado desse widget, inclusive a entrada que esse widget está exibindo, o feed ao qual ela pertence, etc. Também chama a função clearNodes para limpar os dados exibidos.
Essa função limpa os nós de exibição de quaisquer dados relacionados à entrada e configura o widget para seu estado de exibição inicial.
Configura a entrada que esse widget deverá exibir. O valor leaveMenuState indica se você deve manter o estado atual do menu ou reconfigurá-lo para os valores padrão.
Esse widget exibe os elementos de um indivíduo e também permite que edições sejam feitas nessa entrada, se a entrada tiver um link com um atributo rel equivalente a "edit". Esse widget não executa nenhum trabalho de envio de edições de volta como pedidos. Em vez disso, o widget atualiza sua renderização e envia as atualizações no entrySelectionTopic e permite que o widget FeedViewer manipule o envio dos dados.
Conforme mencionado, esse widget estende o widget FeedEntryEditor; portanto, todas as suas variáveis e funções são herdadas. Entretanto, esse widget substitui as funções não documentadas, mencionadas anteriormente, que configuram os valores dos nós de exibição, uma vez que ele deve substituir o valor por um objeto do editor no evento em que essa entrada está sendo editada. Esse widget não possui variáveis ou funções adicionais sobre o FeedEntryViewer. Para as variáveis e funções apropriadas, consulte aqui e aqui, respectivamente.