elemental.html.File Maven / Gradle / Ivy
/*
* Copyright 2012 Google Inc.
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
package elemental.html;
import elemental.events.*;
import elemental.util.*;
import elemental.dom.*;
import elemental.html.*;
import elemental.css.*;
import elemental.stylesheets.*;
import java.util.Date;
/**
* The File
object provides information about -- and access to the contents of -- files. These are generally retrieved from a FileList
object returned as a result of a user selecting files using the input
element, or from a drag and drop operation's DataTransfer
object.
Gecko 2.0 note(Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)
Starting in Gecko 2.0 (Firefox 4 / Thunderbird 3.3 / SeaMonkey 2.1)
, the File object inherits from the Blob
interface, which provides methods and properties providing further information about the file.
The file reference can be saved when the form is submitted while the user is offline, so that the data can be retrieved and uploaded when the Internet connection is restored.
Note: The File
object as implemented by Gecko offers several non-standard methods for reading the contents of the file. These should not be used, as they will prevent your web application from being used in other browsers, as well as in future versions of Gecko, which will likely remove these methods.
*/
public interface File extends Blob {
Date getLastModifiedDate();
/**
* The name of the file referenced by the File
object. Read only.
Requires Gecko 1.9.2
*/
String getName();
String getWebkitRelativePath();
}