Método slideDown

O método slideDown exibe suavemente elementos ocultos, deslizando-os de cima para baixo. Os elementos podem ser ocultados usando o método slideUp.

Sintaxe

Exibição em um tempo definido, 400ms por padrão:

.slideDown(duração);

O tempo pode ser definido não apenas em milissegundos, mas também com as palavras-chave slow (600ms) e fast (200ms), quanto maior o valor, mais lenta a animação:

.slideDown('slow' ou 'fast');

Se nenhum parâmetro for especificado - não haverá animação, os elementos serão exibidos instantaneamente:

.slideDown();

Também é possível passar uma função de easing como segundo parâmetro, e um callback como terceiro parâmetro - será executado após a conclusão da animação. Ambos os parâmetros são opcionais:

.slideDown(duração, [função de easing], [função de callback]);

É possível passar várias opções para o método, na forma de um objeto JavaScript, contendo pares chave: valor:

.slideDown(opções);

Tal objeto pode passar os seguintes parâmetros e funções - duration, easing, queue, specialEasing, step, progress, complete, start, done, fail, always. A descrição desses parâmetros pode ser consultada para o método animate. Por exemplo, vamos definir a duração e a função de easing:

.slideDown( {duration: 600, easing: easeInSine} );

Exemplo

Vamos, após clicar no botão, exibir suavemente um parágrafo oculto usando o método slideDown. Passando a palavra-chave slow, definiremos a velocidade para 600ms. Após o término da animação, exibiremos no console 'Animation complete':

<button>mostrar texto</button>
<p style="display: none">texto</p>

$('button').click(function() {
	$('p').slideDown('slow', function() {
		console.log('Animation complete')
	});
});

Veja também

método slideUp,
que oculta elementos suavemente
método slideToggle,
que alterna a exibição/ocultação suave de elementos
método fadeIn,
que exibe elementos ocultos suavemente, tornando-os opacos
método show,
que exibe elementos suavemente