@sv-use/core
Version:
A collection of Svelte 5 utilities.
40 lines (39 loc) • 1.45 kB
TypeScript
import type { CleanupFunction, MaybeGetter } from '../__internal__/types.js';
type CreateDropZoneOptions = {
/**
* The allowed data types in the format `xxx/xxx`.
*
* Supports `*` and `xxx/*` wildcards.
* * If set to `*`, it accepts any data type.
* * If set to `xxx/*`, it accepts any data type that starts with `xxx`.
* @default '*'
*/
allowedDataTypes?: MaybeGetter<string> | MaybeGetter<string[]> | ((types: string[]) => boolean);
/**
* Whether to allow multiple files to be dropped.
* @default true
*/
multiple?: boolean;
/**
* Whether to prevent default behavior for unhandled events or not.
* @default false
*/
preventDefaultForUnhandled?: boolean;
onDrop?(files: File[] | null, event: DragEvent): void;
onEnter?(event: DragEvent): void;
onLeave?(event: DragEvent): void;
onOver?(event: DragEvent): void;
};
type CreateDropZoneReturn = {
readonly isOver: boolean;
files: File[] | null;
cleanup: CleanupFunction;
};
/**
* Creates a zone where files can be dropped.
* @param target The element that acts as the drop zone.
* @param options Additional options to customize the behavior.
* @see https://svelte-librarian.github.io/sv-use/docs/core/create-drop-zone
*/
export declare function createDropZone(target: MaybeGetter<HTMLElement | null | undefined>, options?: CreateDropZoneOptions): CreateDropZoneReturn;
export {};