Merge branch 'master' into address-field

Author: tabacitu

CHANGELOG.md

@@ -20,6 +20,12 @@ All Notable changes to `Backpack CRUD` will be documented in this file
 - Nothing
 
 
+## [3.1.23] - 2016-09-27
+
+### Added
+- autoFocus() and autoFocusOnFirstField() - thanks to [Owen Melbourne](https://github.com/OwenMelbz);
+
+
 ## [3.1.22] - 2016-09-27
 
 ### Fixed

src/CrudPanel.php

@@ -16,10 +16,11 @@
 use Backpack\CRUD\PanelTraits\Reorder;
 use Backpack\CRUD\PanelTraits\Update;
 use Backpack\CRUD\PanelTraits\ViewsAndRestoresRevisions;
+use Backpack\CRUD\PanelTraits\AutoFocus;
 
 class CrudPanel
 {
-    use Create, Read, Update, Delete, Reorder, Access, Columns, Fields, Query, Buttons, AutoSet, FakeFields, FakeColumns, ViewsAndRestoresRevisions;
+    use Create, Read, Update, Delete, Reorder, Access, Columns, Fields, Query, Buttons, AutoSet, FakeFields, FakeColumns, ViewsAndRestoresRevisions, AutoFocus;
 
     // --------------
     // CRUD variables

src/PanelTraits/AutoFocus.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Backpack\CRUD\PanelTraits;
+
+trait AutoFocus
+{
+    public $autoFocusOnFirstField = true;
+
+    public function getAutoFocusOnFirstField()
+    {
+        return $this->autoFocusOnFirstField;
+    }
+
+    public function setAutoFocusOnFirstField($value)
+    {
+        return $this->autoFocusOnFirstField = (bool) $value;
+    }
+
+    public function enableAutoFocus()
+    {
+        return $this->setAutoFocusOnFirstField(true);
+    }
+
+    public function disableAutoFocus()
+    {
+        return $this->setAutoFocusOnFirstField(false);
+    }
+}

src/resources/views/form_content.blade.php

@@ -36,16 +36,43 @@
 	@stack('crud_fields_scripts')
 
 	<script>
-		// Ctrl+S and Cmd+S trigger Save button click
-		$(document).keydown(function(e) {
-		    if ((e.which == '115' || e.which == '83' ) && (e.ctrlKey || e.metaKey))
-		    {
-		        e.preventDefault();
-		        // alert("Ctrl-s pressed");
-		        $("button[type=submit]").trigger('click');
-		        return false;
-		    }
-		    return true;
-		});
+        jQuery('document').ready(function($){
+
+      		// Ctrl+S and Cmd+S trigger Save button click
+      		$(document).keydown(function(e) {
+      		    if ((e.which == '115' || e.which == '83' ) && (e.ctrlKey || e.metaKey))
+      		    {
+      		        e.preventDefault();
+      		        // alert("Ctrl-s pressed");
+      		        $("button[type=submit]").trigger('click');
+      		        return false;
+      		    }
+      		    return true;
+      		});
+
+          @if( $crud->autoFocusOnFirstField )
+            //Focus on first field
+            @php
+              $focusField = array_first($fields, function($field){
+                  return isset($field['auto_focus']) && $field['auto_focus'] == true;
+              })
+            @endphp
+
+            @if($focusField)
+              window.focusField = $('[name="{{$focusField['name']}}"]').eq(0),
+            @else
+              var focusField = $('form').find('input, textarea, select').not('[type="hidden"]').eq(0),
+            @endif
+
+            fieldOffset = focusField.offset().top,
+            scrollTolerance = $(window).height() / 2;
+
+            focusField.trigger('focus');
+
+            if( fieldOffset > scrollTolerance ){
+                $('html, body').animate({scrollTop: (fieldOffset - 30)});
+            }
+          @endif
+        });
 	</script>
-@endsection
+@endsection