Toggle Button That When Pressed Again Has No Effect

.toggle( [duration ] [, consummate ] ) Returns: jQuery

Description: Brandish or hide the matched elements.

• version added: i.0 .toggle( [duration ] [, complete ] )

  • duration (default: 400)

    A cord or number determining how long the blitheness will run.

  • complete

    A function to phone call once the animation is consummate, called once per matched element.

• version added: 1.0 .toggle( options )

  • options

    A map of additional options to pass to the method.

    • duration (default: 400)

      A string or number determining how long the animation volition run.

    • easing (default: swing)

      A string indicating which easing part to use for the transition.

    • queue (default: true)

      A Boolean indicating whether to identify the animation in the effects queue. If false, the animation will begin immediately. As of jQuery 1.7, the queue option tin too accept a string, in which example the animation is added to the queue represented by that string. When a custom queue name is used the animation does not automatically kickoff; you must call .dequeue("queuename") to beginning it.

    • specialEasing

      An object containing 1 or more than of the CSS backdrop divers by the properties statement and their corresponding easing functions. (version added: 1.four)

    • stride

      A office to be called for each blithe belongings of each blithe chemical element. This office provides an opportunity to change the Tween object to change the value of the property before it is set.

    • progress

      A function to be chosen after each step of the animation, only once per blithe element regardless of the number of animated properties. (version added: 1.8)

    • complete

      A office that is called once the animation on an element is consummate.

    • kickoff

      A office to call when the animation on an element begins. (version added: 1.8)

    • done

      A part to be called when the animation on an element completes (its Promise object is resolved). (version added: ane.8)

    • fail

      A office to be called when the animation on an chemical element fails to consummate (its Promise object is rejected). (version added: 1.viii)

    • always

      A function to be chosen when the animation on an element completes or stops without completing (its Promise object is either resolved or rejected). (version added: 1.8)

• version added: one.four.3 .toggle( duration [, easing ] [, complete ] )

  • duration (default: 400)

    A string or number determining how long the blitheness will run.

  • easing (default: swing)

    A string indicating which easing role to use for the transition.

  • complete

    A function to telephone call once the animation is complete, chosen once per matched chemical element.

• version added: one.3 .toggle( display )

  • display

    Use true to show the element or false to hibernate it.

Note: The event handling suite too has a method named .toggle(). Which one is fired depends on the ready of arguments passed.

With no parameters, the .toggle() method simply toggles the visibility of elements:

The matched elements will be revealed or hidden immediately, with no animation, by changing the CSS display property. If the element is initially displayed, it will exist subconscious; if subconscious, it will exist shown. The brandish property is saved and restored as needed. If an element has a display value of inline, and so is hidden and shown, it will again exist displayed inline.

When a elapsing, a obviously object, or a single "complete" role is provided, .toggle() becomes an animation method. The .toggle() method animates the width, top, and opacity of the matched elements simultaneously. When these properties reach 0 subsequently a hiding animation, the display style holding is ready to none to ensure that the chemical element no longer affects the layout of the page.

Durations are given in milliseconds; college values bespeak slower animations, not faster ones. The strings 'fast' and 'deadening' can be supplied to indicate durations of 200 and 600 milliseconds, respectively.

Equally of jQuery i.four.iii, an optional string naming an easing function may exist used. Easing functions specify the speed at which the animation progresses at different points within the animation. The but easing implementations in the jQuery library are the default, called swing, and one that progresses at a constant footstep, chosen linear. More easing functions are available with the use of plug-ins, most notably the jQuery UI suite.

If supplied, the callback is fired once the animation is complete. This can be useful for stringing different animations together in sequence. The callback is non sent whatsoever arguments, simply this is set to the DOM element being animated. If multiple elements are animated, it is important to note that the callback is executed once per matched chemical element, not once for the blitheness every bit a whole.

Nosotros tin can animate any element, such as a uncomplicated image:

1 2 3 4

<img id="volume" src="volume.png" alt="" width="100" top="123">

We volition cause .toggle() to be called when another element is clicked:

ane 2 iii 4 5

$( "#clickme" ).click( function() { $( "#book" ).toggle( "slow", function() {

With the element initially shown, we can hibernate it slowly with the first click:

Figure 1 - Illustration of the toggle() effect when hiding the image

A 2nd click volition bear witness the chemical element again:

Effigy 2 - Illustration of the toggle() effect when showing the paradigm

The 2nd version of the method accepts a Boolean parameter. If this parameter is true, and so the matched elements are shown; if false, the elements are subconscious. In essence, the statement:

1	$( "#foo" ).toggle( display );

is equivalent to:

1 ii 3 4 5

if ( brandish === true ) { } else if ( brandish === false ) {

Additional Notes:

• All jQuery effects, including .toggle(), can exist turned off globally by setting jQuery.fx.off = truthful, which effectively sets the duration to 0. For more than information, see jQuery.fx.off.

Examples:

Toggles all paragraphs.

1 2 3 4 5 half-dozen 7 eight ix x 11 12 13 xiv fifteen xvi 17 18 19 xx 21

<championship>toggle demo</title> <script src="https://lawmaking.jquery.com/jquery-3.5.0.js"> </script> <p style="display: none">Proficient Bye</p> $( "button" ).click( office() {

Demo:

Animates all paragraphs to be shown if they are hidden and subconscious if they are visible, completing the animation within 600 milliseconds.

1 2 3 iv five 6 vii eight nine 10 eleven 12 13 14 xv 16 17 18 19 20 21 22 23 24 25 26 27 28

<title>toggle demo</championship> <script src="https://lawmaking.jquery.com/jquery-3.5.0.js"> </script> <button>Toggle 'em</push> <p>Such interesting text, eh?</p> $( "button" ).click( office() { $( "p" ).toggle( "slow" );

Demo:

Shows all paragraphs, and then hides them all, back and forth.

1 ii 3 4 5 6 7 8 9 ten 11 12 xiii xiv 15 16 17 18 19 twenty 21 22

<title>toggle demo</championship> <script src="https://lawmaking.jquery.com/jquery-3.5.0.js"> </script> <p way="display: none">Expert Good day</p> $( "button" ).click( office() { $( "p" ).toggle( flip++ % ii === 0 );

Demo:

rothscom1980.blogspot.com

Source: https://api.jquery.com/toggle/

Share this post