jun 302015
 

Manutenção em programas antigos invariavelmente vão dar dor de cabeça!

Ajustando um antigo software criado por outra equipe, foi necessário atualizar o jQuery.

Todas as novas implementações funcionaram bem, porém, o antigo datepicker (do jQuery UI) deu pau!

Qual o problema?

A partir da versão 1.9 o jQuery não mais dispõe da função $.browser.

As soluções possíveis:

1-Atualizar também o jQuery UI, porém, corre-se o risco de novos problemas em outras partes do aplicativo.

2-Ajustar o datepicker no braço para a nova versão do jQuery.

Optamos pela segunda:

O erro apresentado:

msie

 

Então, no arquivo do datepicker, temos o código:

1512

Alteramos para:

1512-2

E o resultado, tudo voltou a funcionar:

1512-3

Solução encontrada em:

https://www.drupal.org/node/1961178

 

 

nov 022014
 

Muito bem, direto ao problema:

Qual codificação de caracteres utilizar em seus aplicativos? Qual o Charset ideal?

Se usa algum framework, como Bootstrap e ou jQuery por exemplo, melhor usar UTF-8. Na Academia nosso padrão é UTF-8 sem BOM.

Porém, a maioria dos windows usa o padrão ISO 8859-1, causando os transtornos das imagens abaixo quando alguma de nossas configurações foi esquecida (em especial no Internet Explorer):

Capturar

Na imagem, a tela da mesma aplicação no Firefox é interpretada corretamente como UTF-8, O mesmo no Chrome, já no I.E…..aparece desconfigurado.

Cabe apontar que a página HTML informa corretamente a codificação:

html

Porém, nada feito! o I.E. Não reconhece….

E aqui mais uma dica, a declaração de charset deve estar dentre as primeiras no HEAD, na Academia por padrão usamos como a primeira, pois esta declaração deve estar dentre os primeiros 1024 bytes do arquivo, registrando a dica: Evite comentários demasiados no início do HTML, mais pode ser visto em: http://www.w3.org/International/questions/qa-html-encoding-declarations.en

A solução?

Usar um “hack” nos arquivos PHP, no início de cada arquivo PHP que retorna conteúdo utilizamos (também por padrão) a declaração:

header('Content-Type: text/html; charset=UTF-8');

Tal comando não necessária precisa estar no início do arquivo (o fazemos por questões de padronização).

E quanto ao UTF-8 com ou sem BOM?

O BOM, ou Byte Order Mark é um conjunto de caracteres enviados no início de cada arquivo codificado em UTF-8 com BOM. Tal conjunto tem utilidade no UTF-16 ou 32, sendo inútil no 8. Além de inútil ainda traz alguns problemas: com o BOM não é possível utilizar os comandos header do PHP, além de provocar retornos indevidos em aplicações AJAX, como na imagem abaixo (aliás, estes caracteres são o BOM…):

Byte Order Mark

 

Então, o resumo de como padronizamos cá na Academia, evitando muitos problemas:

  1. Todos os nossos editores de texto e IDE são configurados para adotar o UTF-8 sem BOM como padrão.
  2.  Todos os arquivos HTML tem a declaração de charset no início do Header, dentro do limite de 1024 bytes;
  3. Todos os arquivos PHP que retornam algum HTML tem a declaração  “header(…” no início do arquivo;
  4. Os bancos de dados são configurados como collation UTF-8 general_ci (no caso do MySQL).

Isto feito, raramente terá problemas com os malditos charset, principalmente no I.E..

É isso, até a próxima.

out 272014
 

O problema:

Temos um formulário que deve ser aberto para a edição, sendo que os dados são populados para o form via jQuery/AJAX/PHP/Mysql.
Resta um problema nos selects, como selecionar a option correta, de acordo com o que está armazenado no banco de dados?

A solução:

$("#eixo option:contains('"+valor_que_vem_do_banco+"')").attr('selected',true);

Pronto, a option que contém o valor que veio do banco será selecionada no Select indicado.

out 262014
 

O problema:

Temos uma aplicação com um form bastante complexo que, quando aberto para edição, preenche os dados via AJAX e, conforme for o resultado do AJAX e as permissões do usuários, ações possíveis são habilitadas.

O código usado (inicialmente):

$( document ).ready(function() {
 
	preenche_form();
	exibe_botoes();
	preenche_tema($('#acao_eixo'));
});

Porém, ocorre o seguinte: A função preenche_form(), que realiza a consulta via AJAX demora mais que as outras, assim, a função exibe_botoes() é executada antes do preenchimento do form, gerando um resultado indesejado pois, para habilitar os botões corretos, a exibe_form() depende do preenchimento da preenche_form().

Os botões a serem habilitados (um conjunto conforme o status preenchido no form pela função preenche_form()):

botoes

 

Num primeiro momento tentamos usar a função ‘when‘ do jQuery:

$( document ).ready(function() {
 
	$.when(preenche_form()).done(function(){exibe_botoes();});
 
         preenche_tema($('#acao_eixo'));
});

Porém, também não funcionou.

Resta então apresentar alguma teoria, estudar um pouco para compreender a solução:

jQuery e AJAX funcionam de forma assíncrona, ou seja, por óbvio, sem sincronia. É o que acontece no caso em comento, é chamada a função que preenche o formulário e, antes desta terminar, a aplicação já chama a segunda que habilita os botões, porém, esta segunda depende do resultado da primeira, assim, o negócio simplesmente não funciona, nenhum botão da aplicação é habilitado nunca, pois a segunda função não tem parâmetros para trabalhar.

Assim, é necessário alterar o comportamento padrão do jQuery, ou seja, torná-lo síncrono, com execução em sequência, aguardando o término da primeira função para só então executar a segunda.

E aqui mais um pouco de aprendizado:

O jQuery tem funções de categoria “Deferreds”, ou diferidas, adiadas. Mas o que isso significa na prática?

Quando uma função desse tipo é chamada, normalmente as de execução mais demorada, a função retorna uma “promise”, ou promessa, de que irá concluir em algum momento, porém, o programa não espera e, enquanto aguarda o “cumprimento da promessa” já vai chamando as funções seguintes. Tá aí a execução assíncrona.

Como exemplos de função “deferred” temos o $.ajax e $.animate.

As funções que criamos, como as do exemplo, em regra não são do tipo deferred, assim, usar when com estas funções, não vai dar resultado algum, vai continuar sendo executado “tudo junto”.

Aliás, a função when existe justamente para que possamos, conforme a necessidade de nossa aplicação, executar funções de forma encadeada, ou seja, assim que esta terminar, execute esta….

Com uma leve pincelada de compreensão de como funciona o trem, podemos concluir então que não tem jeito, certo?

Errado!

O jQuery oferece ferramentas para transformarmos qualquer função comum no tipo deferred.

Vamos a como fazer:

Na função preenche_form() incluímos as funções Deferred, promise e resolve:

function preenche_form()
{
     atrasa=new $.Deferred(); //avisa que é uma função do tipo diferido, mesmo que originalmente não fosse
 
     //seu código
 
     atrasa.resolve(); //avisa que a função terminou, coloque no ponto em que as ações terminam (pode ser usado mais de um...)
 
     //seu código
 
     return atrasa.promise(); //envia a promessa que vai terminar alguma hora
};

 

É isso, problema resolvido, em, breve um modelinho funcional.

Um pouco de história:

Outros meios de se fazer a mesma coisa é com callbacks, ou seja, encadear as funções de modo a executar uma por vez, comprometendo a performance. Outro método um pouco menos pior, era usar Timeouts nas funções, ou loops que eram executados enquanto a função não terminava. O when certamente é uma solução mais elegante.

 

 

out 242014
 

O causo:

Para uma campanha de entidade beneficente local nos feita a seguinte encomenda:

Será promovida uma festa beneficente, para a qual serão vendidos ingressos, com o objetivo de adquirir uma ambulância para a entidade. A proposta: Colocar na página inicial do site da entidade uma ambulância em preto e branco e, na medida, que forem sendo vendidos os ingressos, no total de 10 mil, a ambulância vai colorindo-se.

Apesar de extremamente simples, não encontramos algo do tipo em nossas pesquisas, assim vamos à solução:

Usar duas imagens sobrepostas, um PB outra colorida, formatadas via CSS, com alterações dinâmicas via jQuery.

Esta é a imagem inicial, com 0% de preenchimento:

ab

Seguida da função que faz a variação:

 

	function colore()
	{
	/*ATENÇÃO:
		Função não otimizada, para efeitos didáticos!
		*/
 
		//captura o tamanho da imagem:
				largura=$('#imagem').width();
				altura=$('#imagem').height();
		//valor (em percentual) do campo:
				percentual=parseInt($('#valor').val(),10);
					//valida o dado recebido, se for inválido, assumirá 50(%)
 
					if(percentual)
					{
						if(percentual<0||percentual>100)
						{percentual=50;};
					}
					else
					{percentual=50};
 
		//calcula o tamnho da imagem, conforme o percentual:
			largura_sobreimagem=parseInt(largura*percentual/100);
			altura_sobreimagem=parseInt(altura*percentual/100);
 
		//atribui o valor à sobreimagem:
			css_sobreimagem="clip:rect(0px,"+largura_sobreimagem+"px,"+altura_sobreimagem+"px,0px)";
 
			$('#imagem').css({"clip":"rect(0px,"+largura_sobreimagem+"px,"+altura_sobreimagem+"px,0px"});
		/*
		No caso, a sobreimagem varia na vertical e na horizontal, apenas para demonstrar as possibilidades do efeito,
		na prática, foi usado somente na horizontal para melhor visualização.
		No estilo acima, a imagem já começa como "meio colorida" apenas para efeito demonstrativo
		*/
 
	};

Chegando a este resultado:

ab2

 

Pronto, simples e rápido.

Aqui os arquivos para download: .imagem_sobre_imagem

(A imagem da ambulância é promocional da FIAT/Ducato)

out 232014
 

O problema é o seguinte:

Temos uma tabela com dados de pedidos, preenchida dinamicamente com AJAX/PHP/MySQL.

Até aí ok, porém, para facilitar a visualização, pretendemos colorir a linha (cada linha representa um pedido) conforme o valor da célula que contém a informação de estatus do pedido.

Antes da função jQuery, temos:

tabela2

function colore_tabela()
    {
        /*
         * TEMOS 8 Status possíveis, com sua cores respectivas:
         *  1-salva;                    branca
         *  2-aguardando validação;     azul
         *  3-não validada;             amarelo
         *  4-aguardando aprovação;     azul
         *  5-aprovada;                 verde
         *  6-não aprovada;             amarelo
         *  7-cancelada;                vermelho
         *  8-concluida;                verde
 
      */
 
$('#t_dados').find('tr').each(function(indice){
switch($(this).children().eq(0).text())
{
 
case 'aguardando validação':
case 'aguardando aprovação':
$(this).prop('class','info');
break;
 
case 'não validada':
case 'não aprovada':
$(this).prop('class','warning');
break;
 
case 'aprovada':
case 'concluida':
$(this).prop('class','success');
break;
 
case 'cancelada':
$(this).prop('class','danger');
break;
 
};
});
}

Foram usadas as classes do Bootstrap 3.0 para tebelas: http://getbootstrap.com/css/#tables-contextual-classes

Após:

tabela1

Visualização melhorada, com poucos comandos e processamento client-side, certamente uma boa pedida.

 

Neste caso específico, criamos uma função isolada que é chamada depois da execução do AJAX, porém, caso sua tabela já venha preenchida, podes chamá-la logo ao carregar a página, com esta sugestão (ou mesmo através de função anônima):

$( document ).ready(function(){
		colore_tabela();
		});

 

Para entender um pouco mais:

Usamos a função .each() para percorrer cada linha da tabela, em seguida, selecionamos com children(), seguido de eq(0) o texto da primeira célula, logo, se quiser alterar qual célula será testada, basta alterar o índice, onde 0 representa a primeira coluna, 1 a segunda e assim por diante.

 

Até a próxima.