jquery/test
Michał Gołębiowski-Owczarek 063831b637
Attributes: Make .attr( name, false ) remove for all non-ARIA attrs
The HTML spec defines boolean attributes:
https://html.spec.whatwg.org/#boolean-attributes
that often correlate with boolean properties. If the attribute is missing, it
correlates with the `false` property value, if it's present - the `true`
property value. The only valid values are an empty string or the attribute name.

jQuery tried to be helpful here and treated boolean attributes in a special way
in the `.attr()` API:
1. For the getter, as long as the attribute was present, it was returning the
   attribute name lowercased, ignoring the value.
2. For the setter, it was removing the attribute when `false` was passed;
   otherwise, it was ignoring the passed value and set the attribute -
   interestingly, in jQuery `>=3` not lowercased anymore.

The problem is the spec occasionally converts boolean attributes into ones with
additional attribute values with special behavior - one such example is the new
`"until-found"` value for the `hidden` attribute. Our setter normalization
means passing those values is impossible with jQuery. Also, new boolean
attributes are introduced occasionally and jQuery cannot easily add them to the
list without incurring breaking changes.

This patch removes any special handling of boolean attributes - the getter
returns the value as-is and the setter sets the provided value.

To provide better backwards compatibility with the very frequent `false` value
provided to remove the attribute, this patch makes `false` trigger attribute
removal for ALL non-ARIA attributes. ARIA attributes are exempt from the rule
since many of them recognize `"false"` as a valid value with semantics different
than the attribute missing. To remove an ARIA attribute, use `.removeAttr()` or
pass `null` as the value to `.attr()` which doesn't have this exception.

Fixes gh-5388
Closes gh-5452

Co-authored-by: Richard Gibson <richard.gibson@gmail.com>
2024-03-20 00:46:30 +01:00
..
bundler_smoke_tests Core: Fix the exports setup to make bundlers work with ESM & CommonJS 2024-03-12 00:39:34 +01:00
data Tests: reuse browser workers in BrowserStack tests (#5428) 2024-03-05 14:44:01 -05:00
integration Event: Fix delegated radio events when arrow keys are used 2015-10-18 13:06:37 -04:00
node_smoke_tests Core: Fix the exports setup to make bundlers work with ESM & CommonJS 2024-03-12 00:39:34 +01:00
promises_aplus_adapters Core: Move the factory to separate exports 2023-09-19 18:58:24 +02:00
runner Tests: show any and all actual/expected values 2024-03-15 17:44:05 -04:00
unit Attributes: Make .attr( name, false ) remove for all non-ARIA attrs 2024-03-20 00:46:30 +01:00
delegatetest.html Core: Simplify code post browser support reduction 2023-09-20 00:54:40 +02:00
hovertest.html Ref #13316: Sync all documents on full vs. minified source. Close gh-1147. 2013-02-07 15:16:28 -05:00
index.html Tests: reuse browser workers in BrowserStack tests (#5428) 2024-03-05 14:44:01 -05:00
jquery.js Tests: migrate testing infrastructure to minimal dependencies 2024-02-26 09:42:10 -05:00
middleware-mockserver.cjs Build: drop support for Node 10 2024-03-09 10:36:47 -05:00
networkerror.html Docs: Replace #NUMBER Trac issue references with trac-NUMBER 2022-01-04 16:27:18 +01:00
xhtml.php Added a way to run the test suite as an XHTML page. 2009-01-19 18:14:51 +00:00