Download the PHP package demogorgorn/yii2-ajax-submit-button without Composer
On this page you can find all versions of the php package demogorgorn/yii2-ajax-submit-button. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download demogorgorn/yii2-ajax-submit-button
More information about demogorgorn/yii2-ajax-submit-button
Files in demogorgorn/yii2-ajax-submit-button
Package yii2-ajax-submit-button
Short Description AjaxSubmitButton renders an ajax button which is very similar to ajaxSubmitButton from Yii1.
License MIT
Homepage https://github.com/demogorgorn/yii2-ajax-submit-button
Informations about the package yii2-ajax-submit-button
AjaxSubmitButton for Yii 2
=====================================
This is the powerful AjaxSubmitButton widget that renders an ajax button which is very similar to ajaxSubmitButton from Yii1 for Yii 2, but has many useful functions.
Basic Example
Example of usage of the widget with a custom widget (in this case Select2 widget).
The view:
Please note: that #output is a div element which will be updated.
In controller:
Example of usage with ActiveForm and client validation
The view:
As you can see it's quite easy to use the widget with ActiveForm - enough to set the ActiveForm's id to the 'useWithActiveForm' variable. (In this case id is 'add-form', without '#' symbol!).
Client validation
As I said before the widget can be used with ActiveForm and client validation enabled. If you wish to disable it, just set ActiveForm's 'enableClientValidation' to false.
Preloader use
It's possible to use the widget with your own custom preloader.
File Uploads
AjaxSubmitButton fully supports file uploads. For example (look at the comments):
Widget's options
Variable | Description | Type |
---|---|---|
ajaxOptions | ajax options | Array |
options | HTML attributes and other options of the widget's container tag | Array |
tagName | the tag to use to render the button (by default is 'button'. You can specify, for example, 'a' tag) | String |
label | button's label | String |
icon | button's icon | String (e.g. 'fa fa-download') |
iconPosition | button icon position | const (ICON_POSITION_LEFT or ICON_POSITION_RIGHT) |
encodeLabel | whether the label should be HTML-encoded | Boolean |
clickedButtonVarName | js object name. It is unused when useWithActiveForm is enabled | String |
useWithActiveForm | whether the button should not be used with ActiveForm. the id of ActiveForm to use the button with | Boolean / String |
Installation
The preferred way to install this extension is through composer.
Either run
or add
to the require section of your composer.json
file and run composer update
.