Categories

jQuery.removeData()

Categories: Utilities | Data

jQuery.removeData( element, [ name ] )Returns: jQuery

Description: Remove a previously-stored piece of data.

  • jQuery.removeData( element, [ name ] )

    version added: 1.0

    element   A DOM element from which to remove data.

    name   A string naming the piece of data to remove.

Note: This is a low-level method, you should probably use .removeData() instead.

The jQuery.removeData() method allows us to remove values that were previously set using jQuery.data(). When called with the name of a key, jQuery.removeData() deletes that particular value; when called with no arguments, all values are removed.

  • Set a data store for 2 names then remove one of them.

    HTML:
    <div>value1 before creation: <span></span></div>
    		<div>value1 after creation: <span></span></div>
    		<div>value1 after removal: <span></span></div>
    		<div>value2 after removal: <span></span></div>
    CSS:
    
    		div { margin:2px; color:blue; }
    		span { color:red; }
    		
    Code:
    
    var div = $("div")[0];
    $("span:eq(0)").text("" + $("div").data("test1"));
    jQuery.data(div, "test1", "VALUE-1");
    jQuery.data(div, "test2", "VALUE-2");
    $("span:eq(1)").text("" + jQuery.data(div, "test1"));
    jQuery.removeData(div, "test1");
    $("span:eq(2)").text("" + jQuery.data(div, "test1"));
    $("span:eq(3)").text("" + jQuery.data(div, "test2"));