# 命令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配置