@ui5/webcomponents-react
Version:
React Wrapper for UI5 Web Components and additional components
89 lines (88 loc) • 4.74 kB
TypeScript
import '@ui5/webcomponents-fiori/dist/UploadCollection.js';
import type UploadCollectionSelectionMode from '@ui5/webcomponents-fiori/dist/types/UploadCollectionSelectionMode.js';
import type { UploadCollectionItemDeleteEventDetail, UploadCollectionSelectionChangeEventDetail } from '@ui5/webcomponents-fiori/dist/UploadCollection.js';
import type { DragEventHandler, ReactNode } from 'react';
import type { CommonProps, Ui5CustomEvent, Ui5DomRef, UI5WCSlotsNode } from '../../types/index.js';
interface UploadCollectionAttributes {
/**
* Defines the accessible ARIA name of the component.
* @default undefined
*/
accessibleName?: string | undefined;
/**
* By default there will be drag and drop overlay shown over the `UploadCollection` when files
* are dragged. If you don't intend to use drag and drop, set this property.
*
* **Note:** It is up to the application developer to add handler for `drop` event and handle it.
* `UploadCollection` only displays an overlay.
* @default false
*/
hideDragOverlay?: boolean;
/**
* Allows you to set your own text for the 'No data' description.
* @default undefined
*/
noDataDescription?: string | undefined;
/**
* Allows you to set your own text for the 'No data' text.
* @default undefined
*/
noDataText?: string | undefined;
/**
* Defines the selection mode of the `UploadCollection`.
* @default "None"
*/
selectionMode?: UploadCollectionSelectionMode | keyof typeof UploadCollectionSelectionMode;
}
interface UploadCollectionDomRef extends Required<UploadCollectionAttributes>, Ui5DomRef {
}
interface UploadCollectionPropTypes extends UploadCollectionAttributes, Omit<CommonProps, keyof UploadCollectionAttributes | 'children' | 'header' | 'onDrop' | 'onItemDelete' | 'onSelectionChange'> {
/**
* Defines the items of the `UploadCollection`.
*
* **Note:** Use `UploadCollectionItem` for the intended design.
*/
children?: ReactNode | ReactNode[];
/**
* Defines the `UploadCollection` header.
*
* **Note:** If `header` slot is provided,
* the labelling of the `UploadCollection` is a responsibility of the application developer.
* `accessibleName` should be used.
*
* __Note:__ The content of the prop will be rendered into a [<slot>](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/slot) by assigning the respective [slot](https://developer.mozilla.org/en-US/docs/Web/HTML/Global_attributes/slot) attribute (`slot="header"`).
* Since you can't change the DOM order of slots when declaring them within a prop, it might prove beneficial to manually mount them as part of the component's children, especially when facing problems with the reading order of screen readers.
*
* __Note:__ When passing a custom React component to this prop, you have to make sure your component reads the `slot` prop and appends it to the most outer element of your component.
* Learn more about it [here](https://sap.github.io/ui5-webcomponents-react/v2/?path=/docs/knowledge-base-handling-slots--docs).
*/
header?: UI5WCSlotsNode;
/**
* Fired when an element is dropped inside the drag and drop overlay.
*
* **Note:** The `drop` event is fired only when elements are dropped within the drag and drop overlay and ignored for the other parts of the `UploadCollection`.
*/
onDrop?: DragEventHandler<UploadCollectionDomRef>;
/**
* Fired when the delete button of any item is pressed.
*/
onItemDelete?: (event: Ui5CustomEvent<UploadCollectionDomRef, UploadCollectionItemDeleteEventDetail>) => void;
/**
* Fired when selection is changed by user interaction
* in `Single` and `Multiple` modes.
*/
onSelectionChange?: (event: Ui5CustomEvent<UploadCollectionDomRef, UploadCollectionSelectionChangeEventDetail>) => void;
}
/**
* This component allows you to represent files before uploading them to a server, with the help of `UploadCollectionItem`.
* It also allows you to show already uploaded files.
*
*
*
* `import "@ui5/webcomponents-fiori/dist/UploadCollectionItem.js";` (for `UploadCollectionItem`)
*
* __Note__: This is a UI5 Web Component! [Repository](https://github.com/SAP/ui5-webcomponents) | [Documentation](https://sap.github.io/ui5-webcomponents/)
*/
declare const UploadCollection: import("react").ForwardRefExoticComponent<UploadCollectionPropTypes & import("../../internal/withWebComponent.js").WithWebComponentPropTypes & import("react").RefAttributes<UploadCollectionDomRef>>;
export { UploadCollection };
export type { UploadCollectionDomRef, UploadCollectionPropTypes };