There are several components which allow you to pass the text for the aria-label on the component's wrapper element. The names of these parameters are inconsistent despite them doing the same thing.
Pagination also includes a visuallyHiddenText param for pagination items. On most components, visuallyHiddenText params are appended to the visible text (for example in summary card actions); pagination is the only example I can find where visuallyHiddenText is passed directly to aria-label, completely overriding any visual label
The documentation for the params is also structured differently. For example the docs for pagination and breadcrumbs don't mention that the value will be used as the aria-label, while they do for cookie banner and service navigation.
Are any of these differences intentional? I think ariaLabel is clearest about what the params actually do, with [thing]AriaLabel for labels of child elements (eg password uses showPasswordAriaLabelText, though again the Text makes that inconsistent)
There are several components which allow you to pass the text for the
aria-labelon the component's wrapper element. The names of these parameters are inconsistent despite them doing the same thing.Cookie banner and service navigation use
ariaLabel.Pagination uses
landmarkLabeland breadcrumbs useslabelText.Pagination also includes a visuallyHiddenText param for pagination items. On most components,
visuallyHiddenTextparams are appended to the visible text (for example in summary card actions); pagination is the only example I can find wherevisuallyHiddenTextis passed directly toaria-label, completely overriding any visual labelThe documentation for the params is also structured differently. For example the docs for pagination and breadcrumbs don't mention that the value will be used as the
aria-label, while they do for cookie banner and service navigation.Are any of these differences intentional? I think
ariaLabelis clearest about what the params actually do, with[thing]AriaLabelfor labels of child elements (eg password usesshowPasswordAriaLabelText, though again theTextmakes that inconsistent)