Histórico da Página
Índice
Índice | ||
---|---|---|
|
...
|
...
|
Objetivo
Este guia é destinado aos desenvolvedores internos e externos do fluig que desejam utilizar o componente Listar compartilhamentos. O objetivo é apresentar o seu funcionamento e o detalhamento de todos os parâmetros de configuração.
Pré-requisitos
Conhecer os conceitos dos componentes de negócio do fluig, disponíveis na página Componentes de Negócio.
Componente Listar compartilhamentos
O componente Listar compartilhamentos tem como objetivo facilitar o processo de listagem de compartilhamentos de um conteúdo encapsulando todas as configurações básicas necessárias, restando para o desenvolvedor somente configurar o plugin e utilizar o callback para montar sua lógica de negócio.
Estrutura Básica
A seguir é apresentada a estrutura básica do componente:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
SOCIALBC.shareListModal(config, callback); |
...
O primeiro parâmetro espera um objeto contendo três atributos: sociableId, title e instanceId, onde sociableId é o único obrigatório.
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
var config - { sociableId: 10, //id do objeto social que vai ter a sua listagem exibida title: 'Compartilhado por', //o titulo que vai ser utilizado no modal instanceId : Date.now() }; |
O segundo parâmetro espera uma função que recebe dois valores: error e data.
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
function(error, data) { if(error) { //tratamento de erro... } //lógica do sucesso... } |
...
A utilização básica do componente é apresentada a seguir:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
var SocialTimeline = SuperWidget.extend({ sociableId: null, title: null, instanceId : null, bindings: { local: { 'fluig-list-share': ['click_listSharesAction'] } }, init: function() { this.sociableId = 10; this.title = 'Compartilhado por'; this.instanceId = Date.now(); }, listSharesAction: function(el, ev) { var that = this; SOCIALBC.shareListModal({ sociableId : that.sociableId, instanceId : that.instanceId, title : that.title }, function(err, data) { if(err) { return alert(err.responseText); } that.someFunc(data); }); }, someFunc: function(data) { //Qualquer coisa com o retorno de sucesso... } }); |
No application.info de seu widget, adicione o componente como dependência:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
application.resource.component.1=social/socialsharelist |
...
Tela exibida ao chamar o componente: