DOC-3224: New options for dialog components.

Author: kemister85

modules/ROOT/pages/8.3.0-release-notes.adoc

@@ -71,6 +71,18 @@ Added new configuration options to the Link plugin to support file uploads throu
 
 For more information, see xref:link.adoc#files_upload_handler[`+files_upload_handler+`], xref:link.adoc#documents_file_types[`+documents_file_types+`], and xref:link.adoc#link_uploadtab[`+link_uploadtab+`].
 
+=== New options for `dropzone` dialog components
+// #TINY-13278
+
+Added new configuration options to the `dropzone` dialog component to customize the dropzone UI and file type restrictions:
+
+* xref:dialog-components.adoc#dropzone[`+dropAreaLabel+`] - Specifies the text label for the drop area where files can be dragged (default: `+'Drop an image here'+`)
+* xref:dialog-components.adoc#dropzone[`+buttonLabel+`] - Specifies the text label for the browse button (default: `+'Browse for an image'+`)
+* xref:dialog-components.adoc#dropzone[`+allowedFileTypes+`] - Specifies a MIME type pattern for allowed file types (default: `+'image/*'+`, e.g., `+'image/*'+`, `+'application/pdf'+`)
+* xref:dialog-components.adoc#dropzone[`+allowedFileExtensions+`] - Specifies an array of allowed file extensions (default: xref:file-image-upload.adoc#images_file_types[`+images_file_types+`], e.g., `+['.jpg', '.png', '.pdf']+`)
+
+For more information, see xref:dialog-components.adoc#dropzone[dropzone component].
+
 
 [[changes]]
 == Changes

modules/ROOT/pages/dialog-components.adoc

@@ -298,13 +298,30 @@ A *dropzone* is a composite component that catches drag and drops items or lets
 
 *Events:* Interacting with a *dropzone* component will fire the `+onChange+` function in the dialog's configuration.
 
+[cols="1,1,1,3",options="header"]
+|===
+|Name |Type |Requirement |Description
+|type |`+'dropzone'+` |required |The component type. Must be `+'dropzone'+`.
+|name |string |required |An identifier for the dropzone.
+|label |string |optional |Text for the label displayed above the dropzone.
+|dropAreaLabel |string |optional |default: `+'Drop an image here'+` - Text label for the drop area where files can be dragged.
+|buttonLabel |string |optional |default: `+'Browse for an image'+` - Text label for the browse button.
+|allowedFileTypes |string |optional |default: `+'image/*'+` - MIME type pattern that specifies allowed file types (e.g., `+'image/*'+`, `+'application/pdf'+`).
+|allowedFileExtensions |array |optional |default: xref:file-image-upload.adoc#images_file_types[`+images_file_types+`] - Array of allowed file extensions (e.g., `+['.jpg', '.png', '.pdf']+`).
+|context |string |optional |Context condition for when the dropzone is active (e.g., `+'mode:design'+`). Only effective when `+enabled+` is `+true+`.
+|===
+
 [source,js]
 ----
 {
   type: 'dropzone', // component type
   name: 'dropzone', // identifier
   label: 'Dropzone', // text for the label
-  context: 'mode:design' // dropzone is active when the editor is in design mode, only effective when enabled is true
+  dropAreaLabel: 'Drag and drop files here', // text for the drop area (default: 'Drop an image here')
+  buttonLabel: 'Browse files', // text for the browse button (default: 'Browse for an image')
+  allowedFileTypes: 'image/*', // MIME type pattern (default: 'image/*')
+  allowedFileExtensions: ['.jpg', '.png', '.pdf'], // allowed file extensions (default: images_file_types)
+  context: 'mode:design' // dropzone is active when the editor is in design mode
 }
 ----