We regularly update our components with more functionality. Over time, we release new versions of components that we've rebuilt to provide additional features, such as accessibility improvements and deeper customization options. Whenever we publish a new version of a component, we deprecate the existing one.
You can continue to use deprecated components, but we recommend upgrading them. You can automatically upgrade deprecated components individually or select multiple components to upgrade at the same time. All configuration settings (event handlers, tooltips, etc.) transfer to the new component.
If a selected component in your app has been deprecated and a new version is available, click Upgrade in the Inspector.
... button on the upper-right of the editor to open the App actions menu. Select Upgrade components to view a list of all deprecated components to upgrade. If there are no components to upgrade, this menu item is disabled.
Select the components you want to upgrade and click Upgrade.
We sometimes rename fields in new component versions to improve clarity and consistency. For example, the
suffix field of a deprecated component becomes
textAfter in the new version. Upgrading a component automatically updates any direct references to refactored fields.
// Before console.log(textInput1.suffix); const newVariable = textInput1; console.log(newVariable.suffix); // After console.log(textInput1.textAfter); // RENAMED const newVariable = textInput1; console.log(newVariable.suffix); // NOT RENAMED
Updated 11 months ago