Histórico da Página
...
Nota | ||
---|---|---|
| ||
Esta página deverá se tornar filha de: Componentes de Negócio |
...
Índice
Índice | ||||||
---|---|---|---|---|---|---|
|
Objetivo
Este guia é destinado aos desenvolvedores internos e externos do Fluig fluig que desejam utilizar o componente Seleção de Comunidades comunidades para recuperar a comunidade desejada e utiliza-la em seu componente ou widget. O objetivo é apresentar o seu funcionamento e o detalhamento de todos os parâmetros de configuração.
Componente Seleção de
...
comunidades
O componente Seleção de Comunidadescomunidades tem como objetivo facilitar a etapa de seleção de uma ou mais comunidades, encapsulando todas as configurações básicas necessárias para essa operação, 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:
...
O componente recebe dois parâmetros: o primeiro, um objeto config com as configurações do componente e o segundo, uma função callback contendo o erro e/ou o sucesso da seleção.
O primeiro parâmetro espera um objeto contendo dois atributos: multiselect, e required, sendo os dois opcionais.
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
var config - { multiselect: true, //opção que determina se é possível a seleção de uma ou mais comunidades do componente. - Valor default: true required: true //opção que determina se a seleção de comunidade é uma etapa obrigatório no fluxo. - Valor default: false }; |
...
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... } |
...
Utilização Básica
A utilização básica do componente é apresentada a seguir:
Bloco de código | ||||||
---|---|---|---|---|---|---|
| ||||||
var GlobalSearch = SuperWidget.extend({ alias: null, bindings: { local: { 'select-comunity': ['click_selectCommunity'] } }, init: function() { //init essential params }, selectCommunity: function(el, ev) { var that = this; SOCIALBC.selectCommunity({ multiselect : false, required : true }, function(data) { 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:
...