OutSystems uses React 16 as the default React version for the app runtime since Platform Server 11.12. If you're on Platform Server 11.10.0 and plan an upgrade, check out the notes in this document regarding the React 16 runtime.
In Platform Server 11.12 and earlier, Reactive Web and Mobile Apps use React 15 for the app runtime. OutSystems updates to a newer version of React after initial technical preview to get feedback and address common issues.
If you're running Platform Server 11.10.0, you can use Runtime using React 16 Technical Preview to anticipate possible breaking changes in the app behavior. It's an OutSystems strong recommendation that you use the React 16 technical preview to test your apps and address all potential issues before React 16 becomes the new runtime default.
To run your app with the React 16 runtime, as part of a technical preview, you need to meet the following requirements:
- Platform Server 11.10.0 or later.
- LifeTime 11.6.0 or later.
- Up to date Service Studio.
- You activated the technical preview Runtime using React 16 in LifeTime. Note that only the apps you publish or republish after activating the feature use the new React 16 runtime.
Checking for issues
Once you activate React 16 technical preview in your platform, verify the app works correctly.
- See the known issues section to learn about the issues OutSystems identified and working to fix in a future OutSystems release.
- See the side effects section to read about how new features and changes in React 16 affected the app runtime.
Only the apps you publish or republish after activating Runtime using React 16 technical preview in LifeTime use the new React 16 runtime.
Here is a list of the side effects due to the differences between React 15.0.2 and React 16.13.1. For all the release notes since React 15.0.2, see the React GitHub releases page.
Widgets ignore tampered events
This issue affects the following Forge components:
For related React documentation see Improving inputs.
All attributes show in the HTML
All unknown HTML attributes now show in the resulting HTML. React previously removed all attributes except data- from the output. Due to this change, the runtime now applies the CSS rules that were ignored.
For related React documentation see DOM Attributes in React 16.
Option HTML element only allows text as children
By definition, the
option HTML element only allows text as children. This is now enforced by React 16 and all children of an
option element are now stringified, which may result in rendering
[object Object] when that children is another HTML element, like a
This affects custom implementations of a native dropdown making use of HTML Element widgets with an
option tag. This pattern can instead be implemented using a Dropdown widget with the "Options Content" property set to
A temporary workaround is to remove the children of the
option element and create a
label attribute with the desired text.
Here is the list of known issues that the OutSystems development team identified and is now working to fix in a stable runtime release.
There are no pending known issues at the moment.
Found an issue? Let us know! Post a new question with the technical preview tag in Forums.
This is the list of fixed known issues.
The first screen shows as default when no default exists
Fixed in Platform Server 11.10.1, issue RAR-356.
If you don't set a screen as default, the app uses the first screen of the module as the default. Additionally, the app no longer shows "No Default Screen" error screen.
No navigation after pending refresh
Fixed in Platform Server 11.10.1, issue RAR-422.
In cases where a user needs to refresh the screen, the app still shows the origin screen after refreshing instead of navigating to the destination screen.
No rollback failure message
Fixed in Platform Server 11.10.1, issue RAR-423.
When an app rolls back an upgrade, there's no message notifying the user that the upgrade failed.
Overriding back navigation handler doesn't work
Fixed in Platform Server 11.10.2, issue RAR-333.
If you register a back navigation handler, the app triggers it, but also navigates back to the previous screen.
No animation on leaving the screen
Fixed in Platform Server 11.10.2, issues RAR-439 and RAR-445.
There's no animation when users leave the current screen.
If you experience issues with this technical preview, let us know by posting a new question with the technical preview tag in Forums.