数据表格事件
<h1>数据表格事件</h1>
<h3>初始化</h3>
<p>通过 <code>Grid::resolving</code> 方法可以监听表格初始化事件。</p>
<p>开发者可以在这两个事件中改变 <code>Grid</code> 的一些设置或行为，比如需要禁用掉某些操作，可以在 <code>app/Admin/bootstrap.php</code> 加入下面的代码：</p>
<pre><code class="language-php">use Dcat\Admin\Grid;
Grid::resolving(function (Grid $grid) {
$grid-&gt;disableActions();
$grid-&gt;disablePagination();
$grid-&gt;disableCreateButton();
$grid-&gt;disableFilter();
$grid-&gt;disableRowSelector();
$grid-&gt;disableToolbar();
});
// 只需要监听一次
Grid::resolving(function (Grid $grid) {
...
}, true);</code></pre>
<p>这样就不用在每一个控制器的代码中来设置了。</p>
<p>如果全局设置后，要在其中某一个表格中开启设置，比如开启显示操作列，在对应的实例上调用 <code>$grid-&gt;disableActions(false);</code> 就可以了</p>
<h3>构建</h3>
<p>通过 <code>Grid::composing</code> 方法可以监听表格被调用事件。</p>
<pre><code class="language-php">Grid::composing(function (Grid $grid) {
...
});
// 只需要监听一次
Grid::composing(function (Grid $grid) {
...
}, true);</code></pre>
<h3>Fetching</h3>
<p>监听表格获取数据之前事件，此事件在 <code>composing</code> 事件之后触发。</p>
<pre><code class="language-php">$grid-&gt;listen(Grid\Events\Fetching::class, function ($grid) {
});
// 可以在 composing 事件中使用
Grid::composing(function (Grid $grid) {
$grid-&gt;listen(Grid\Events\Fetching::class, function ($grid) {
});
});</code></pre>
<h3>Fetched</h3>
<p>监听表格获取数据之后事件，通过监听此事件可以批量修改数据, 参考下面实例</p>
<pre><code class="language-php">$grid-&gt;listen(Grid\Events\Fetched::class, function ($grid, Collection $rows) {
// $collection 当前这一个表格数据的模型集合， 你可以根据你的需要来读取或者修改它的数据。
$rows-&gt;transform(function ($row) {
// 更改行数据
$row['name'] = $row['first_name'].' '.$row['last_name'];
return $row;
});
});</code></pre>
<h3>ApplyFilter</h3>
<p>监听表格过滤器搜索事件，此事件只有在过滤器有搜索条件时才会触发</p>
<pre><code class="language-php">$grid-&gt;listen(Grid\Events\ApplyFilter::class, function ($grid, array $conditions) {
// $conditions 当前过滤器生成的搜索条件数组
dd('表格过滤器', $conditions);
});</code></pre>
<h3>ApplyQuickSearch</h3>
<p>监听表格快捷搜索事件，此事件只有在快捷搜索输入框有值时才会触发</p>
<pre><code class="language-php">$grid-&gt;listen(Grid\Events\ApplyQuickSearch::class, function ($grid, $input) {
// $input 搜索关键字
dd('表格快捷搜索', $input);
});</code></pre>
<h3>ApplySelector</h3>
<p>监听表格规格筛选器事件，此事件只有在规格筛选器选中选项时才会触发</p>
<pre><code class="language-php">$grid-&gt;listen(Grid\Events\ApplySelector::class, function ($grid, array $input) {
// $input 筛选器选中的选项数组
dd('表格规格筛选器', $input);
});</code></pre>
<h3>rows回调</h3>
<p>通过 <code>Grid::rows</code> 方法可以监听表格获取数据之后事件。</p>
<pre><code class="language-php">use Dcat\Admin\Grid\Row;
use Illuminate\Support\Collection;
$grid-&gt;rows(function (Collection $rows) {
/**
* 获取第一行数据
*
* @var Row $firstRow
*/
$firstRow = $rows-&gt;first();
// 设置 tr html属性
$firstRow-&gt;setAttributes(['name' =&gt; '....']);
if ($firstRow) {
// 获取第一行的 id
$id = $firstRow-&gt;id;
// 转化为数组
$row = $firstRow-&gt;toArray();
}
});</code></pre>