帮助您理解 jQuery

发布日期 作者

一些 最近 文章 讨论了对 JavaScript 库提供“真正好的”教程的必要性。

一如既往,我们正在努力使 jQuery 文档更完善,更有用,因此我想提出以下问题:有哪些教程可以帮助您更好地使用或学习 jQuery?请确保它很简单(例如“构建下拉菜单”),而不是非常复杂(例如“构建完整的购物车系统”)。请随时在评论中发布您的建议,这将帮助我们更好地了解人们想要什么,以及哪些需要更好地解释。

我们最近开始对 jQuery 文档维基 进行重组。目前它比较混乱,到处都是。但是,从 新维基的结构 可以看出,我们正在努力对 jQuery 本身进行更彻底的展示。在这些主题中的每一个主题中,我们希望包含一些有用的“常见情况”教程,这些教程将帮助您更好地理解 jQuery API 中的函数。

因此,请:(考虑到您对 新维基 结构的了解)什么可以帮助您更好地学习和使用 jQuery?

关于“帮助您理解 jQuery”的 26 个想法

  1. 嘿,John,

    我个人认为,维基不是最好的选择。您的在线 API 参考是一个更好的主意,值得关注。

    几天前,digg 上有一个网站 (http://home.cogeco.ca/~ve3ll/jstutor0.htm) 被称为“我见过的最好的 JavaScript 示例页面!”。我个人喜欢这种格式,因为它使 JavaScript 变得易于访问且有趣。

    IMO,因为您的 API 页面简洁明了,所以它实际上让探索 JQuery 方法变得很有趣。如果有人想要更详细的信息,让他们深入挖掘。我认为您应该采用同样的想法,但只需按功能/目标进行组织。

    另外,我认为您应该采用一个系统,让人们可以提交自己的代码示例,类似于 PHP 文档。它不会默认显示,但当人们点击“显示用户提交的代码”链接时,您可以加载它。

    顺便说一下,我最近一直在用 JQuery 玩得很开心。我最近写了一些扩展,我期待着发布它们。

  2. @Steve:为了澄清一下,API 文档不会消失。它将继续得到构建、澄清和解释。维基中包含的文档的目的是以书籍的形式看待 jQuery。逐步引导读者了解 jQuery,以便他们更好地理解其设计的各个方面。

    除此之外,我们还致力于“按功能/目标进行组织”——这正是这些教程的主题。最终,应该有三个东西:一个很棒的 jQuery 食谱(包含大量针对常见情况的教程和演练)、一个关于 jQuery 及其所有细节的完整指南(文档维基)以及 API 方法参考。

    理想情况下,食谱和 API 将与 jQuery 指南的其余部分无缝集成,以创建一个单一资源,既可以作为参考,也可以作为新用户的优秀学习指南。

  3. 您需要为插件提供更好的文档。如果我需要阅读大多数我想使用的插件的源代码,我也可以自己编写它们。
    有更多插件在做同样的事情。我知道这很难,但您应该推荐一个并写一篇关于如何使用它的文章。

  4. 嗨,John,
    您关于手风琴菜单的视频对我的测试网站很有帮助,我用它来进行 Jquery 实验。因此,额外的视频教程会很好。我的脑海中浮现出几个想法
    1 我从观看 Jquery 的实际操作中学习得最好,所以也许您可以以一个使用 jquery 的示例网站为例进行讲解,并解释它是如何使用 jquery 的。此外,也许可以展示一些由 Jquery 驱动的网站,这将是维基首页的一个不错的功能。这里有一点炫耀是好的。谁不喜欢提到 http://www.mondediplomatique.fr 现在正在使用 Jquery?这有多重目的——吸引潜在的追随者,并展示 jquery 在现实世界中的应用实例。

    2 详细介绍 如您在测试网站中看到的,我使用 history 插件将远程文件注入 index 文件中。您可以展示如何在这些远程文件上应用效果吗?

    3 我想了解如何将 Jquery 与服务器端脚本结合使用,特别是 RoR。您能设置一个教程来构建一个结合了两者的动态网站吗?我理解这对于一个教程来说范围太广,所以它可能会有几集。

    Geert

  5. 嘿,John 和各位,

    我想表达一下我的想法。首先,jQuery 是我的首选库,我对它的发展方向以及背后的社区努力感到非常兴奋。我对 jQuery 的整体呈现方式有一些想法,我将在下面以(相对)随机的顺序分享。

    1. 所有部分(SVN、trac、博客、网站、api 等)似乎都在那里,但我真的觉得它们散布在各个地方。仅仅通过查看 jQuery.com 很难坐下来准确地了解 jQuery 是什么以及它能做什么。我喜欢他们在 http://www.rubyonrails.com–a 上所做的工作——一个漂亮、清晰的界面,提供了大量的信息。

    2. 我知道这篇文章不是关于 jQuery.com 的,但我认为这是让人们接受它的关键。我真的很难使用它,尤其是因为底部有全局导航。我敢打赌,很多人都没有注意到这些链接。我喜欢网站的最后一个版本,当时选项在顶部——而且看起来简单多了。

    3. 关于:文档,我喜欢新的维基。它似乎真的可以成为一个很好的信息来源。我也很喜欢拥有食谱的想法。我想在这里分享这个链接,django 书籍:http://www.djangobook.com/en/beta/(这真是一个很棒的文档)。由于有这么多人愿意为文档做出贡献,我喜欢维基格式而不是 django 书籍——但我认为那是一个非常酷的文档网站。

    4. 正如我所说,所有部分都在那里——但它们似乎有点分散。我个人更喜欢(再说一次,这不是对每个人付出的惊人努力的否定)简化 jQuery.com,添加一些品牌和设计,并使其成为主要“部分”的保护伞。

    5. 也就是说,我意识到 jQuery.com 已经是保护伞了 :) 但我想它感觉不像,因为发生的事情太多了。

    John,我喜欢这个项目。我真的很想看到它取得成功。感谢您提供这个机会让我畅所欲言。

    Steve O

  6. Rich Manalang on 说:

    John,我认为为人们提供一个地方来分享“食谱”类型的代码将很有价值。像您的斑马条纹或 Jörn 的简单示例(为所有 ajax 请求添加全局加载指示器)这样的优质可靠的代码示例非常有用,并且证明了 jQuery 的强大功能。每当我将代码发布到邮件列表时,总会有人回复一个更好的方法(包括您)。所以,我认为为简单日常事务(而不是大型复杂问题)提供一个有用的食谱示例库将很有价值。这也可能需要进行审核,或者至少应该有一种方法让大家改进提交的代码。这是我的两分钱。

  7. @Steve O: 网站肯定在不断完善中。我很快会发布一篇关于这方面的文章(但有一个5人团队在做这件事!别担心!)

    @Rich: 这正是我想要的!你有什么想法可以做一些好的简单教程/屏幕录像?这样我们每周可以制作几期,让大家了解最新的进展。(我的意思是,我现在已经计划了一些,但我只是想知道大家还有什么其他兴趣。)

  8. FWIW,我想看到一些关于一些插件的屏幕录像教程,尤其是界面相关的插件。另外,关于核心 Ajax 的一些教程也会很有趣;我知道这需要一些工作,因为需要有后端(PHP 或其他),但是 Ajax 的 API 已经发生了一些变化,所以看到一些演练会很好。

    我之前实际上已经让 Ajax 运行起来,我只是想知道我是否在以“正确”或最有效的方式使用它。

  9. 嘿,John,感谢你做这件事!

    就 jQuery 而言,最让我困扰的是我找不到任何_离线_文档。如果我忽略了它,那应该怪我,但 JavaScript 的一项非常酷的事情是它不需要 http(除非你做一些 Ajax 操作),我可以在离线状态下进行工作。

    所以,如果能提供可打印和可下载的文档格式,那就太好了。我知道这会带来文档过时的問題,但我相信它会帮助很多人。

  10. 我想看到更多关于 jQuery 可链性的强大功能的教程/示例。我认为我的 jQuery 代码仍然可以改进,以实现最佳优化。

    此外,一个食谱也是理想的,用户可以在其中展示他们代码的小片段,并与其他人分享。

  11. Shawn Tumey 说:

    大家好,

    我认为所有示例和教程都需要交叉引用优秀的 API 文档。目前,这些内容(示例与 API 文档)感觉像是独立的孤岛。

    示例和 API 应该扩展“查找内容,执行操作”的理念。例如,对于每个 API 条目,应该表明它是关于查找内容,还是执行操作。

    此外,我认为关于匿名函数和使用函数句柄的扩展部分将有助于整个社区。

    继续努力吧!

  12. 我同意 Giel 的观点(#10)。更多关于可链性的内容将非常适合我们这些不确定是否以正确/最佳方式做事的人。

    我也同意 Steve O 的观点(#5)。jQuery.com 的简洁性是其主流成功的关键。jQuery 本身比其他库更简单,功能同样强大,我认为该网站需要反映这种简洁性、强大性和深度。

    最后,我赞同 Patrick 的评论(#8)。Ajax 现在很流行,但我们需要清晰、简洁的教程来展示如何在 jQuery 中充分利用它,同时也展示如何负责任地使用它。展示 Ajax 的服务器端部分会非常酷。在制作教程时,请从头到尾进行操作,并提供可以分析的实时示例。我认为制作教程的简短片段会让它更令人困惑。

    我很高兴你会把所有松散的环节都整理起来,并为 jQuery 创建一个很好的、紧密的资源。我迫不及待地想看到它完成。

  13. Pingback: 15 Days Of jQuery : jQuery Tutorial Ideas Wanted

  14. 作为一名网站创建新手,我需要快速学习,所以我依赖于所有我能找到的文档/教程/指南。我对学习 jQuery 的相对容易程度感到非常印象深刻/欣慰,这得益于优秀的 API 文档和一些很棒的教程(15daysofjquery.com 非常棒)。

    我想看到
    教程的交叉引用/更多 API 文档中的示例(正如 Shawn 所提到的)。

    更多关于 AJAX 函数的教程,特别是与服务器端相关的教程(正如上面一些评论中提到的)。

    视频教程非常有用。

    更好的插件文档——通常在特定插件的网站上很好,但如果能在维基上提供,那就太好了。

    期待更好的文档,我赞同 Josh 的评论,希望将松散的环节整合在一起,创建一个紧密的资源。

  15. 我越想,就越意识到,我学习的最佳方式是查看真实世界、有良好注释的、有效的常见事物示例。食谱类型的东西。比如“如何通过 Ajax 保存表单,并在保存后隐藏表单,显示一个加载图标,并在完成后显示一个“确定”消息?”或者……如何创建一个下拉菜单?或者处理 XYZ 的最佳方式是什么?这就是我喜歡维基理念的原因,因为食谱非常适合它,任何人都可以编辑它。

  16. – 一个星级评分教程,可以通过 ajax 更新后端的星级投票数量。我到处都见过它们,而且也使用过,但我还没有见过 jQuery 版本的。

    – 当用户在浏览器上按下后退按钮时,保留通过 DOM 操作(jQuery)更改的元素的先前状态——例如,如果用户在页面 A 上打开一个 div,然后移动到页面 B,然后点击后退按钮返回页面 A——div 就会再次关闭(呃,我认为这是我前几天注意到的一种体验……这有点令人讨厌)。

    – 更多关于使用 xpath 访问 DOM 元素的教程。

    – 原地编辑示例。

    – 在文本框中输入单词计数示例。

    – 一个事件示例,该事件触发一个 AJAX 请求,响应会弹出一个模态对话框供用户响应,并根据响应触发另一个事件(听起来比实际操作更难)。

    – 可能还有更多插件示例……就像 .net 有“控件”一样,也许我们可以看到更多 jQuery 控件的想法,我认为这就是插件。

    — 只是几个想法。

  17. @kevin: 这太完美了——正是我需要的!这将给我们提供大量素材,让我们开始着手编写新的博客文章/屏幕录像/教程。感谢!

  18. John,

    没问题。感谢你创建了 jQuery!

    实际上,还有一个可能的建议;我不知道我怎么会忘记这个。

    – 以 ajax 方式上传文件(多文件上传?)。

    这将非常棒。还有屏幕录像?太棒了!

  19. 大多数教程都受到以下事实的限制:它们通常只说明一种方法。我希望看到一个选择器教程,它演示了在给定 HTML 片段中选择相同(或类似)元素模式的众多方法。也许可以提供一些关于在给定情况下哪种方法最合适的提示。

  20. 正如上面其他人所说,我想看到更多关于插件的教程。我指的是从基础开始的逐步教程,而不是“这里是一个演示了此插件各个方面的巨大测试页面,你需要自己弄清楚你需要哪些小片段”。特别是,我一直难以弄清楚表单插件。对于我们这些通过遵循基本的教程然后逐个构建来学习的人来说,这样的东西会很棒。

  21. 另一个想法,来自你的邮件列表,是关于将 DOM 元素(例如 TR 或 DIV,无论是什么)添加到网格状结构中的教程。

    例如,如果你有一个基本的待办事项列表应用程序。最初,你可以有一行,并在下面有一个“添加另一个”。点击“添加另一个”将插入一个带有输入字段的结构,命名约定将使迭代发布后的结果变得简单。

    这个东西可以用一百种方式实现,但我认为你们会知道最好的方法:P

  22. Jason DeFontes 说:

    我同意 Ollie 的要求,希望有一个全面的选择器教程。当我试图理解它时,似乎所有 API 示例都使用 $(“p”) 或类似的,这并没有真正展示你需要进行实际工作所需的具体性。

  23. 我看到很多示例和教程展示了简短的代码片段,但对于试图弄清楚“所有东西放在哪里”的初学者来说,2 或 3 行代码不会帮助他们。也许每个教程的“完整代码”版本是有必要的。

  24. 感谢你的提问。并对如此优秀的工具表示敬意。

    有一些东西可以帮助新手深入了解这个库,并帮助他们编写更好的脚本
    – 当你设计这个库时,你考虑到每个 API 方法在开发中的用途。在这种情况下,最好有你(或团队中的某人)关于如何以最佳方式使用特定功能的注释。例如,我们可以用多种方法在 JQ 中进行 AJAX 请求(.get - .post - .load - .ajax) - 但似乎每种方法都是为特定目的而设计的。对于像我这样的新手来说,最好在某处写一个案例列表和简短的示例,例如:要检索中型大小的哈希或表格数据(例如某事物的日程安排或带有地址的姓名列表),最好使用函数 (****); 对于繁重的请求,请使用 ****; 对于需要后处理的极其关键的请求,请使用 *****; 对于连续检索 JSON,请使用 ***。
    – 最好能有一些关于如何使用 JQuery 编写 JavaScript 的建议(或链接到外部网站)。这不是关于库本身的文档,而是关于编写代码的方式。
    – 另外,最好能有一个方便的阅读讨论列表的方法:RSS 中的所有链接都打开 jquery.com/discuss…. 我无法跟踪讨论。但在 http://www.nabble.com/JQuery-f15494.html 论坛中,我也可以查看整个讨论线程 - 这更方便!

    感谢并祝这个好项目一切顺利!