jQuery UI API - .toggle()

Categoría

Efectos | Núcleo de efectos (Effects Core) | Sobrecargas de métodos (Method Overrides) | Métodos

Uso

Descripción:Muestra u oculta los elementos coincidentes utilizando un efecto personalizado.

Devuelve:jQuery

.toggle( effect [, options ] [, duration ] [, complete ] )

Parámetro Tipo Descripción Valor por defecto
effect String Una cadena que indica qué tipo deefecto。
options Object La configuración específica del efecto yeasing。
duration Number o String Una cadena o un número que especifica cuánto tiempo durará la animación. 400
complete Function() Función que se llamará cuando la animación se complete.

.toggle( options )

Parámetro Tipo Descripción
options Object Todas las opciones de animación. La única propiedad requerida es effect.
  • effect
    Tipo: String
    Descripción: Una cadena que indica qué tipo deefecto。
  • easing(Valor por defecto:"swing")
    Tipo: String
    Descripción: Una cadena que indica laeasingfunción.
  • duration(Valor por defecto:400)
    Tipo: Number o String
    Descripción: Una cadena o un número que especifica cuánto tiempo durará la animación.
  • complete
    Tipo: Function()
    Descripción: Función que se llamará cuando la animación se complete.
  • queue(Valor por defecto:true)
    Tipo: Boolean o String
    Descripción: Un valor booleano que indica si la animación se coloca en la cola de efectos. Si es false, la animación comenzará de inmediato.A partir de jQuery 1.7, la opción queue también acepta una cadena; en este caso, la animación se agrega a la cola representada por la cadena.

Este plugin es una extensión del.toggle()método. Si jQuery UI no está cargado, llamar al.toggle()método no fallará directamente, porque este método existe en jQuery. Pero el comportamiento esperado no ocurrirá.

Ejemplo

Usa el efecto de plegado (Fold Effect) para alternar un div.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>.toggle() 演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <style>
  div {
    width: 100px;
    height: 100px;
    background: #ccc;
    border: 1px solid #000;
  }
  </style>
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<button>切换 div</button>
<div></div>
 
<script>
$( "button" ).click(function() {
  $( "div" ).toggle( "fold", 1000 );
});
</script>
 
</body>
</html>

Otras extensiones