UNPKG

@wordpress/components

Version:
1 lines • 5.53 kB
{"version":3,"file":"index.mjs","names":["useDropZone"],"sources":["../../src/drop-zone/index.tsx"],"sourcesContent":["import clsx from 'clsx';\nimport { __ } from '@wordpress/i18n';\nimport { useState } from '@wordpress/element';\nimport { upload, Icon } from '@wordpress/icons';\nimport { getFilesFromDataTransfer } from '@wordpress/dom';\nimport { __experimentalUseDropZone as useDropZone } from '@wordpress/compose';\nimport type { DropZoneProps } from './types';\nimport type { WordPressComponentProps } from '../context';\n\n/**\n * `DropZone` is a component creating a drop zone area taking the full size of its parent element. It supports dropping files, HTML content or any other HTML drop event.\n *\n * ```jsx\n * import { DropZone } from '@wordpress/components';\n * import { useState } from '@wordpress/element';\n *\n * const MyDropZone = () => {\n * const [ hasDropped, setHasDropped ] = useState( false );\n *\n * return (\n * <div>\n * { hasDropped ? 'Dropped!' : 'Drop something here' }\n * <DropZone\n * onFilesDrop={ () => setHasDropped( true ) }\n * onHTMLDrop={ () => setHasDropped( true ) }\n * onDrop={ () => setHasDropped( true ) }\n * />\n * </div>\n * );\n * }\n * ```\n */\nexport function DropZoneComponent( {\n\tclassName,\n\ticon = upload,\n\tlabel,\n\tonFilesDrop,\n\tonHTMLDrop,\n\tonDrop,\n\tisEligible = () => true,\n\t...restProps\n}: WordPressComponentProps< DropZoneProps, 'div', false > ) {\n\tconst [ isDraggingOverDocument, setIsDraggingOverDocument ] =\n\t\tuseState< boolean >();\n\tconst [ isDraggingOverElement, setIsDraggingOverElement ] =\n\t\tuseState< boolean >();\n\tconst [ isActive, setIsActive ] = useState< boolean >();\n\tconst ref = useDropZone( {\n\t\tonDrop( event ) {\n\t\t\tif ( ! event.dataTransfer ) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tconst files = getFilesFromDataTransfer( event.dataTransfer );\n\t\t\tconst html = event.dataTransfer.getData( 'text/html' );\n\n\t\t\t/**\n\t\t\t * From Windows Chrome 96, the `event.dataTransfer` returns both file object and HTML.\n\t\t\t * The order of the checks is important to recognize the HTML drop.\n\t\t\t */\n\t\t\tif ( html && onHTMLDrop ) {\n\t\t\t\tonHTMLDrop( html );\n\t\t\t} else if ( files.length && onFilesDrop ) {\n\t\t\t\tonFilesDrop( files );\n\t\t\t} else if ( onDrop ) {\n\t\t\t\tonDrop( event );\n\t\t\t}\n\t\t},\n\t\tonDragStart( event ) {\n\t\t\tsetIsDraggingOverDocument( true );\n\n\t\t\tif ( ! event.dataTransfer ) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * From Windows Chrome 96, the `event.dataTransfer` returns both file object and HTML.\n\t\t\t * The order of the checks is important to recognize the HTML drop.\n\t\t\t */\n\t\t\tif ( event.dataTransfer.types.includes( 'text/html' ) ) {\n\t\t\t\tsetIsActive( !! onHTMLDrop );\n\t\t\t} else if (\n\t\t\t\t// Check for the types because sometimes the files themselves\n\t\t\t\t// are only available on drop.\n\t\t\t\tevent.dataTransfer.types.includes( 'Files' ) ||\n\t\t\t\tgetFilesFromDataTransfer( event.dataTransfer ).length > 0\n\t\t\t) {\n\t\t\t\tsetIsActive( !! onFilesDrop );\n\t\t\t} else {\n\t\t\t\tsetIsActive( !! onDrop && isEligible( event.dataTransfer ) );\n\t\t\t}\n\t\t},\n\t\tonDragEnd() {\n\t\t\tsetIsDraggingOverElement( false );\n\t\t\tsetIsDraggingOverDocument( false );\n\t\t\tsetIsActive( undefined );\n\t\t},\n\t\tonDragEnter() {\n\t\t\tsetIsDraggingOverElement( true );\n\t\t},\n\t\tonDragLeave() {\n\t\t\tsetIsDraggingOverElement( false );\n\t\t},\n\t} );\n\n\tconst classes = clsx( 'components-drop-zone', className, {\n\t\t'is-active': isActive,\n\t\t'is-dragging-over-document': isDraggingOverDocument,\n\t\t'is-dragging-over-element': isDraggingOverElement,\n\t} );\n\n\treturn (\n\t\t<div { ...restProps } ref={ ref } className={ classes }>\n\t\t\t<div className=\"components-drop-zone__content\">\n\t\t\t\t<div className=\"components-drop-zone__content-inner\">\n\t\t\t\t\t<Icon\n\t\t\t\t\t\ticon={ icon }\n\t\t\t\t\t\tclassName=\"components-drop-zone__content-icon\"\n\t\t\t\t\t/>\n\t\t\t\t\t<span className=\"components-drop-zone__content-text\">\n\t\t\t\t\t\t{ label ? label : __( 'Drop files to upload' ) }\n\t\t\t\t\t</span>\n\t\t\t\t</div>\n\t\t\t</div>\n\t\t</div>\n\t);\n}\n\nexport default DropZoneComponent;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,SAAgB,kBAAmB,EAClC,WACA,OAAO,QACP,OACA,aACA,YACA,QACA,mBAAmB,MACnB,GAAG,aACwD;CAC3D,MAAM,CAAE,wBAAwB,6BAC/B,SAAoB;CACrB,MAAM,CAAE,uBAAuB,4BAC9B,SAAoB;CACrB,MAAM,CAAE,UAAU,eAAgB,SAAoB;CACtD,MAAM,MAAMA,0BAAa;EACxB,OAAQ,OAAQ;GACf,IAAK,CAAE,MAAM,cACZ;GAGD,MAAM,QAAQ,yBAA0B,MAAM,YAAa;GAC3D,MAAM,OAAO,MAAM,aAAa,QAAS,WAAY;;;;;GAMrD,IAAK,QAAQ,YACZ,WAAY,IAAK;QACX,IAAK,MAAM,UAAU,aAC3B,YAAa,KAAM;QACb,IAAK,QACX,OAAQ,KAAM;EAEhB;EACA,YAAa,OAAQ;GACpB,0BAA2B,IAAK;GAEhC,IAAK,CAAE,MAAM,cACZ;;;;;GAOD,IAAK,MAAM,aAAa,MAAM,SAAU,WAAY,GACnD,YAAa,CAAC,CAAE,UAAW;QACrB,IAGN,MAAM,aAAa,MAAM,SAAU,OAAQ,KAC3C,yBAA0B,MAAM,YAAa,CAAC,CAAC,SAAS,GAExD,YAAa,CAAC,CAAE,WAAY;QAE5B,YAAa,CAAC,CAAE,UAAU,WAAY,MAAM,YAAa,CAAE;EAE7D;EACA,YAAY;GACX,yBAA0B,KAAM;GAChC,0BAA2B,KAAM;GACjC,YAAa,KAAA,CAAU;EACxB;EACA,cAAc;GACb,yBAA0B,IAAK;EAChC;EACA,cAAc;GACb,yBAA0B,KAAM;EACjC;CACD,CAAE;CAEF,MAAM,UAAU,KAAM,wBAAwB,WAAW;EACxD,aAAa;EACb,6BAA6B;EAC7B,4BAA4B;CAC7B,CAAE;CAEF,OACC,oBAAC,OAAD;EAAK,GAAK;EAAkB;EAAM,WAAY;EAC7C,UAAA,oBAAC,OAAD;GAAK,WAAU;GACd,UAAA,qBAAC,OAAD;IAAK,WAAU;IAAf,UAAA,CACC,oBAAC,MAAD;KACQ;KACP,WAAU;IACV,CAAA,GACD,oBAAC,QAAD;KAAM,WAAU;KACb,UAAA,QAAQ,QAAQ,GAAI,sBAAuB;IACxC,CAAA,CACF;;EACD,CAAA;CACD,CAAA;AAEP"}