fn.toggle(handler(eventObject), handler(eventObject)...) 去哪儿了？

Question

我有this jsfiddle

使用toggle event - 不要与toggle 混淆 - jQuery 版本设置为 EDGE

它突然停止工作并删除了我想要作为触发器的单元格，因为它显然恢复为toggle。

我找不到任何弃用标签等

http://api.jquery.com/category/deprecated/ 给出 404

如果我将 Migrate 模块添加到我的 jsFiddle then works 并在控制台中看到警告（由 Frédéric Hamidi 发布的 https://github.com/jquery/jquery-migrate/blob/master/warnings.md 详细说明）

我看到了 Deprecate fn toggle 和 issue 24 和 Ticket #11786，但不是在我希望看到的地方。

我遗漏了什么，我在哪里可以找到它的替代品和文档？

注意：我了解弃用的原因，我只是找不到 官方 弃用文档

$('#tbl .xx').toggle(
  function() {
    $(this).siblings().each(function(){
      var t = $(this).text();
      $(this).html($('<input />',{'value' : t}));
    });
  },
  function() {
    $(this).siblings().each(function(){
      var inp = $(this).find('input');
      if (inp.length){
        $(this).text(inp.val());
      }
    });
  }    
);

MIGRATE 中的代码：

jQuery.fn.toggle = function( fn, fn2 ) {
  // Don't mess with animation or css toggles
  if ( !jQuery.isFunction( fn ) || !jQuery.isFunction( fn2 ) ) {
    return oldToggle.apply( this, arguments );
  }
  migrateWarn("jQuery.fn.toggle(handler, handler...) is deprecated");
  // Save reference to arguments for access in closure
  var args = arguments,
  guid = fn.guid || jQuery.guid++,
  i = 0,
  toggler = function( event ) {
    // Figure out which function to execute
    var lastToggle = ( jQuery._data( this, "lastToggle" + fn.guid ) || 0 ) % i;
    jQuery._data( this, "lastToggle" + fn.guid, lastToggle + 1 );
    // Make sure that clicks stop
    event.preventDefault();
    // and execute the function
    return args[ lastToggle ].apply( this, arguments ) || false;
  };
  // link all the functions, so any of them can unbind this click handler
  toggler.guid = guid;
  while ( i < args.length ) {
    args[ i++ ].guid = guid;
  }
  return this.click( toggler );
};

更新我已经问过他们是否可以将代码保留为 fn.toggler 所以它是重命名而不是删除

Answer 1

jquery .toggle() 的弃用现在记录在 api.jquery.com。 我在forum.jquery 找到了一个很好的替代品，我现在正在使用它。效果很好:)

$.fn.toggleClick = function() {
  var functions = arguments,
      iteration = 0;
  return this.click(function() {
    functions[iteration].call();
    iteration = (iteration + 1) % functions.length;
  });
}

用法：

$("#target").toggleClick(function() {
  alert( "First handler for .toggle() called." );
}, function() {
  alert( "Second handler for .toggle() called." );
});

2014 年 8 月 6 日编辑：我重新考虑了原始代码，发现 .apply 不适合使用。将其更改为 .call 且不传入任何参数。

Answer 2

你可以在the list of warnings emitted by the jQuery Migrate plugin找到关于toggle()'s deprecation的官方文档：

JQMIGRATE：jQuery.fn.toggle(handler, handler...) 已弃用

原因：.toggle()有两种完全不同的含义 方法。使用.toggle() 显示或隐藏元素不受影响。 将.toggle() 用作专门的点击处理程序已被弃用 1.8 并在 1.9 中删除。

解决方法：重写依赖$().toggle()的代码，使用 jQuery Migrate 插件的精简生产版本提供 功能，或从 插件的源代码并在应用程序中使用它。

Answer 3

jQuery 1.9 还不是最终版本。根据升级指南：

“目前，本指南作为标准 jQuery API 文档的附录，这些页面可能不会描述 1.9 版的行为。请耐心等待我们在 api.jquery.com 更新各个页面的文档以反映 1.9 中的变化。”

在这种情况下，我们只是还没有记录它。你们这样的人比我们快！请在此处提交文档票：http://github.com/jquery/api.jquery.com

Answer 4

我使用的代码：

$('#example').click(function()
    {
    isClicked=$(this).data('clicked');
    if (isClicked) {isClicked=false;} else {isClicked=true;}
    $(this).data('clicked',isClicked);

    if(isClicked)
        {
        ...do stuff...
        }
    else
        {
        ...do stuff...
        }
    });

---

优化后的代码（mplungjan 建议）是：

$('#example').click(function()
    {
    $(this).data('clicked',!$(this).data('clicked'));

    if ($(this).data('clicked'))
        {
        ...do stuff...
        }
    else
        {
        ...do stuff...
        }
    });