NAME

HTML::Object::DOM::FileList - HTML Object DOM FileList Class

SYNOPSIS

            

              
              
use HTML::Object::DOM::FileList;
my $list = HTML::Object::DOM::FileList->new || 
    die( HTML::Object::DOM::FileList->error, "\n" );
<input id="fileItem" type="file" />
my $file = $doc->getElementById('fileItem')->files->[0];
            
          

VERSION

            

              
              
v0.2.0
            
          

DESCRIPTION

An object of this type is returned by the "files" in HTML::Object::DOM::Element::Input property of the HTML <input> element; this lets you access a list of files you would have set or added, removed, etc.. It inherits from Module::Generic::Array

Normally, under JavaScript, those files are selected with the <input type="file" /> element. It is also used on the web for a list of files dropped into web content when using the drag and drop API; see the DataTransfer object on Mozilla for details on this usage.

PROPERTIES

length

Read-only.

Returns the number of files in the list.

METHODS

item

Returns a HTML::Object::DOM::File object representing the file at the specified index in the file list.

Example:

            

              
              
# fileInput is an HTML input element: <input type="file" id="myfileinput" multiple />
my $fileInput = $doc->getElementById("myfileinput");
# files is a FileList object (similar to NodeList)
my $files = $fileInput->files;
my $file;
# loop through files
for( my $i = 0; $i < $files->length; $i++ )
{
    # get item
    $file = $files->item($i);
    # or
    $file = $files->[$i];
    say( $file->name );
}
            
          

AUTHOR

Jacques Deguest <jack@deguest.jp>

SEE ALSO

Mozilla documentation

COPYRIGHT & LICENSE

Copyright(c) 2021 DEGUEST Pte. Ltd.

All rights reserved

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.