(new) fullsceen property, (fix) '/' dir behaviour

Author: supermamon

file-browser.js

@@ -48,10 +48,12 @@ FileBrowser Class
 class FileBrowser {
 
   //---------------------------------------------
-  constructor(path, {canBrowseParent=false, precheckAccess=true}={}) {
+  constructor(path="/", {canBrowseParent=false, precheckAccess=true, fullscreen=true}={}) {
+    path = path ? path : '/'
     let pwd = path
+    canBrowseParent = path == '/' ? false : canBrowseParent
     let manager = path.includes('iCloud') ? FileManager.iCloud() : FileManager.local()
-    Object.assign(this, {path, manager, pwd, canBrowseParent, precheckAccess})
+    Object.assign(this, {path, manager, pwd, canBrowseParent, precheckAccess, fullscreen})
   }
 
   //---------------------------------------------
@@ -97,13 +99,16 @@ class FileBrowser {
       table.addRow(row)
     }
 
-    await table.present(true)
+    await table.present(this.fullscreen)
     return selected
 
   }
   //---------------------------------------------
   async present() {
-      
+
+    //log(`pwd = ${this.pwd}`)
+    this.pwd = this.pwd ? this.pwd : '/'
+    
     const browser = new UITable()
     browser.showSeparators = true
 
@@ -135,7 +140,7 @@ class FileBrowser {
     try {
       dirContents = this.manager.listContents(this.pwd)
       // add the .. if not the root folder
-      if (this.path != this.pwd || this.canBrowseParent) {
+      if (this.pwd != '/' & ( this.path != this.pwd || this.canBrowseParent )) {
         objects.push( {name:'..', type:'dir', path:'..', isDir:true, displayName:'..', canAccess: true, icon: ICONS.dir} )
       }
 
@@ -212,7 +217,7 @@ class FileBrowser {
     }
 
     const fileBrowser = this
-    let resp = await browser.present(true)
+    let resp = await browser.present(this.fullscreen)
 
     if (!selected) return null
 
@@ -286,6 +291,7 @@ function identify(actualPath, manager, precheckAccess) {
         manager.listContents(path)
         canAccess = true
       } catch(e) {
+        //log(`${name} : ${e.message}`)
         canAccess = false
         titleColor = COLORS.ERROR
       }

readme.md

@@ -42,8 +42,9 @@ new FileBrowser(path, options)
 `path` : the directory to browse
 
 `options` : a JSON value indicating the additional options to change the behaviour of the browser
-- `canBrowseParent: Boolean`: allow browsing above the initial path. Useful for exploring outside the known directories.
-- `precheckAccess: Boolean`: while listing directory contents, check each sub-directory is accessible or not. Inaccessible directories will be colored in red.
+- `canBrowseParent: Boolean`: allow browsing above the initial path. Useful for exploring outside the known directories. Default *false*.
+- `precheckAccess: Boolean`: while listing directory contents, check each sub-directory is accessible or not. Inaccessible directories will be colored in red. Default *true*.
+- `fullscreen: Boolean`: open the file browser in fullscreen. Default *true*.
 
 ---
 
@@ -86,6 +87,15 @@ Allow browsing above the inital path. Useful for exploring outside the known dir
 ```javascript
 canBrowseParent: Boolean
 ```
+---
+
+### fullscreen
+
+Open the file browser in full screen.
+
+```javascript
+fullscreen: Boolean
+```
 
 --- 
 
@@ -117,4 +127,34 @@ The current directory being displayed.
 pwd: String
 ```
 
-![tracking pixel](https://lynks.cc/ghfilebrowser/track)
+## Examples
+
+### Browse a bookmarked path
+
+```javascript
+const path = FileManager.bookmarkedPath('Shortcuts')
+const browser = new FileBrowser(path)
+const file = await browser.present()
+```
+
+### Open a specific folder
+
+```javascript
+const {FileBrowser} = importModule('file-browser')
+const path = '/Developer'
+const browser = new FileBrowser(path)
+const file = await browser.present()
+```
+
+### Disable access precheck
+
+```javascript
+const {FileBrowser} = importModule('file-browser')
+const path = '/Developer'
+const browser = new FileBrowser(path, {precheckAccess:false})
+const file = await browser.present()
+```
+
+![tracking pixel](https://lynks.cc/ghfilebrowser/track)
+
+