Adding upstream version 126.0.upstream/126.0

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 76 insertions, 0 deletions

diff --git a/mobile/android/android-components/components/feature/prompts/README.md b/mobile/android/android-components/components/feature/prompts/README.md
new file mode 100644
index 0000000000..704f34b36e
--- /dev/null
+++ b/mobile/android/android-components/components/feature/prompts/README.md
@@ -0,0 +1,76 @@
+# [Android Components](../../../README.md) > Feature > Prompts
+
+A feature for displaying native dialogs. It will subscribe to the selected session and will handle all the common prompt dialogs from web content like input type
+date, file, time, color, option, menu, authentication, confirmation and alerts.
+
+## Usage
+
+### Setting up the dependency
+Use Gradle to download the library from [maven.mozilla.org](https://maven.mozilla.org/) ([Setup repository](../../../README.md#maven-repository)):
+
+```Groovy
+implementation "org.mozilla.components:feature-prompts:{latest-version}"
+```
+
+### PromptFeature
+
+  ```kotlin
+  val onNeedToRequestPermissions : (Array<String>) -> Unit = { permissions ->
+    /* You are in charge of triggering the request for the permissions needed,
+     * this way you can control, when you request the permissions,
+     * in case that you want to show an informative dialog,
+     * to clarify the use of these permissions.
+     */
+    this.requestPermissions(permissions, MY_PROMPT_PERMISSION_REQUEST_CODE)
+  }
+
+  val promptFeature = PromptFeature(fragment = this,
+      fragment = fragment,
+      store = store,
+      fragmentManager= fragmentManager,
+      onNeedToRequestPermissions = onNeedToRequestPermissions
+  )
+
+  // It will start listing for new prompt requests from web content.
+  promptFeature.start()
+
+  // It will stop listing for prompt requests from web content.
+  promptFeature.stop()
+
+  /* There are some requests that are not handled with dialogs, instead they are delegated to other apps
+   * to perform the request e.g a file picker request, which delegates to the OS file picker.
+   * For this reason, you have to forward the results of these requests to the prompt feature by overriding,
+   * onActivityResult in your Activity or Fragment and forward its calls to promptFeature.onActivityResult.
+   */
+  override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
+    promptFeature.onActivityResult(requestCode, resultCode, data)
+  }
+
+  /* Additionally, there are requests that need to have some runtime permission before they can be performed,
+   * like file pickers request that need access to read the selected files. You need to override
+   * onRequestPermissionsResult in your Activity or Fragment and forward the results to
+   * promptFeature.PermissionsResult.
+   */
+  override fun onRequestPermissionsResult(requestCode: Int, permissions: Array<String>, grantResults: IntArray) {
+    when (requestCode) {
+        MY_PROMPT_PERMISSION_REQUEST_CODE -> promptFeature.onPermissionsResult(permissions, grantResults)
+    }
+  }
+  ```
+
+## Facts
+
+This component emits the following [Facts](../../support/base/README.md#Facts):
+
+| Action    | Item         | Description             |
+|-----------|--------------|-------------------------|
+| DISPLAY   | prompt       | A prompt was shown.     |
+| CANCEL    | prompt       | A prompt was canceled.  |
+| CONFIRM   | prompt       | A prompt was confirmed. |
+
+
+## License
+
+    This Source Code Form is subject to the terms of the Mozilla Public
+    License, v. 2.0. If a copy of the MPL was not distributed with this
+    file, You can obtain one at http://mozilla.org/MPL/2.0/