| OLD | NEW |
| 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. | 1 // Copyright (c) 2012 The Chromium Authors. All rights reserved. |
| 2 // Use of this source code is governed by a BSD-style license that can be | 2 // Use of this source code is governed by a BSD-style license that can be |
| 3 // found in the LICENSE file. | 3 // found in the LICENSE file. |
| 4 | 4 |
| 5 // File-level comment to appease parser. Eventually this will not be necessary. | 5 // File-level comment to appease parser. Eventually this will not be necessary. |
| 6 | 6 |
| 7 namespace fileSystem { | 7 namespace fileSystem { |
| 8 dictionary ChooseFileOptions { | 8 dictionary ChooseFileOptions { |
| 9 // Type of the prompt to show. Valid types are 'openFile', | 9 // Type of the prompt to show. Valid types are 'openFile', |
| 10 // 'openWritableFile' or 'saveFile'. | 10 // 'openWritableFile' or 'saveFile'. |
| 11 // | 11 // |
| 12 // Both 'openFile' and 'openWritableFile' will prompt the user to open an | 12 // Both 'openFile' and 'openWritableFile' will prompt the user to open an |
| 13 // existing file, with 'openFile' returning a read-only FileEntry on | 13 // existing file, with 'openFile' returning a read-only FileEntry on |
| 14 // success. 'saveFile' will prompt the user to choose an existing file or | 14 // success. 'saveFile' will prompt the user to choose an existing file or |
| 15 // a new file, and will return a writable FileEntry. | 15 // a new file, and will return a writable FileEntry. |
| 16 // Calls to chooseFile with either 'openWritableFile' or 'saveFile' will | 16 // Calls to chooseFile with either 'openWritableFile' or 'saveFile' will |
| 17 // fail unless the application has the fileSystemWrite permission. | 17 // fail unless the application has the fileSystemWrite permission. |
| 18 // | 18 // |
| 19 // The default is 'openFile'. | 19 // The default is 'openFile'. |
| 20 DOMString? type; | 20 DOMString? type; |
| 21 |
| 22 // The suggested file name that will be presented to the user as the |
| 23 // default name to read or write. This is optional. |
| 24 DOMString? suggestedName; |
| 21 }; | 25 }; |
| 22 callback GetDisplayPathCallback = void (DOMString displayPath); | 26 callback GetDisplayPathCallback = void (DOMString displayPath); |
| 23 callback FileEntryCallback = void ([instanceOf=fileEntry] object fileEntry); | 27 callback FileEntryCallback = void ([instanceOf=fileEntry] object fileEntry); |
| 24 | 28 |
| 25 interface Functions { | 29 interface Functions { |
| 26 // Get the display path of a FileEntry object. The display path is based on | 30 // Get the display path of a FileEntry object. The display path is based on |
| 27 // the full path of the file on the local file system, but may be made more | 31 // the full path of the file on the local file system, but may be made more |
| 28 // readable for display purposes. | 32 // readable for display purposes. |
| 29 static void getDisplayPath([instanceOf=FileEntry] object fileEntry, | 33 static void getDisplayPath([instanceOf=FileEntry] object fileEntry, |
| 30 GetDisplayPathCallback callback); | 34 GetDisplayPathCallback callback); |
| 31 | 35 |
| 32 // Get a writable FileEntry from another FileEntry. This call will fail | 36 // Get a writable FileEntry from another FileEntry. This call will fail |
| 33 // if the application does not have the fileSystemWrite permission. | 37 // if the application does not have the fileSystemWrite permission. |
| 34 static void getWritableFileEntry([instanceOf=FileEntry] object fileEntry, | 38 static void getWritableFileEntry([instanceOf=FileEntry] object fileEntry, |
| 35 FileEntryCallback callback); | 39 FileEntryCallback callback); |
| 36 | 40 |
| 37 // Ask the user to choose a file. | 41 // Ask the user to choose a file. |
| 38 static void chooseFile(optional ChooseFileOptions options, | 42 static void chooseFile(optional ChooseFileOptions options, |
| 39 FileEntryCallback callback); | 43 FileEntryCallback callback); |
| 40 }; | 44 }; |
| 41 }; | 45 }; |
| OLD | NEW |