Basic use of motion

The Action action class makes it very easy for developers to develop an action that contains a specific function that allows the user to interact with the server very easily.

For example, if there is a button on a page, and user clicks on it to request the server to display the information of the logged in user in a popup window, then this button can be developed by Action.

Example

Let’s start developing a button for viewing logged-in user information.

Creating an Action class with a command

First, you need to create the Action class and run the command

  1. php artisan admin:action

After successful execution, you will see the following message in the command window, asking the developer to select an Action class type, here we type 0.

{tip} An action class of type default can be used anywhere on the page.

  1.  Which type of action would you like to make?:
  2.   [0] default
  3.   [1] grid-batch
  4.   [2] grid-row
  5.   [3] grid-tool
  6.   [4] form-tool
  7.   [5] show-tool
  8.   [6] tree-tool
  9.  > 0 # Enter 0

Next, type in the name of the Action class in PascalCase style.

  2.  Please enter a name of action class:
  3.  > ShowCurrentAdminUser

The default namespace is App\Admin\Actions, here we just press Enter to skip it.

  2.  Please enter the namespace of action class [App\Admin\Actions]:
  3.  >

So an Action class is created, and the path of the class just created is app/Admin/Actions/ShowCurrentAdminUser.php.

Use

Modify the Action class as follows

{tip} If you need to pass arguments via a constructor in your action class, be sure to set a default value for all arguments to the constructor!

  1. <?php
  3. namespace App\Admin\Actions;
  5. use Dcat\Admin\Admin;
  6. use Dcat\Admin\Widgets\Table;
  7. use Dcat\Admin\Actions\Action;
  8. use Dcat\Admin\Actions\Response;
  9. use Dcat\Admin\Traits\HasPermissions;
  10. use Illuminate\Contracts\Auth\Authenticatable;
  11. use Illuminate\Database\Eloquent\Model;
  12. use Illuminate\Http\Request;
  14. class ShowCurrentAdminUser extends Action
  15. {
  16.     /**
  17.      * Button Title
  18.      *
  19.      * @var string
  20.      */
  21.     protected $title = 'Personal Information';
  23.     /**
  24.      * @var string
  25.      */
  26.     protected $modalId = 'show-current-user';
  28.     /**
  29.      * If you don't need it, please delete it.
  30.      *
  31.      * @param Request $request
  32.      *
  33.      * @return Response
  34.      */
  35.     public function handle(Request $request)
  36.     {
  37.         // Get the currently logged in user model
  38.         $user = Admin::user();
  39.         // Here we present the model data in a table
  40.         $table = Table::make($user->toArray());
  42.         return $this->response()
  43.             ->success('Search Success')
  44.             ->html($table);
  45.     }
  47.     /**
  48.      * Processes the HTML string of the response and appends it to the popup node.
  49.      *
  50.      * @return string
  51.      */
  52.     protected function handleHtmlResponse()
  53.     {
  54.         return <<<'JS'
  55. function (target, html, data) {
  56.     var $modal = $(target.data('target')); 
  58.     $modal.find('.modal-body').html(html)
  59.     $modal.modal('show')
  60. }        
  61. JS;
  62.     }
  64.     /**
  65.      * Setting the properties of HTML tags
  66.      *
  67.      * @return void
  68.      */
  69.     protected function setupHtmlAttributes()
  70.     {
  71.         // Add class
  72.         $this->addHtmlClass('btn btn-primary');
  74.         // ID of the saved popup
  75.         $this->setHtmlAttribute('data-target', '#'.$this->modalId);
  77.         parent::setupHtmlAttributes();
  78.     }
  80.     /**
  81.      * To set the HTML of the button, here we need to attach the HTML of the popup window.
  82.      *
  83.      * @return string|void
  84.      */
  85.     public function html()
  86.     {
  87.         // Button's html
  88.         $html = parent::html();
  90.         return <<<HTML
  91. {$html}        
  92. <div class="modal fade" id="{$this->modalId}" tabindex="-1" role="dialog">
  93.   <div class="modal-dialog modal-lg" role="document">
  94.     <div class="modal-content">
  95.       <div class="modal-header">
  96.         <button type="button" class="close" data-dismiss="modal" aria-label="Close"><span aria-hidden="true">&times;</span></button>
  97.         <h4 class="modal-title">{$this->title()}</h4>
  98.       </div>
  99.       <div class="modal-body"></div>
  100.     </div>
  101.   </div>
  102. </div>
  103. HTML;
  104.     }
  106.     /**
  107.      * Confirm the pop-up message, and delete this method if you don't need it. 
  108.      *
  109.      * @return string|void
  110.      */
  111.     public function confirm()
  112.     {
  113.         // return ['Confirm?', 'contents'];
  114.     }
  116.     /**
  117.      * Action permission, return false means no permission, if you don't need it, you can delete this method.
  118.      *
  119.      * @param Model|Authenticatable|HasPermissions|null $user
  120.      *
  121.      * @return bool
  122.      */
  123.     protected function authorize($user): bool
  124.     {
  125.         return true;
  126.     }
  128.     /**
  129.      * This method allows you to set the parameters to be attached to an action request.
  130.      *
  131.      * @return array
  132.      */
  133.     protected function parameters()
  134.     {
  135.         return [];
  136.     }
  137. }

After modifying it, you can start using it.

  1. <?php
  3. use App\Admin\Actions\ShowCurrentAdminUser;
  5. class IndexController
  6. {
  7.     public function index(Content $content)
  8.     {
  9.         return $content->body(ShowCurrentAdminUser::make());
  10.     }
  11. }

The results are as follows

Basic use of motion - 图1

Properties

Dcat\Admin\Actions\Action Description of Available Class Properties

