diff --git a/modules/applications/applications-nav.adoc b/modules/applications/applications-nav.adoc index e310ce6c57..c90e901a3a 100644 --- a/modules/applications/applications-nav.adoc +++ b/modules/applications/applications-nav.adoc @@ -31,6 +31,7 @@ ***** xref:ui-builder/common-apis-to-use.adoc[Common APIs to use] ***** xref:ui-builder/how-to-retrieve-user-avatar.adoc[Retrieve user avatar image] ***** xref:ui-builder/reuse-code-and-components.adoc[Reuse code and components] + ***** xref:ui-builder/create-fully-responsive-apps.adoc[Create fully responsive applications] *** xref:ui-builder/resources.adoc[Resources] *** xref:ui-builder/faq.adoc[FAQ] ** xref:ui-designer/uid-applications-index.adoc[Living applications with Bonita UID] diff --git a/modules/applications/assets/images/ui-builder/guides/bind_confirm_modal.png b/modules/applications/assets/images/ui-builder/guides/bind_confirm_modal.png index 939e8336bd..a5b69f0ce4 100644 Binary files a/modules/applications/assets/images/ui-builder/guides/bind_confirm_modal.png and b/modules/applications/assets/images/ui-builder/guides/bind_confirm_modal.png differ diff --git a/modules/applications/assets/images/ui-builder/guides/create_modal.png b/modules/applications/assets/images/ui-builder/guides/create_modal.png index 7a66966dca..18509b1ede 100644 Binary files a/modules/applications/assets/images/ui-builder/guides/create_modal.png and b/modules/applications/assets/images/ui-builder/guides/create_modal.png differ diff --git a/modules/applications/assets/images/ui-builder/guides/execute_hr_mngt_task.png b/modules/applications/assets/images/ui-builder/guides/execute_hr_mngt_task.png index 45aa077674..dda4094ef6 100644 Binary files a/modules/applications/assets/images/ui-builder/guides/execute_hr_mngt_task.png and b/modules/applications/assets/images/ui-builder/guides/execute_hr_mngt_task.png differ diff --git a/modules/applications/assets/images/ui-builder/guides/export_pages.png b/modules/applications/assets/images/ui-builder/guides/export_pages.png index 5e6bff62c4..aac4bd1c49 100644 Binary files a/modules/applications/assets/images/ui-builder/guides/export_pages.png and b/modules/applications/assets/images/ui-builder/guides/export_pages.png differ diff --git a/modules/applications/assets/images/ui-builder/guides/modal_task.png b/modules/applications/assets/images/ui-builder/guides/modal_task.png index 93f529407e..391731966a 100644 Binary files a/modules/applications/assets/images/ui-builder/guides/modal_task.png and b/modules/applications/assets/images/ui-builder/guides/modal_task.png differ diff --git a/modules/applications/assets/images/ui-builder/guides/responsive-container-ko.png b/modules/applications/assets/images/ui-builder/guides/responsive-container-ko.png new file mode 100644 index 0000000000..0bdd8f9cd3 Binary files /dev/null and b/modules/applications/assets/images/ui-builder/guides/responsive-container-ko.png differ diff --git a/modules/applications/assets/images/ui-builder/guides/responsive-container-ok.png b/modules/applications/assets/images/ui-builder/guides/responsive-container-ok.png new file mode 100644 index 0000000000..a6ad8e2bb0 Binary files /dev/null and b/modules/applications/assets/images/ui-builder/guides/responsive-container-ok.png differ diff --git a/modules/applications/assets/images/ui-builder/guides/submit_task_form.png b/modules/applications/assets/images/ui-builder/guides/submit_task_form.png index 81a5c90445..215a7c5b04 100644 Binary files a/modules/applications/assets/images/ui-builder/guides/submit_task_form.png and b/modules/applications/assets/images/ui-builder/guides/submit_task_form.png differ diff --git a/modules/applications/pages/ui-builder/bonita-ui-builder-best-practices.adoc b/modules/applications/pages/ui-builder/bonita-ui-builder-best-practices.adoc index d62a34d0d7..6348737db1 100644 --- a/modules/applications/pages/ui-builder/bonita-ui-builder-best-practices.adoc +++ b/modules/applications/pages/ui-builder/bonita-ui-builder-best-practices.adoc @@ -38,3 +38,8 @@ xref:ui-builder/how-to-retrieve-user-avatar.adoc[[.card-title]#Retrieve user ava -- xref:ui-builder/reuse-code-and-components.adoc[[.card-title]#Reuse code and components# [.card-body.card-content-overflow]#pass:q[Improve maintenance and consistency between your applications]#] -- + +[.card.card-index] +-- +xref:ui-builder/create-fully-responsive-apps.adoc[[.card-title]#Create fully responsive applications# [.card-body.card-content-overflow]#pass:q[Enhance the layout to ensure the application is fully responsive]#] +-- diff --git a/modules/applications/pages/ui-builder/create-fully-responsive-apps.adoc b/modules/applications/pages/ui-builder/create-fully-responsive-apps.adoc new file mode 100644 index 0000000000..4b791301a1 --- /dev/null +++ b/modules/applications/pages/ui-builder/create-fully-responsive-apps.adoc @@ -0,0 +1,35 @@ += Create Fully Responsive Applications +:description: Enhance the layout to ensure the application is fully responsive. + +{description} + +Although applications built with UI Builder are responsive by default, certain settings should be avoided to ensure full responsiveness. + +== Fixed Height + +Setting a fixed height for a widget may cause display issues on different window sizes. + +For example, if you set the `Height` property to `Fixed` for a Container widget, the content may become truncated when the window is resized. + +== Scroll Content + +For some widgets, for example the Container widget, you can use the `Scroll content` property if you want to maintain a fixed size. + +== Example + +1. Drop a Container widget on the page: +- Set the `Height` property to `Fixed` +- Disable the `Scroll contents` property + +2. Drop a Text widget inside the Container: +- Expand it to the width of the Container +- Add some text to fill the Text widget + +Preview the page and resize the window: you will see that the content is truncated when the window is small: + +image:ui-builder/guides/responsive-container-ko.png[responsive-container-ko, 400, 200] + +Now, set the `Height` property of the Container to `Auto Height` and preview the page again: +you will see that the content is displayed correctly, the Container height adapts to the content: + +image:ui-builder/guides/responsive-container-ok.png[responsive-container-ok, 400, 200]