Bad documentation for virtualized events

未关闭
#100 1 条评论 0 个 reaction 已指派 0 人 在 GitHub 查看

还没有人认领这个 Issue。

评估

难度
3/5
预计耗时
1-2 天
新手友好度
35/100
Issue 类型
文档
描述清晰度
需要澄清
活跃度
停滞
技术栈
html, jquery
领域
documentation

调研方向

从 vclick 事件处理程序文档及其链接的示例开始。检查 onclick 与 click 的措辞、对缺失鼠标事件触发器的解释、vmouseup 示例文本以及重复触发报告;当页面准确说明 vclick 的用途并纠正已确认的错误时,即视为完成。

由索引模型根据 Issue 内容生成。

描述

I am looking at the documentation for the vclick event handler and I am confused.

  • It says it simulates the "onclick" handler for mobile devices. Should it say "click" instead of "onclick"? In any case, why would I want to do that? I am using click handlers and they seem to work fine on the devices I tested them on.
  • It mentions something about "missing mouse event triggers". What does that mean? Are there devices that don't trigger mouse events for taps?
  • The source for the example binds an event to "vclick" that shows a message saying "vmouseup fired.", although when I try the example, it says "vclick fired.". That may simply be a typo.
  • The "vclick fired." text comes up twice every time I click. At least that is what happened when I tried it in Chrome and Firefox for OS X.

I think it is unclear as to what advantages "vclick" may have over "click" or "onclick".

主要语言
HTML
星标
55
派生
57
PR 合并指标
30 天内没有已合并 PR

环境准备

  • 没有 Dockerfile 或 Docker Compose 文件
  • 没有 Pull Request 模板
  • 阅读贡献指南

从这里开始

  1. 先读完整个 Issue,再读项目的贡献指南。
  2. 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
  3. Fork 仓库,在一个分支上完成修改。
  4. 提交 Pull Request,并在描述里引用这个 Issue 编号。

jquery/api.jquerymobile.com 的其他 Issue

查看 jquery/api.jquerymobile.com 的全部 Issue

相似的 Issue

更多 Documentation Issue

把新 issue 发到你的邮箱

精选适合新手参与的 GitHub issue 摘要。