-
Notifications
You must be signed in to change notification settings - Fork 53
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
refactor!: Rename name
to label
and use value
for label content
#475
Conversation
I'm on board with these changes, but I expect the transition to the value property to be painful. Maybe you should split this PR so it has its dedicated entry in the changelog, until we properly document everything? Also, you're effectively creating a new kind of nodes which are labeled by their value, and I wonder if you should explicitly name them by adding a new method in the consumer crate. I currently have no idea how we'd name this class of nodes, but I don't really like having this check on roles in multiple places. |
I don't think I understand the benefit of splitting the PR. |
It's a subtle change and I wouldn't be surprised if people don't set the value property on labels while migrating, so I'm just trying to see how to make this change more obvious. I think having a dedicated entry in the changelog would make it more noticeable. |
I don't like the extra churn that splitting the PR would cause in the code itself, just for one extra line in the change log. |
Thanks for adding documentation. It doesn't mention that it also applies to |
Maybe this is to allow a rich text alternative? |
You're right about |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Awesome, thanks! Please rebase and merge after that.
b05c5bb
to
c73b612
Compare
I think the new property name and the new use of
value
on nodes withRole::Label
makes sense because:label
property, or thelabelled_by
relation. The word choice is more consistent.TextRun
nodes, we can now automatically get the label's value from its descendant text runs, rather than having to set the value directly; this follows automatically from the existing support for constructing the value from text inaccesskit_consumer::Node::value
.