fileBrowser

概述

fileBrowser 实现对文件的浏览功能,点击文件可返回该文件的绝对路径。该插件可对文件进行删除操作

图片说明

isAllfilesPermission

Android11以上设备需调用此方法检测是否拥有文件管理权限

isAllfilesPermission(callback(ret))

注意:该方法只能在Android11以上的设备上调用有效

ret:

类型:JSON 对象

内部字段:

{
    status:true 当有“MANAGE_EXTERNAL_STORAGE”权限时返回true
}

示例代码

var fileBrowser = api.require('fileBrowser');
fileBrowser.isAllfilesPermission(function(ret) {
    api.alert({
            msg: JSON.stringify(ret)
        })
});

可用性

Android系统

可提供的1.0.0及更高版本

requestAllfilesPermission

Android11以上设备打开系统申请管理所有文件权限的界面

requestAllfilesPermission()

注意:该方法只能在Android11以上的设备上调用有效

示例代码

var fileBrowser = api.require('fileBrowser');
fileBrowser.requestAllfilesPermission();

可用性

Android系统

注意:在Android11的设备上运行,需要先申请“MANAGE_EXTERNAL_STORAGE”权限。非文件管理类应用申请此权限可能会导致无法在应用市场上架。

可提供的1.0.0及更高版本

open

打开文件浏览器

open({params}, callback(ret))

params

confirm:

  • 类型:布尔类型:
  • 描述:(可选项)当设置true时 点击设置按钮进入选择界面选择文件或文件夹点击确认返回路径,当为false时进入到删除界面
  • 默认:false

path:

  • 类型:字符串类型:
  • 描述:(可选项)需要打开的文件的目录路径;本地(fs://)路径
  • 默认:沙盒路经

callback(ret)

ret:

类型:JSON 对象

##内部字段:

{
    url: '文件路径,字符串类型',
    name: '文件名称,带有扩展名,字符串类型',
    date: '文件创建日期,时间戳,字符串类型',
    size: '文件大小,单位:B,数值类型'
    confirm:true 当confirm设置为true时返回此字段表示进入选择界面
    当confirm=true时返回如下
    folderPath:["",""]  返回选中的数组路径
}

示例代码

var fileBrowser = api.require('fileBrowser');
fileBrowser.open(function(ret) {
    if (ret) {
        api.alert({
            msg: JSON.stringify(ret)
        })
    }
});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

close

关闭文件浏览器

close()

示例代码

var fileBrowser = api.require('fileBrowser');
fileBrowser.close();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

skin

换肤接口,调用此接口后要重新打开界面才能换肤成功

skin()

params

skin:

  • 类型:数字类型:
  • 描述:(可选项)
  • 默认:0
  • 取值范围 :
    • 0 原始皮肤
    • 1 白色皮肤
    • 2 灰色皮肤

color:

  • 类型:JSON 对象
  • 描述:颜色设置
  • 内部字段
{
      bgColor:'',  //(可选项)字符串类型;每行的背景颜色,支持 rgb,rgba,#;ios默认:'#fff',androi默认为皮肤对应颜色
      titleColor:'', //(可选项)字符串类型;每行的标题颜色,支持 rgb,rgba,#;ios默认:'#fff',androi默认为皮肤对应颜色
      subtitleColor:'',//(可选项)字符串类型;每行的副标题颜色,支持 rgb,rgba,#;ios默认:'#fff',androi默认为皮肤对应颜色
      timeColor:',    //(可选项)字符串类型;每行的时间颜色,支持 rgb,rgba,#;ios默认:'#fff',androi默认为皮肤对应颜色
      lineColor:',   //(可选项)字符串类型;每行的分割线颜色,支持 rgb,rgba,#;ios默认:'#fff',androi默认为皮肤对应颜色
}

示例代码

var fileBrowser = api.require('fileBrowser');
fileBrowser.skin({
    skin:2,
    color:{
      bgColor:'',  //(可选项)字符串类型;每行的背景颜色,支持 rgb,rgba,#;默认:'#fff'
      titleColor:'', //(可选项)字符串类型;每行的标题颜色,支持 rgb,rgba,#;默认:'#fff'
      subtitleColor:'',//(可选项)字符串类型;每行的副标题颜色,支持 rgb,rgba,#;默认:'#fff'
      timeColor:'',    //(可选项)字符串类型;每行的时间颜色,支持 rgb,rgba,#;默认:'#fff'
      lineColor:'',    //(可选项)字符串类型;每行的分割线颜色,支持 rgb,rgba,#;默认:'#fff'

    }
});

可用性

iOS系统,Android系统

是否仍需要帮助? 请保持联络!
最后更新于 2024/11/18