attribute name type default description
title string TITLE
selectorPrefix public string .admin-action- Css selector for the target element
method string POST Request methods for interaction with the server
event string click Events bound to the target element, default to click events.
disabled bool false If or not to render the action element, set true to not render the action element
usingHandler bool true When this attribute is set to false, no request is made to the server regardless of whether Action contains the handle method or not!

Methods

Description of the Dcat\Admin\Actions\Action class methodology

Create an instance (make)

This method is a static method that instantiates the action class

  1. $action = MyAction::make($param1, $param2...);

Process request (handle)

When this method is included in the Action class, the target element is bound to an event set by the event attribute (default is click). If the event is triggered, a request is made to the server, and the handle method handles and responds to the request.

{tip} The handle method handles and responds to the request. If there is no such method, the target element is not bound to the event.

Respond (response)

Refer to Actions and Form Responses chapter

Set request data (parameters)

This method allows you to set the parameters that should be attached to the request when the action is initiated.

  1. <?php
  3. use Dcat\Admin\Actions\Action;
  4. use Illuminate\Http\Request;
  6. class MyAction extends Action
  7. {
  8.     public function handle(Request $request) 
  9.     {
  10.         // Receiving parameters
  11.         $key1 = $request->get('key1');
  12.         $key2 = $request->get('key2');
  14.         return $this->response()->success('success！');
  15.     }
  17.     public function parameters()
  18.     {
  19.         return [
  20.             'key1' => 'value1',
  21.             'key2' => 'value2',    
  22.         ];
  23.     }
  24. }

Confirm popups

This method requires a string parameter to be returned.

A confirmation window is added when the return value of this method is not null, and a confirmation box pops up automatically when the event is triggered.

  1. public function confirm()
  2. {
  3.     return 'Are you sure you want to remove this line of content?';
  4. }

Show popup title and content

  1. public function confirm()
  2. {
  3.     return ['Are you sure you want to delete this line of content?' , 'pop-up content'];
  4. }

JS code that is executed before the request is initiated (actionScript)

The js code preceding the execution of the set action executes the js code set by this method before initiating the request when the button-bound event is triggered, and this method requires a js anonymous function to be returned.

The js anonymous function takes the following three arguments:

  • data object The data object to be passed to the interface.
  • target object Action button’s jQuery object
  • action object Action management object.
  1. protected function actionScript()
  2. {
  3.     return <<<JS
  4. function (data, target, action) {
  5.     console.log('Before initiating a request', data, target, action);
  7.     // return false; Here return false to stop the rest of the operation.    
  9.     // Changing the primary key value passed to the interface
  10.     action.options.key = 123;
  11. }
  12. JS    
  13. }

HTML code to handle the server response (handleHtmlResponse)

Processes the HTML code of the server response, which requires a js anonymous function to be returned.

  1. protected function handleHtmlResponse()
  2. {
  3.         return <<<'JS'
  4. function (target, html, data) {
  5.     // target JQ object of the action button
  6.     // html HTML string returned by the interface
  7.     // data json object of the complete data returned by the interface.
  9.     target.html(html);
  10. }
  11. JS;
  12. }

Permissions (authorize)

This method is used to determine the privileges of the logged in user, the default is true

  1. protected function authorize($user): bool
  2. {
  3.     return $user->can('do-action');
  4. }

No Authority Response (failedAuthorization)

This method is used to set the response to an authentication failure and can be overridden if desired

  1. public function failedAuthorization()
  2. {
  3.     return $this->response()->error(__('admin.deny'));
  4. }

Hide or show (disable)

Set to show or hide this action

  1. // hide
  2. MyAction::make()->disable();
  4. // show
  5. MyAction::make()->disable(false);

Determine whether or not to show (allowed)

Determine whether the action is allowed to be displayed

  1. if (MyAction::make()->allowed()) {
  2.     ...
  3. }

setKey

Setting the Data Primary Key

  1. $id = ...;
  3. MyAction::make()->setKey($id);

Get the primary key value (getKey)

Gets the data primary key, also available in the handle method

  1. <?php
  3. use Dcat\Admin\Actions\Action;
  4. use Illuminate\Http\Request;
  6. class MyAction extends Action
  7. {
  8.     public function handle(Request $request) 
  9.     {
  10.         $id = $this->getKey();
  12.         ...
  14.         return $this->response()->success('msng！');
  15.     }
  17.     public function title()
  18.     {
  19.         return "TITLE {$this->key()}";
  20.     }
  21. }

Get target element style (getElementClass)

Get the class of the action target element (button)

  1. $class = MyAction::make()->getElementClass();

Get the Css selector for the target element

Get the CSS selector for the action target element (button)

  1. $selector = MyAction::make()->selector();
  3. Admin::script(
  4.     <<<JS
  5.     $('$selector').click(...);
  6. JS    
  7. );

Add style (addHtmlClass)

Append the class of the action target element (button)

  1. MyAction::make()->addHtmlClass('btn btn-primary');
  3. MyAction::make()->addHtmlClass(['btn', 'btn-primary']);

Set the HTML (html) of the target element

This method is used to set the HTML code of the action target element, overriding it if necessary

  1. protected function html()
  2. {
  3.     return <<<HTML
  4. <a {$this->formatHtmlAttributes()}>{$this->title()}</a>
  5. HTML;
  6. }

Adding JS code (script)

This method is used to add the JS code before the render method finishes executing

  1. protected function script()
  2. {
  3.     return <<<JS
  4. console.log('...')
  5. JS;
  6. }

Set the HTML attribute of the target element (setHtmlAttribute)

Set the HTML tag property of the target element

  1. MyAction::make()->setHtmlAttribute('name', $value);
  3. // batch setting
  4. MyAction::make()->setHtmlAttribute(['name' => $value]);