Auto blur on unmount option (#4191)

This adds an Android-only flag blurOnUnmount, that if true when calling push, pop, showModal, dismisModal, as well as when true on the component's static options(passProps) { ... } return value, will cause RNN to check for any focused views when the component the flag was passed for is being unmounted, and blur said view if it exists, causing not just the view to lose focus, but also the soft keyboard to be dismissed.

We added this to our fork of RNN to tackle issues stemming from an inability to dismiss the soft keyboard on unmounting components, due to the disappear/unmount lifecycle events of the component coming too late for our keyboard dismissal calls to make it across the native<->js bridge before the component was unmounted.

As this functionality is hidden behind a flag and does not alter base functionality, and the issue it seeks to solve might have been encountered by other users of RNN, I figured I might as well submit a PR to see if there is interest in merging this back into the base.

lib/android/app/src/main/java/com/reactnativenavigation/parse/ModalOptions.java

@@ -1,29 +1,40 @@
 package com.reactnativenavigation.parse;
 
+import android.support.annotation.NonNull;
+
+import com.reactnativenavigation.parse.params.Bool;
+import com.reactnativenavigation.parse.params.NullBool;
+import com.reactnativenavigation.parse.parsers.BoolParser;
+
 import org.json.JSONObject;
 
 public class ModalOptions {
 
-    public static ModalOptions parse(JSONObject json) {
+    public static ModalOptions parse(final JSONObject json) {
         ModalOptions options = new ModalOptions();
         if (json == null) return options;
 
         options.presentationStyle = ModalPresentationStyle.fromString(json.optString("modalPresentationStyle"));
+        options.blurOnUnmount = BoolParser.parse(json, "blurOnUnmount");
 
         return options;
     }
 
     public ModalPresentationStyle presentationStyle = ModalPresentationStyle.Unspecified;
+    public @NonNull Bool blurOnUnmount = new NullBool();
 
-    public void mergeWith(ModalOptions other) {
-        if (other.hasValue()) presentationStyle = other.presentationStyle;
+    public void mergeWith(final ModalOptions other) {
+        if (other.presentationStyleHasValue()) presentationStyle = other.presentationStyle;
+        if (other.blurOnUnmount.hasValue()) blurOnUnmount = other.blurOnUnmount;
     }
 
-    private boolean hasValue() {
+    private boolean presentationStyleHasValue() {
         return presentationStyle != ModalPresentationStyle.Unspecified;
     }
 
-    public void mergeWithDefault(ModalOptions defaultOptions) {
-        if (!hasValue()) presentationStyle = defaultOptions.presentationStyle;
+    public void mergeWithDefault(final ModalOptions defaultOptions) {
+        if (!presentationStyleHasValue()) presentationStyle = defaultOptions.presentationStyle;
+        if (!blurOnUnmount.hasValue()) blurOnUnmount = defaultOptions.blurOnUnmount;
     }
+
 }

lib/android/app/src/main/java/com/reactnativenavigation/viewcontrollers/ComponentViewController.java

@@ -2,6 +2,7 @@ package com.reactnativenavigation.viewcontrollers;
 
 import android.app.Activity;
 import android.support.annotation.NonNull;
+import android.view.View;
 
 import com.reactnativenavigation.parse.Options;
 import com.reactnativenavigation.presentation.Presenter;
@@ -71,4 +72,21 @@ public class ComponentViewController extends ChildController<ComponentLayout> {
     ReactComponent getComponent() {
         return view;
     }
+
+    @Override
+    public void destroy() {
+        final boolean blurOnUnmount = options != null && options.modal.blurOnUnmount.isTrue();
+        if (blurOnUnmount) {
+            blurActivityFocus();
+        }
+        super.destroy();
+    }
+
+    private void blurActivityFocus() {
+        final Activity activity = getActivity();
+        final View focusView = activity != null ? activity.getCurrentFocus() : null;
+        if (focusView != null) {
+            focusView.clearFocus();
+        }
+    }
 }

lib/src/interfaces/Options.ts

@@ -753,4 +753,10 @@ setRoot: {
    * #### (iOS specific)
    */
   rootBackgroundImage?: ImageRequireSource;
+  /**
+   * Enable or disable automatically blurring focused input, dismissing keyboard on unmount
+   * #### (Android specific)
+   * @default false
+   */
+  blurOnUnmount?: boolean;
 }