# 命令Refresh
---
在前台 *页面刷新* or *列表(table)刷新*
>[danger] 1. 这个用处比较多,当提交表单,或者在列表中对某一列修改后,都需要页面刷新,或者仅仅对列表刷新。
> 2. 在某些特殊的场景下,需要父页面刷新,或者父页面的父页面刷新。
> 3. 涉及到父页面刷新的,均是在子页面关闭时候刷新(如果父页面直接刷新,那么子页面直接就没有了)。
### 支持属性
名称 | 含义
---|---
type | 刷新类型,支持 `table表单属性 page页面刷新 both(默认值,自动匹配,如果有table则为table,如果没有则为page)`
layerNum | 刷新的页面的层数,默认为0,(0为当前页面,1为上级页面,依次类推)
keyInTabsUrl | 要刷新的框架tab页面
setTimeout | 设置延迟执行时间,默认立即执行
网站刷新不在乎有四种。
>[danger] 1. 当前页面刷新
> 2. 当前页面中的某个表单刷新
> 3. 刷新当前页面,并且关闭当前页面后父页面刷新
> 4. 刷新框架中头部tab标签中某一个页面
### 1、参数 `type`
默认值为`both`,这意味着,将自动查看页面是否有`table`,如果有则会刷新`table`,如果没有将刷新页面。
如果强制刷新页面,请设置 type=page
### 2、参数 `layerNum`
默认值为0,意味着仅仅刷新当前页面。
- `layerNum 为 0` 刷新当前页面
- `layerNum 为 1` 刷新当前页面,*当关闭自己时候,父页面刷新*
- `layerNum 为 2` 刷新当前页面,*当关闭自己时候,父页面刷新*,*关闭父页面时候,父页面的父页面刷新*
- 依次类推,支持更多
>[danger] 父页面的刷新都是在子页面关闭的时候刷新的,因为一旦直接刷新,其子页面将消失。
### 3、参数 `keyInTabsUrl`
这个参数是针对框架头部tab页面的刷新
![php2]
```
tab1 仪表盘2 的网址为:http://domain.com/app2/hello
tab2 仪表盘1 的网址为:http://domain.com/app3/word
```
如果在`标签为alert`页面中后台控制 `仪表盘2`页面刷新
则设置 `keyInTabsUrl` 为 `app3` 或者 `word` 等即可
```php
Refresh::make()->keyInTabsUrl("app3");
```
>[danger] Tabs页面刷新也是在点击头部切换,显示的时候才刷新。
#### 一个简单例子
>[info] `A页面`通过`dialog`方式打开`B页面`
> B页面有一个按钮点击后与后台交互,成功后需要刷新B页面,并且当B页关闭的时候A页面刷新。
```php
$refresh =Refresh::make()->layerNum(1);
return JsCmd::make()->addCmd($refresh);
```
[php2]:http://epii.gitee.io/static/project/epiiadmin-js/docimg/php2.png
- 简介/安装
- 快速搭建一个用户中心
- Js代码写在哪里
- 环境变量Args
- 前台组件
- Dialog方式打开页面
- Addtab方式打开页面
- Alert提醒框
- Confirm确认框
- Prompt输入框
- 表单Form
- 列表Table/list
- 基础Table
- 控制Table
- 搜索Table
- 城市选择city-picker
- 文件上传组件
- 基础版本
- 简单版本
- 更多实用组件
- 后台
- 实现方式综述
- 命令管理类JsCmd
- 命令
- Alert命令
- Url命令
- Toast命令
- JsEval命令
- Close命令
- Refresh命令
- CloseAndRefresh命令
- 常用命令的简化
- 文件上传
- 后台基础
- 后台进阶
- 左侧导航badge配置