Dcat Admin v1.6.0 更新內容:
本次版本沒有包含不相容改動,適合所有使用者升級。
升級方法
composer update dcat/laravel-admin
本次版本需要重新發布靜態資源以及語言包,然後按Ctrl
+F5
清除瀏覽器快取!
php artisan admin:publish --assets --force
php artisan admin:publish --lang --force
功能新增部分
1.表格固定列
注意這個功能支援組合表頭功能,但不相容列欄位隱藏功能!
透過 fixColumns
方法可以給表格設定固定列,第一個引數表示固定從頭開始的前三列,第二個引數表示固定從後往前數的兩列,(第二個引數可不傳,預設為-1)
$grid->fixColumns(2, -2);
效果
2.表單欄位動態顯示
此功能在工具表單中一樣有效,更多用法請參考文件表單欄位動態顯示
$form->radio('radio')
->when([1, 4], function (Form $form) {
// 值為1和4時顯示文字框
$form->text('text1');
$form->text('text2');
$form->text('text3');
})
->when(2, function (Form $form) {
$form->editor('editor');
})
->when(3, function (Form $form) {
$form->image('image');
})
->options([
1 => '顯示文字框',
2 => '顯示編輯器',
3 => '顯示檔案上傳',
4 => '還是顯示文字框',
])
->default(1);
效果
3.表單支援多列布局 (column)
多列布局功能使用了bootstrap
的柵格佈局系統,所有列的寬度總和不得超出12
// 第一列佔據1/2的頁面寬度
$form->column(6, function (Form $form) {
$form->text('name')->required();
$form->date('born')->required();
$form->select('education')->options([...])->required();
...
});
// 第二列佔據1/2的頁面寬度
$form->column(6, function (Form $form) {
$form->image('avatar');
$form->decimal('wages');
$form->decimal('fund');
...
});
// 調整所有表單的寬度
$form->width(9, 2);
效果
4.工具表單支援tab、column等佈局功能
更多用法請參考文件工具表單佈局
<?php
use Dcat\Admin\Widgets\Form;
class Setting extends Form
{
public function form()
{
$this->tab('選項1', function () {
$this->text('text1');
...
});
$this->tab('選項2', function () {
$this->text('text2');
...
});
}
}
5.表格列轉化bool
值顯示
此功能由小夥伴@yalks貢獻,將這一列轉為bool
值之後顯示為✓
和✗
。
$grid->column('approved')->bool();
你也可以按照這一列的值指定顯示,比如欄位的值為Y
和N
表示true
和false
$grid->column('approved')->bool(['Y' => true, 'N' => false]);
6.表格使用滑動面板搜尋時顯示搜尋條件的數量
7.tags標籤表單支援ajax載入
此功能由小夥伴@larvacent貢獻
$form->tags('friends')->options(function ($ids) {
return User::find((array) $ids)->pluck('name', 'id');
})->ajax('api/users');
API /admin/api/users
介面的程式碼:
public function users(Request $request)
{
$q = $request->get('q');
return User::where('name', 'like', "%$q%")->paginate(null, ['id', 'name as text']);
}
8.彈窗選擇器允許傳遞get引數
$form->selectResource('user_id')->path('auth/users?p1=v1&p2=v2');
9.action生成命令以及程式碼生成器支援自定義PSR4指定的目錄
10.程式碼生成器支援自定義資料倉儲名稱
11.工具表單支援Embeds型別表單
12.表單增加location重新整理整個頁面方法
此功能在工具表單中也一樣可以使用
此方法可以重新整理整個頁面,而不是區域性重新整理
$form->saved(function (Form $form) {
// 不傳引數則重新整理當前頁面
// return $form->location();
return $form->location('auth/user', '儲存成功');
});
// 跳轉並提示錯誤資訊
$form->saved(function (Form $form) {
return $form->location('auth/user', [
'message' => '系統錯誤',
'status' => false,
]);
});
13.自動忽略Display 、Text readonly以及Text disable型別表單
14.Expand以及Modal允許在閉包內返回非同步載入類的例項
$grid->post->modal(function ($modal) {
$modal->title('自定義彈窗標題');
// 允許在比包內返回非同步載入類的例項
return Post::make(['title' => $this->>title]);
});
BUG修復部分
Fieldset
佈局預設顯示為收起問題number
表單元件無法儲存小數問題ConvertEmptyStringsToNull
中介軟體時HasMany
表單無法儲存新增資料問題
簡介
Dcat Admin是一個基於laravel-admin二次開發而成的後臺系統構建工具,只需很少的程式碼即可快速構建出一個功能完善的高顏值後臺系統。內建豐富的後臺常用元件,開箱即用,讓開發者告別冗雜的HTML程式碼,對後端開發者非常友好。
線上演示站點 | 官方文件 | Gitee主頁 | Github主頁
[admin
]