app/src/main/java/com/stoutner/privacybrowser/CreateBookmark.java

   1 /**
   2  * Copyright 2016 Soren Stoutner <soren@stoutner.com>.
   3  *
   4  * This file is part of Privacy Browser <https://www.stoutner.com/privacy-browser>.
   5  *
   6  * Privacy Browser is free software: you can redistribute it and/or modify
   7  * it under the terms of the GNU General Public License as published by
   8  * the Free Software Foundation, either version 3 of the License, or
   9  * (at your option) any later version.
  10  *
  11  * Privacy Browser is distributed in the hope that it will be useful,
  12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14  * GNU General Public License for more details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with Privacy Browser.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20 package com.stoutner.privacybrowser;
  21
  22 import android.annotation.SuppressLint;
  23 import android.app.Dialog;
  24 import android.content.Context;
  25 import android.content.DialogInterface;
  26 import android.graphics.drawable.BitmapDrawable;
  27 import android.graphics.drawable.Drawable;
  28 import android.os.Bundle;
  29 import android.support.annotation.NonNull;
  30 // If we don't use `android.support.v7.app.AlertDialog` instead of `android.app.AlertDialog` then the dialog will be covered by the keyboard.
  31 import android.support.v7.app.AlertDialog;
  32 // We have to use `AppCompatDialogFragment` instead of `DialogFragment` or an error is produced on API <=22.
  33 import android.support.v7.app.AppCompatDialogFragment;
  34 import android.view.KeyEvent;
  35 import android.view.View;
  36 import android.view.WindowManager;
  37 import android.widget.EditText;
  38
  39 public class CreateBookmark extends AppCompatDialogFragment {
  40     // The public interface is used to send information back to the parent activity.
  41     public interface CreateBookmarkListener {
  42         void onCreateBookmark(AppCompatDialogFragment dialogFragment);
  43     }
  44
  45     // `createBookmarkListener` is used in `onAttach()` and `onCreateDialog()`
  46     private CreateBookmarkListener createBookmarkListener;
  47
  48
  49     public void onAttach(Context context) {
  50         super.onAttach(context);
  51
  52         // Get a handle for `CreateBookmarkListener` from `context`.
  53         try {
  54             createBookmarkListener = (CreateBookmarkListener) context;
  55         } catch(ClassCastException exception) {
  56             throw new ClassCastException(context.toString() + " must implement CreateBookmarkListener.");
  57         }
  58     }
  59
  60     // `@SuppressLing("InflateParams")` removes the warning about using `null` as the parent view group when inflating the `AlertDialog`.
  61     @SuppressLint("InflateParams")
  62     @Override
  63     @NonNull
  64     public Dialog onCreateDialog(Bundle savedInstanceState) {
  65         // Create a drawable version of the favorite icon.
  66         Drawable favoriteIconDrawable = new BitmapDrawable(getResources(), MainWebViewActivity.favoriteIcon);
  67
  68         // Use `AlertDialog.Builder` to create the `AlertDialog`.  The style formats the color of the button text.
  69         AlertDialog.Builder dialogBuilder = new AlertDialog.Builder(getActivity(), R.style.LightAlertDialog);
  70         dialogBuilder.setTitle(R.string.create_bookmark);
  71         dialogBuilder.setIcon(favoriteIconDrawable);
  72         // The parent view is `null` because it will be assigned by the `AlertDialog`.
  73         dialogBuilder.setView(getActivity().getLayoutInflater().inflate(R.layout.create_bookmark_dialog, null));
  74
  75         // Set an `onClick()` listener for the negative button.
  76         dialogBuilder.setNegativeButton(R.string.cancel, new DialogInterface.OnClickListener() {
  77             @Override
  78             public void onClick(DialogInterface dialog, int which) {
  79                 // Do nothing.  The `AlertDialog` will close automatically.
  80             }
  81         });
  82
  83         // Set an `onClick()` listener for the positive button.
  84         dialogBuilder.setPositiveButton(R.string.create, new DialogInterface.OnClickListener() {
  85             @Override
  86             public void onClick(DialogInterface dialog, int which) {
  87                 // Return the `DialogFragment` to the parent activity on create.
  88                 createBookmarkListener.onCreateBookmark(CreateBookmark.this);
  89             }
  90         });
  91
  92
  93         // Create an `AlertDialog` from the `AlertDialog.Builder`.
  94         final AlertDialog alertDialog = dialogBuilder.create();
  95
  96         // Remove the warning below that `setSoftInputMode` might produce `java.lang.NullPointerException`.
  97         assert alertDialog.getWindow() != null;
  98
  99         // Show the keyboard when the `Dialog` is displayed on the screen.
 100         alertDialog.getWindow().setSoftInputMode(WindowManager.LayoutParams.SOFT_INPUT_STATE_ALWAYS_VISIBLE);
 101
 102         // We need to show the `AlertDialog` before we can call `setOnKeyListener()` below.
 103         alertDialog.show();
 104
 105         // Allow the `enter` key on the keyboard to create the bookmark from `create_bookmark_name_edittext`.
 106         EditText createBookmarkNameEditText = (EditText) alertDialog.findViewById(R.id.create_bookmark_name_edittext);
 107         assert createBookmarkNameEditText != null;  // Remove the warning below that `createBookmarkNameEditText` might be `null`.
 108         createBookmarkNameEditText.setOnKeyListener(new View.OnKeyListener() {
 109             public boolean onKey(View v, int keyCode, KeyEvent event) {
 110                 // If the event is a key-down on the `enter` button, select the `PositiveButton` `Create`.
 111                 if ((event.getAction() == KeyEvent.ACTION_DOWN) && (keyCode == KeyEvent.KEYCODE_ENTER)) {
 112                     // Trigger `createBookmarkListener` and return the `DialogFragment` to the parent activity.
 113                     createBookmarkListener.onCreateBookmark(CreateBookmark.this);
 114                     // Manually dismiss the `AlertDialog`.
 115                     alertDialog.dismiss();
 116                     // Consume the event.
 117                     return true;
 118                 } else {  // If any other key was pressed, do not consume the event.
 119                     return false;
 120                 }
 121             }
 122         });
 123
 124         // Set the formattedUrlString as the initial text of `create_bookmark_url_edittext`.
 125         EditText createBookmarkUrlEditText = (EditText) alertDialog.findViewById(R.id.create_bookmark_url_edittext);
 126         assert createBookmarkUrlEditText != null;// Remove the warning below that `createBookmarkUrlEditText` might be `null`.
 127         createBookmarkUrlEditText.setText(MainWebViewActivity.formattedUrlString);
 128
 129         // Allow the `enter` key on the keyboard to create the bookmark from `create_bookmark_url_edittext`.
 130         createBookmarkUrlEditText.setOnKeyListener(new View.OnKeyListener() {
 131             public boolean onKey(View v, int keyCode, KeyEvent event) {
 132                 // If the event is a key-down on the "enter" button, select the PositiveButton "Create".
 133                 if ((event.getAction() == KeyEvent.ACTION_DOWN) && (keyCode == KeyEvent.KEYCODE_ENTER)) {
 134                     // Trigger `createBookmarkListener` and return the DialogFragment to the parent activity.
 135                     createBookmarkListener.onCreateBookmark(CreateBookmark.this);
 136                     // Manually dismiss the `AlertDialog`.
 137                     alertDialog.dismiss();
 138                     // Consume the event.
 139                     return true;
 140                 } else { // If any other key was pressed, do not consume the event.
 141                     return false;
 142                 }
 143             }
 144         });
 145
 146         // `onCreateDialog()` requires the return of an `AlertDialog`.
 147         return alertDialog;
 148     }
 149 }