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

"click button" vs. "select button" in Blazor docs #449

Open
hakenr opened this issue Mar 20, 2024 · 2 comments
Open

"click button" vs. "select button" in Blazor docs #449

hakenr opened this issue Mar 20, 2024 · 2 comments

Comments

@hakenr
Copy link

hakenr commented Mar 20, 2024

I understand the reasoning behind avoiding the term "click," but it feels odd to refer to it as "selecting a button." It seems like an attempt to replace a widely accepted simplification. The event name is click, and Blazor operates on top of HTML elements, where "click" carries a broader significance. This isn't about drafting specifications for new browser developers, where emphasizing a broader meaning might be relevant.

To my knowledge, the Blazor documentation might be the first instance where I've seen this approach. For comparison, consider these references:

https://www.google.com/search?q=to+select+a+button
https://learn.microsoft.com/en-us/dotnet/api/system.web.ui.webcontrols.button.click
https://learn.microsoft.com/en-us/dotnet/api/system.windows.forms.control.click
https://www.w3schools.com/jsref/event_onclick.asp
https://developer.apple.com/documentation/swiftui/button - uses "to activate button"
https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event (does not use click nor select)

This perspective might prompt a reconsideration of the terminology, aligning more closely with established norms.


Document Details

Do not edit this section. It is required for learn.microsoft.com ➟ GitHub issue linking.

@guardrex
Copy link

Note for the record that all ASP.NET Core docs (and .NET docs IIRC) are following the convention, not just the Blazor node of the ASP.NET Core docs. This provision has been (mostly) faithfully followed for many years by all of the docs teams AFAIK.

@hakenr
Copy link
Author

hakenr commented Mar 20, 2024

I agree. I wanted to emphasize that with Blazor, we're not operating in isolation; instead, Blazor is built upon HTML, incorporating DOM events and the associated terminology. For instance, while desktop or mobile technologies like MAUI might be comfortable with other terms such as "press" or "touch", web developers are more accustomed to "click". Context plays a crucial role here.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants