Histórico da Página
Índice
Índice | ||
---|---|---|
|
...
...
|
Objetivo
...
Este guia é destinado para aos desenvolvedores internos e externos do Fluig da plataforma que desejam utilizar o componente de Alterar imagem de usuário e comunidadede recorte de imagem. O objetivo é mostrar apresentar o seu funcionamento do mesmo e o detalhamento de todos os parâmetros de configuração.
...
Pré-requisitos
...
- Conhecer os conceitos dos componentes de negócio do TOTVS Fluig Plataforma, disponíveis na página Componentes de Negócio.
Recorte de imagem
...
O componente de Alterar imagem de usuário e comunidaderecorte de imagem tem como objetivo facilitar o processo de atualização de imagens de perfil encapsulando todas as configurações básicas necessárias para essa atualização, restando somente para para o desenvolvedor somente configurar o plugin e utilizar o callback para montar sua lógica de negócio.
Estrutura
...
Básica
...
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
WCMBC.cropImage(config, callback); |
...
Como podemos pode-se notar na estrutura básica, o componente recebe basicamente 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 atualização.
O primeiro parâmetro espera um objeto contendo três sete atributos: alias, title e types, onde os três parâmetros , types, imageShape, imageSrc, saveCallback e cancelCallback, onde os parâmetros são opcionais.
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
var config -= { alias: 'bruno.quadrotti', //alias do usuário/comunidade que será atualizada - Valor default: alias do usuário logado. title: 'Atualização de imagem de comunidade', //título do modal de troca de imagem. - Valor default: Editar foto types: 'gif|jpg|jpeg|tiff|png', //string contendo as extensões permitidas para atualização separado por pipeline "|". - Valor default: jpg|jpeg|png imageShape: 'rounded', //string com o formato de imagem a ser apresentado, conforme os formatos do guia de estilos('rounded', 'circle' ou '') imageSrc: 'http://www.fluig.com/assets/images/logo_fluig.png', //url da imagem saveCallback: function(data){}, //função callback para a ação de salvar imagem, onde "data" são as coordenadas definidas para o recorte da imagem cancelCallback: function(){}; |
...
//função callback callback para cancelar a função de crop
}; |
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
...
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
var UserPreferences = SuperWidget.extend({ alias: null, type: null, bindings: { local: { 'update-image': ['click_updateImage'] } }, init: function() { this.type = 'gif|jpg|jpeg|png'; }, updateImage: function(el, ev) { var that = this; WCMBC.cropImage({ alias: this.alias, types: this.type }, 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 sua Widget seu widget, adicione o componente como dependência:
Bloco de código | ||||||||
---|---|---|---|---|---|---|---|---|
| ||||||||
application.resource.component.1=wcm/cropimage |
...
Tela exibida ao chamar o componente
...
...