Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Comentário: Atualização da nomenclatura da marca

Índice

Índice
outlinetrue

...

...

exclude.*ndice
stylenone


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
languagejs
themeEclipse
languagejs
titleEstrutura básica do componente
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: aliastitle 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
languagejs
themeEclipse
languagejs
titleParâmetro config
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
languagejs
themeEclipse
languagejs
titleParâmetro callback
function(error, data) {
	if(error) {
		//tratamento de erro...
	}
	
	//lógica do sucesso...
}

Utilização

...

Básica

...

Bloco de código
languagejs
themeEclipselanguagejs
titleminhawidget.js
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
languagebash
themeEclipse
languagebash
titleapplication.info
application.resource.component.1=wcm/cropimage

 

...


Tela exibida ao chamar o componente

...

...

Image Added