Add master checkbox to Grid

[mhuser]

fix #1877

Add a master checkbox into grid header that enables to toggle selection of whole visible records.

[mhuser]

I have a first working master checkbox but the code is ugly and it does not account for the indeterminate state if child checkboxes are changed.
I found this fomentic example
Would it be cleaner to use a separated javascript file?

[mvorisek]

needs a Behat test

master checkbox must reflect the child states - unchecked/"partially checked"/"all checked"

if Fomantic-UI/jQuery cannot handle this in a few lines, the JS should be put into js/, but until you have fully working solution, feel free to keep the code uncompiled

[mhuser]

Ok, it works as of now with the indeterminate state if the child checkboxes are not all in the same state.

I had some issues to have the javascript statements to appear at the proper position. I first wrote them in Grid->addSelection() and they were called kind of before the checkbox() creation for fomantic-ui.

Still I feel the manner I use the javascript is not optimal because it does not look like other atk4/ui sources.

[mhuser]

I did not find any figures of the checkbox column inside the Column/Checkbox or the Grid documentation.

There seem to be no documentation updates to do because the core functionalities of Grid and Column/Checkbox are not affected.

[mhuser]

I have now only LF line endings, but it seems that Unit / Behat (latest, Chrome Slow) keeps some CRLF in comments, which lead diff to fail 🤔

[mvorisek]

I have now only LF line endings, but it seems that Unit / Behat (latest, Chrome Slow) keeps some CRLF in comments, which lead diff to fail 🤔

disable auto crlf in your git config

and js/package.json and js/package-lock.json should have no changes, delete the lock file and restore the original deps, then run npm install

[mhuser]

disable auto crlf in your git config

and js/package.json and js/package-lock.json should have no changes, delete the lock file and restore the original deps, then run npm install

Thanks, I will try it !
Can you please retrigger the failing Behat (8.0, Chrome) test?
Seems it had some execution issue and not a PR-related error.

[mhuser]

DOM node changes can be detected using MutationObserver, make sure you do not watch more events than needed to keep it efficient

I was not able to improve my js skills enough to address this yet. Maybe we could merge this PR as is (when the quality will be satisfactory) and open a new issue for that cases where a row is removed/hidden from DOM or the grid is dynamically scrolled?

A preliminary test on my production server already granted me positive feedback from the users that appreciate the possibility to check all the displayed rows in a single click 😄 When the array has multiple pages, only the visible page is selected.

[mhuser]

In combination with the modal bulk action #1920, this will enable to mass process of selected elements of a grid conveniently.
This needs to be merged first in such a way the other PR could implement Disable/Enable of the bulk action depending on the master checkbox state.

[mvorisek]

TODO #1920 (comment)

[mvorisek]

#1920 adds support for non-UA (atk4/data User Action) bulk support

before we finish this PR, another PR should be made to add bulk support for "regular UA for multiple records" - https://github.com/atk4/data/blob/4.0.0/src/Model/UserAction.php#L32