Skip to content

Commit c31fa93

Browse files
committed
Review: update warning message, add native info
1 parent f93da73 commit c31fa93

1 file changed

Lines changed: 12 additions & 10 deletions

File tree

content/en/docs/apidocs-mxsdk/apidocs/studio-pro-11/pluggable-widgets/pluggable-widgets-property-types.md

Lines changed: 12 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -28,11 +28,13 @@ This defines the prop `key` in the client component props which are supplied to
2828

2929
#### AllowUpload (Optional) {#allow-upload}
3030

31-
This optional attribute is only applicable for properties of type [file](#file) and [image](#image), and has a default value of `false`. By setting this attribute to `true`, a user can use the upload capabilities by passing `EditableFileValue<FileValue>` and `EditableImageValue<ImageValue>` as props to a client component. Using `false` is used for legacy `DynamicValue<File>` and `DynamicValue<ImageValue>`.
31+
This optional attribute applies only to [file](#file) and [image](#image) properties and determines whether users can upload and edit files. When set to the default value of `false`, properties use the legacy read-only behavior. Setting it to `true` unlocks upload and edit capabilities by passing `EditableFileValue<FileValue>` and `EditableImageValue<ImageValue>` types, as props to a client component.
3232

33-
{{% alert color="warning" %}}
34-
The optional 'allowUpload' attribute on Image and File properties, which enables editing, will be deprecated starting with Mendix 12. After Mendix 12, such properties will have editing capabilities by default. Be aware of behavioral differences based on the 'allowUpload' attribute.
35-
{{% /alert %}}
33+
{{% alert color="warning" %}} Legacy DynamicValue types for file and image properties are deprecated and will be removed at Mendix 12. Use allowUpload="true" to migrate to the new editable types before Mendix 12. {{% /alert %}}
34+
35+
Be aware of behavioral differences between the legacy read-only mode (`false`) and the new editable mode (`true`).
36+
37+
{{% alert color="info" %}} Editable types are not supported for Native as of now. {{% /alert %}}
3638

3739
#### Type (Required)
3840

@@ -269,9 +271,9 @@ Image allows a user to configure an image from an object that is a specializatio
269271

270272
The user can use the optional attribute [`allowUpload`](#allow-upload) with default value `false` to use the legacy [`Dynamic<FileValue>`](/apidocs-mxsdk/apidocs/pluggable-widgets-client-apis/#filevalue) prop. Beware of behavioral differences based on the `allowUpload` attribute.
271273

272-
{{% alert color="warning" %}}
273-
The optional 'allowUpload' attribute on Image and File properties, which enables editing, will be deprecated starting with Mendix 12. After Mendix 12, such properties will have editing capabilities by default. Be aware of behavioral differences based on the 'allowUpload' attribute.
274-
{{% /alert %}}
274+
{{% alert color="warning" %}} Legacy DynamicValue types for file and image properties are deprecated and will be removed at Mendix 12. Use allowUpload="true" to migrate to the new editable types before Mendix 12. {{% /alert %}}
275+
276+
{{% alert color="info" %}} Editable types are not supported for Native as of now. {{% /alert %}}
275277

276278
#### XML Attributes
277279

@@ -714,9 +716,9 @@ The file property type allows a user to configure and edit a file from and to an
714716

715717
The user can use the optional attribute [`allowUpload`](#allow-upload) with default value `false` to use the legacy [`Dynamic<FileValue>`](/apidocs-mxsdk/apidocs/pluggable-widgets-client-apis/#filevalue) prop. Beware of behavioral differences based on the `allowUpload` attribute.
716718

717-
{{% alert color="warning" %}}
718-
The optional 'allowUpload' attribute on Image and File properties, which enables editing, will be deprecated starting with Mendix 12. After Mendix 12, such properties will have editing capabilities by default. Be aware of behavioral differences based on the 'allowUpload' attribute.
719-
{{% /alert %}}
719+
{{% alert color="warning" %}} Legacy DynamicValue types for file and image properties are deprecated and will be removed at Mendix 12. Use allowUpload="true" to migrate to the new editable types before Mendix 12. {{% /alert %}}
720+
721+
{{% alert color="info" %}} Editable types are not supported for Native as of now. {{% /alert %}}
720722

721723
#### XML Attributes
722724

0 commit comments

Comments
 (0)