ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

This content has been translated automatically.  Click here  to view the French version.
Help / Editors / Window editor and page editor / Window editor
  • Overview
  • Characteristics of a bottom sliding window
  • Type of window
  • The different display modes
  • How to implement bottom sliding windows (bottom sheets)?
  • Creating internal windows
  • Configuring the bottom sliding window associated with a window
  • Programming bottom sliding windows
  • Displaying the bottom sliding window
  • WLanguage properties for manipulating bottom sliding windows
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Overview
Bottom sliding windows (commonly known as "bottom sheets") are increasingly used in mobile applications.
This type of window has the following characteristics:
  • It appears from the bottom of the screen.
  • It can be modal or modeless.
  • The sliding window has 4 display modes: hidden, reduced, intermediate and extended.. Depending on the mode used, the sliding window partially or completely covers the host window.
This type of window is commonly used to open a menu, or to display additional data related to the host window.
Characteristics of a bottom sliding window

Type of window

There are two types of window:
  • Modal bottom sliding window:
    Modal bottom sliding windows offer users a range of options, but prevent them from interacting with the rest of the screen. They provide an alternative to menus and dialog boxes by offering additional space for content and actions.
    The host window is grayed out.
    The bottom sliding window disappears when the users taps anywhere else.
  • Persistent bottom sliding window:
    Persistent bottom sliding windows contain interactive elements, but also allow users to view and interact with the host window.

    They are commonly used:
    • to offer a feature or secondary content,
    • to provide additional information about the content displayed in the host window.
The different display modes
Several display modes are available:
  • Hidden: The bottom sliding window is invisible on screen.
  • Reduced display: Only the top part of the content is visible at the bottom of the host window screen.
  • Intermediate display: Most content visible on screen. Generally, this mode takes up half of the host window.
  • Extended display: the bottom sliding window occupies all or most of the screen, masking the contents of the host window..
Users can switch from one display mode to another by dragging the bottom sliding window up or down.
Collapsed
Half-expanded
Expanded
How to implement bottom sliding windows (bottom sheets)?
Below are the steps to implement bottom sliding windows:
  1. Creating internal windows. These internal windows will be the sliding windows.
  2. Configuring the sliding windows in the description of the main window.
  3. Defining the display mode of sliding windows:
    • or by gesture (default: drag up to display bottom sliding window).
    • programmatically.

Creating internal windows

The sliding windows are internal windows.
This internal window has the following characteristics:
  • When used in the bottom sliding window or in the main window, Close will close both windows.
  • The controls of the bottom sliding window can be accessed via the main window, using the MyBottomSlidingWindow keyword:
    // Change la couleur d'un libellé dans la fenêtre coulissante basse
    MyBottomSlidingWindow.LIB_Libellé.Couleur = LightRed
  • Aspect of sliding window:
    To apply the color and border defined by the internal window, uncheck "System appearance (corners, shadow, etc.)".
  • To display more or less detailed information in the various display modes of the bottom sliding window, it is recommended to define several layouts in the internal window. Each layout should correspond to a display mode.

Configuring the bottom sliding window associated with a window

To define the sliding windows associated with a window:
  1. Go to the "Details" tab of the main window description.
  2. Select the internal window to be used as a bottom sliding window:
    • In "Bottom sliding window (Bottom sheet)", specify:
      • the internal window to be displayed.
        By scrolling down the list, the different internal windows of the application are proposed.
      • the appearance of the internal window.
        If "System appearance (corners, shadow, etc.)" is checked, the sliding window will match the style defined by the system. If this option is unchecked, you will be able to integrate a custom border directly into the internal window.
      • whether the sliding window is modal or modeless. If the sliding window is modeless, you can allow or prevent users from closing the window. In this case, users will be able to hide the entire window.
      • the different heights of the bottom sliding window:
        • Extended height: Maximum height of bottom sliding window.
        • Intermediate height: Height of intermediate display.
        • Reduced height: Minimum height displayed.
      These different heights can be specified as a percentage of the screen height, or in pixels. You can also choose a preset value.
      If the display mode is not to be available, the height can correspond to 0 or to the predefined "Mode off" option.. The anchors defined in the internal window will be applied.
  3. Validate.
Programming bottom sliding windows

Displaying the bottom sliding window

To be used, bottom sliding windows must first be visible.
You can set the visibility of bottom sliding windows:
  • using the options defined in the description of the host window.
  • programmatically, with the WinSlidingVisible function.
WinSlidingVisible can also be used to specify the display mode of the bottom sliding window.

WLanguage properties for manipulating bottom sliding windows

The MyBottomSlidingWindow keyword is used to manipulate the bottom sliding window associated with the current window.
The following properties are used to manipulate bottom sliding windows:
HeightCollapsedThe HeightCollapsed property gets and sets the "collapsed" height of the bottom sliding window associated with the current window.
HeightExpandedThe HeightExpanded property gets and sets the "expanded" height of the bottom sliding window associated with the current window.
HeightHalfExpandedThe HeightHalfExpanded property gets and sets the "half-expanded" height of the bottom sliding window associated with the current window.
HideableThe Hideable property determines if the user can close a bottom sliding window with a touch gesture.
InternalWindowThe InternalWindow property gets and sets the internal window contained in the bottom sliding window associated with the current window.
ModalThe Modal property determines whether the bottom sliding window associated with the current current window is modal or modeless.
New in SaaS
OnHide
The OnHide property allows you to define a procedure to be called when the bottom sliding window associated with the current window is hidden.
This new property is available from WINDEV Suite SaaS 2025 Update 2.
The OpeningParameters property is used to get and set the parameters passed to the internal window corresponding to the bottom sliding window.
This new property is available from WINDEV Suite SaaS 2025 Update 2.
RoundedCornerThe RoundedCorner property allows you to determine whether the bottom sliding window associated with the current window has rounded corners.
Minimum version required
  • Version 2024
Comments
Click [Add] to post a comment

Last update: 06/13/2025

Send a report | Local help