APICloud（七）：清除缓存、退出系统、返回到上一级、下拉刷新页面、返回到顶部...

1、清除缓存：

/**
 *该方法用来清除最近一周的缓存 
 *  **/
function clearCache(){
	api.actionSheet({
		title:"系统会永久删除此应用的所有数据，包括下载的文件、拍照临时文件、网页缓存文件等.清除时可能需要消耗一定时间。请耐心等候。",
		cancelTitle:"取消",
		destructiveTitle:"确定"    			
    },function(ret,err){
    	if(ret.buttonIndex==1){//确定按钮
    		//进度条提示
    		api.showProgress({
    			animationType:"fade",//进度提示框动画类型
    			title: '努力清除中...',
			    modal: true
            });
            //开始清除
            api.clearCache({
    			timeThreshold:7//清除多少天前的缓存
            },function(ret,err){
            	api.hideProgress();//进度条隐藏	            	
            	api.toast({
			        msg: '清除完成'
			    });
            });                    
    	}
    });    		
}

在清除缓存之前，可以先通过手机设置看看这个APP占用了多少存储空间，再使用手机自带的清除缓存的方法清除一下，看看最后清除了多少缓存。

然后再使用APICloud自带的clearCache()方法清除一下，看看两者的结果是不是一样的。

以此来测试，该方法是否真的清除了缓存。

2、退出系统：

//该方法用来退出系统
function quitTheSystem(){
	api.closeWidget({
	    id: api.appId
    });
}

这个ID也就是config.xml中widget根节点的ID，也是这个手机APP的ID。

3、返回上一级：

/**
 *该方法用来返回页面
 *  **/
function comeBack(){
	api.historyBack({
    },function(ret,err){
    	if (!ret.status) {
        	api.closeWin();
    	}
    });
}

4、下拉刷新页面：

apiready=function(){
	refreshList();
}

//该方法用来下拉刷新
function refreshList(){
	api.setRefreshHeaderInfo({
		visible:true,//是否可见，若设置为false，下拉区域不能隐藏且刷新界面为黑色，什么内容也看不到。
		bgColor: '#ccc',//背景色
		textColor: '#fff',//文本颜色
		textDown: '下拉刷新...',//下拉文字描述，默认值：下拉可以刷新
		textUp: '松开刷新...',//松开时文字描述，默认值：松开可以刷新
		textLoading:'加载中..',//加载状态文字描述
		//textTime:'',，//更新时间文字描述,默认格式为：最后更新+日期时间
		showTime:true//是否需显示更新时间
	},function(ret,err){
	  	//alert("下拉刷新成功");
		api.refreshHeaderLoadDone();//恢复默认状态
	
		//重新加载当前页面
	    window.location.reload();
	});
}

5、返回到顶部：

先在页面添加一个浮动在右下角的div，div中放一张图片(像火箭的图片之类的)，再给图片添加事件，点击时自动到顶部。

按道理，应该添加对滚动条的监听，若页面上有滚动条了那么需要显示“返回顶部”图标，否则不显示或隐藏图标。我这里写的比较简单，一直显示着。具体代码如下：

div：<div class="return_top" onclick="returnToTop();"><img src="images/return_top3.png"></div>

css：.return_top{ width: 3rem; height: 3rem; position: fixed; bottom:4rem; right: 0.3rem; z-index: 9999;}
.return_top img{opacity: 0.5;}
JS：

//该方法用来返回顶部
function returnToTop(){
	//一键回到顶部
    api.pageUp({
    	top:true
    },function(ret,err){
    	if (!ret.scrolled) {//是否滚动，为false时说明当前页面已经到达顶部了
	        //alert("已经滚动到顶部了");
	    }
    });
}

注：pageUp的top必须设置为true，否则每次下拉只是往上翻一页而不是直接到顶部。

有pageUp用来向上翻页，自然也有pageDown向下翻页了，结构和功能跟pageUp差不多，有需要的可以去官网查查。

祝好运！