sonata-project / SonataAdminBundle

The missing Symfony Admin Generator
https://docs.sonata-project.org/projects/SonataAdminBundle
MIT License
2.11k stars 1.26k forks source link

Documentation: disable sticky forms #7481

Closed rene-roesch-blg closed 3 years ago

rene-roesch-blg commented 3 years ago

Feature Request

Sonata uses sticky forms by default. Sticky forms are a feature that has the form actions in an edit view render the action buttons at the bottom of the page, but scroll upwards below the form when scrolling up. This feature can easily be disabled via sonata_admin.yml package config. This option is not documented however. (as opposed to e.g. disabling Select2.

I'd be happy the extend the docs/cookbook, but am not quite sure on where to put that information. Maybe a new section regarding these options that affect javascript beaviour would be accurate? There's way more than just select and sticky_forms to yet be documented properly. Any suggestions? :)

Examples. With sticky forms: with_sticky_forms

Without sticky forms: without_sticky_forms

VincentLanglet commented 3 years ago

There is already some documentation about some others options https://docs.sonata-project.org/projects/SonataAdminBundle/en/4.x/cookbook/recipe_select2/ https://docs.sonata-project.org/projects/SonataAdminBundle/en/4.x/cookbook/recipe_icheck/

I feel like adding a recipe for sticky form would be too much since there is not a lot to say.

Maybe it would be better to group them under another title (related to form options ?) And it would be easy to add a sticky form section then.

rene-roesch-blg commented 3 years ago

Oh you're right. Since those are global options though, that affect all elements in the application, I'd agree to have it documented somewhere else. Also, explaining what the sticky_forms option does might help. I don't think it's as self explanatory as e.g. "use_select".

VincentLanglet commented 3 years ago

Do you still plan to make a documentation PR @rene-roesch-blg ? :)

rene-roesch-blg commented 3 years ago

I absolutely do, just wasn't available for the last couple of weeks. I'll link the PR in here as soon as possible.

VincentLanglet commented 3 years ago

I absolutely do, just wasn't available for the last couple of weeks. I'll link the PR in here as soon as possible.

Did you find time to make something ? :)