Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

HTMLElement.click() 页面不正确 #23602

Closed
minecraftfen opened this issue Sep 16, 2024 · 8 comments · Fixed by #23634
Closed

HTMLElement.click() 页面不正确 #23602

minecraftfen opened this issue Sep 16, 2024 · 8 comments · Fixed by #23634
Labels
good first issue A good issue for newcomers to get started with. l10n-zh Issues related to Chinese content.

Comments

@minecraftfen
Copy link
Contributor

minecraftfen commented Sep 16, 2024

MDN URL

https://developer.mozilla.org/zh-CN/docs/Web/API/HTMLElement/click

与此议题相关的小节或标题?

HTMLElement.click()

哪些信息是错误、无用或不完善的?

HTMLElement构造器上不存在click方法,英文内容中使用了HTMLElement: click() Method作为标题,不太明显,但确实表示了这是一个实例方法,但中文内容里使用的这种标题容易让人误以为这是一个静态方法,即直接作为HTMLElement构造器的属性存在的方法。

你期望看到什么?

建议使用和英文内容类似的方式,或者直接使用HTMLElement.prototype.click()作为标题。

你有什么支持的链接、参考或引用?

No response

你还想补充什么内容?

image
HTMLElement.click的值未定义,而HTMLElement.prototype.click的值是一个内建方法。

MDN metadata

Page report details
@minecraftfen minecraftfen added l10n-zh Issues related to Chinese content. needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. labels Sep 16, 2024
@yin1999 yin1999 removed the needs triage Triage needed by staff and/or partners. Automatically applied when an issue is opened. label Sep 17, 2024
@yin1999
Copy link
Member

yin1999 commented Sep 17, 2024

按照 MDN 现在的规则,如果一个方法为静态方法,那么我们将在标题中使用类似这样的写法:“Notification:requestPermission() 静态方法”,如果为实例方法,我们会使用类似这样的写法:“HTMLElement:click() 方法”。即,如果没有强调“静态”两字,即为实例方法。目前的标题确实可以更新(使用最新的英文文档的格式),但本身的表达也是没有问题的。

@yin1999 yin1999 added the good first issue A good issue for newcomers to get started with. label Sep 17, 2024
@familyboat
Copy link
Contributor

按照 MDN 现在的规则,如果一个方法为静态方法,那么我们将在标题中使用类似这样的写法:“Notification:requestPermission() 静态方法”,如果为实例方法,我们会使用类似这样的写法:“HTMLElement:click() 方法”。即,如果没有强调“静态”两字,即为实例方法。目前的标题确实可以更新(使用最新的英文文档的格式),但本身的表达也是没有问题的。

你说的没问题的表达用的是冒号,但现在的文档上用的是小数点。按照你的说法是需要更新的。

@yin1999
Copy link
Member

yin1999 commented Sep 17, 2024

按照 MDN 现在的规则,如果一个方法为静态方法,那么我们将在标题中使用类似这样的写法:“Notification:requestPermission() 静态方法”,如果为实例方法,我们会使用类似这样的写法:“HTMLElement:click() 方法”。即,如果没有强调“静态”两字,即为实例方法。目前的标题确实可以更新(使用最新的英文文档的格式),但本身的表达也是没有问题的。

你说的没问题的表达用的是冒号,但现在的文档上用的是小数点。按照你的说法是需要更新的。

我知道,我在我提的 PR 中已经更新了这一点,我表达的是,这本身并不是错误,而是容易引起混淆。可以参考我们之前的讨论:https://github.com/orgs/mdn/discussions/248

@familyboat
Copy link
Contributor

我对照了HTMLElement的中英版的相关内容:https://developer.mozilla.org/en-US/docs/Web/API/HTMLElementhttps://developer.mozilla.org/zh-CN/docs/Web/API/HTMLElement ,在一些术语上已经有了截然不同的表达。看英文版我不会觉得HTMLElement.click()表达的是实例方法有什么问题,因为在 https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement 已经用instance method表达了这一层含义,但中文版的没有相关的表达,这会更容易产生误解。我建议中文版的内容应该跟上英文版的内容。

@familyboat
Copy link
Contributor

补充的一点:HTMLElement.click表达实例方法是可以接受的,只需要明确的表明是实例方法而不是静态方法。因为,你无法用htmlElement.click这种形式去表达一个实例方法,除非人为的将htmlElementHTMLElement关联起来或者以其他方式关联起来。

@familyboat
Copy link
Contributor

按照 MDN 现在的规则,如果一个方法为静态方法,那么我们将在标题中使用类似这样的写法:“Notification:requestPermission() 静态方法”,如果为实例方法,我们会使用类似这样的写法:“HTMLElement:click() 方法”。即,如果没有强调“静态”两字,即为实例方法。目前的标题确实可以更新(使用最新的英文文档的格式),但本身的表达也是没有问题的。

所以,我也赞同你这里的说法。

@minecraftfen
Copy link
Contributor Author

按照 MDN 现在的规则,如果一个方法为静态方法,那么我们将在标题中使用类似这样的写法:“Notification:requestPermission() 静态方法”,如果为实例方法,我们会使用类似这样的写法:“HTMLElement:click() 方法”。即,如果没有强调“静态”两字,即为实例方法。目前的标题确实可以更新(使用最新的英文文档的格式),但本身的表达也是没有问题的。

目前的中文页面使用的是HTMLElement.click()作为标题,按照你说的方法的话,应该把HTMLElement:click() 方法对吧?

@yin1999
Copy link
Member

yin1999 commented Sep 18, 2024

目前的中文页面使用的是HTMLElement.click()作为标题,按照你说的方法的话,应该把HTMLElement:click() 方法对吧?

是的,我已经提了修复的 PR,这里的有些讨论偏离了主题(请忽略)。后面我们会规划更新所有相关的标题。

@github-project-automation github-project-automation bot moved this from To do - Issues to Archive/Closed in MDN translated-content l10n-zh Sep 18, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
good first issue A good issue for newcomers to get started with. l10n-zh Issues related to Chinese content.
Projects
Development

Successfully merging a pull request may close this issue.

3 participants