c006/yii2-submit-spinner Adds a div overlay with a spinning loader on submit

extensionwidgetsform

Yii2 Submit Spinner

Current version 1.1.0

  • New add-on, form_validate

Installation

The preferred way to install this extension is through composer.

Either run

php composer.phar require --prefer-source "c006/yii2-submit-spinner" "dev-master"

or add

"c006/yii2-submit-spinner": "dev-master"

to the require section of your composer.json file.

Required

  • jQuery

  • yii \ widgets \ ActiveForm

Options

class_id => {string}
The ID of the container. default: "SubmitSpinner"

form_id => {string}
The ID of the form

bg_color => {string}
Color of the overlay

bg_opacity => {float}
Opacity of the overlay

spin_speed => {int}
How many seconds a for a complete 360 rotation

radius => {int}
Pixel radius/width of the spinner

bg_spinner_opacity => {float}
Opacity of main spinner

bg_spinner_color => {string}
Color of main spinner

sections => {int}
How many dots or circles

section_size => {int}
Dot/circle size in px

section_color => {string}
Color of dots/circles

section_offset => {int}
How far from the center in px

section_opacity_base => {float}
Minimum opacity e.g. 0.25

proportionate_increase => {boolean}
Will increase/decrease dots proportionally to the main spinner

form_validate => {boolean}
Will trigger on successful ActiveForm validation

Demo

Demo: http://demo.c006.us

Usage

Added javascript functions

  • show_submit_spinner()

  • hide_submit_spinner()

Once the extension is installed, simply use it in your code by :

Defaults option:

<?= \c006\spinner\SubmitSpinner::widget(); ?>

All options: (using defaults)

<?= c006\spinner\SubmitSpinner::widget( [ 'form_id' => $form->id, 'bg_color' => '#444444', 'bg_opacity' => 0.8, 'spin_speed' => 4, 'radius' => 200, 'bg_spinner_opacity' => 0.5, 'bg_spinner_color' => '#000000', 'sections' => 15, 'section_size' => 20, 'section_color' => '#FFFFFF', 'section_offset' => 80, 'section_opacity_base' => .2, 'proportionate_increase' => 1, ] ) ?>

All options: (5 large dots only, no background spinner)

<?= c006\spinner\SubmitSpinner::widget( [ 'form_id' => $form->id, 'bg_color' => '#333333', 'bg_opacity' => 0.8, 'spin_speed' => 4, 'radius' => 250, 'bg_spinner_opacity' => 0.0, 'bg_spinner_color' => '#000000', 'sections' => 5, 'section_size' => 80, 'section_color' => '#FFFFFF', 'section_offset' => 80, 'section_opacity_base' => .2, 'proportionate_increase' => 0, ] ) ?>

Comments / Suggestions

Please provide any helpful feedback or requests.

Thanks.

Statistics

Downloads
GitHub Stars
GitHub Forks

Releases

Comments



v2.0 is the latest of 5 releases



MIT license
Stats
6 github stars & 5 github forks
1 downloads in the last day
72 downloads in the last 30 days
8015 total downloads