Official Content

Determines how the Refresh action is performed in web pages when a user-defined event is executed within the page. It also determines how navigation takes place between different web pages.

Values

Previous versions compatible The mechanism is disabled.
Smooth The mechanism is enabled. This is the default value for new KBs.

Scope

Objects: Transaction, Web Panel
Level: Version

Description

This is a version-level and object-level property.

When the Web User experience property is set to "Smooth", the Refresh event is not executed implicitly on every user event exit and the Start event is executed only once. In addition, each web component is independent from the main page where it is contained so the Refresh of a Web Component object does not affect the rest of the page. 

The event execution is determined by the rules explained in Event Execution Scheme. Performance of web applications is improved by reducing the round trips to the server.

The Smooth value of the property also allows enabling Single Page Applications, where navigating to a web page that is contained in the same Web Master Panel object as the origin web page does not force a refresh of the whole page in the browser, but only updates the page loaded in the content place holder.

Another benefit of this property is the way the load command is executed within a user event, as explained in Load Command and Load Method in User Events. In this case, the load command does not force a refresh of the grid but only adds a new line.

The above options allow you to develop applications with a much better user experience. See HowTo:Develop a messaging web page as an example.

Important: The value 'Previous Version Compatible' is deprecated since GeneXus 18. If you use it, you will get the following warning in build time: "The 'Web User Experience' property is configured to be 'PreviousVersionsCompatible'. This execution mode is deprecated and in a future version its support will be removed. The application should be converted to 'Smooth'."

Runtime/Design time

This property applies only at design time.

How to apply changes

To apply the corresponding changes when the property value is configured, execute a Rebuild All.

See Also

Converting to Smooth Web UX
Server.Socket external object
User defined event

Last update: February 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant