Navigation Menu

Skip to content

Commit

Permalink
udpate docs
Browse files Browse the repository at this point in the history
  • Loading branch information
LiquidatorCoder committed Dec 25, 2021
1 parent d750ff5 commit 0ab5249
Show file tree
Hide file tree
Showing 5 changed files with 90 additions and 10 deletions.
100 changes: 90 additions & 10 deletions README.md
@@ -1,16 +1,96 @@
# better_textfield
<h1 align="center">
Better Textfield
</h1>
<p align="center">
<a href="https://flutter.dev/"><img src="https://img.shields.io/badge/Flutter-v2.8.0-blue?logo=flutter"></a>
<a href="https://github.com/LiquidatorCoder/better_textfield"><img src="https://img.shields.io/github/v/release/LiquidatorCoder/better_textfield.svg?style=flat&logo=github&colorB=green&label=release"></a>
<a href="https://github.com/LiquidatorCoder/better_textfield"><img src="https://img.shields.io/github/stars/LiquidatorCoder/better_textfield.svg?style=flat&logo=github&colorB=deeppink&label=stars"></a>
</p>
<p align="center">A native textfield that can be used in place of Flutter's TextField widget.</p>

A new Flutter project.
![Better Textfield -A native textfield that can be used in place of Flutter's TextField widget.](doc/header.png)

## Getting Started
## Demo

This project is a starting point for a Flutter application.
// TODO: Add demo video

A few resources to get you started if this is your first Flutter project:
Here are some screenshots of the demo app:

- [Lab: Write your first Flutter app](https://flutter.dev/docs/get-started/codelab)
- [Cookbook: Useful Flutter samples](https://flutter.dev/docs/cookbook)
| NativeTextField | Magnifier (loupe) effect | Native Text Toolbar |
|-------------- |-------------- |-------------- |
| ![NativeTextField](doc/1.jpg) | ![Magnifier (loupe) effect](doc/2.jpg) | ![Native Text Toolbar](doc/3.jpg) |

For help getting started with Flutter, view our
[online documentation](https://flutter.dev/docs), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
You can also access the demo app via this [link](https://github.com/LiquidatorCoder/better_textfield/releases) or by visiting `release\` directory in the repository.
## Install
The plugin package is under development.
If you still want to use it in your app you can use the code from this repository.

## Features

- Better dragging of the cursor
- Magnifier (loupe) effect
- Fixes all issues described here: [link](https://pastebin.com/iqnjMa1m)
- Supports setting values for text
_ Also supports retrieving input text via the text controller
- Decent performance
- Supports text selection and clipboard
- Supports autocorrect
- Supports direct sharing of text
- Supports only Android for now

## Problem
We generally use TextField and TextFormFields widgets for input field. If you notice, there is a glitch in Flutter’s widget while dragging the cursor, where within a word if you drag the cursor it works fine, but if you try to drag the cursor from one word to another, hen draggable cursor disappears.

(Screen recording attached for reference for Reflectly app developed in Flutter.)

//TODO: Add a link to the video of the issue.

## Solution/Approach
Since this problem only occurs in the TextField widget available in Flutter, we can use the Hybrid composition of AndroidView in Flutter to display a native textfield instead of a regular textfield.
Note, however, that rendering an AndroidView inside a Flutter widget is quite performance intensive and can slow down your app in some cases.
Also, we need to bump up the `minSdkVersion` to at least 19 to support hybrid composition.

I have referred to the following [docs](https://docs.flutter.dev/development/platform-integration/platform-views) to understand how to host a native view in Flutter.

Next, I created a MethodChannel to communicate with the native code.

I also created a native text field controller class to help me retrieve and set text values in the native text field using the MethodChannel.

And that's about it. If you do it right, this only takes 20-30 minutes and greatly improves the app experience if your app is primarily text input based (like a text editor app).

>Note: We can also extend this approach to support iOS UIViews.

## Code Explaination

The structure of the `lib` directory of the app is as follows:

```
│ main.dart [Main app file (starting point of the app)]
├───controllers
│ native_text_field_controller.dart [NativeTextField controller, which handles the communication of data between the textfield and the flutter app]
└───views
home_page.dart [Home page of the demo app]
```

The structure of the `android\app\src\main\kotlin\com\abhay` directory of the app is as follows:

```
└───better_textfield
MainActivity.kt [Main activity of the android app]
NativeView.kt [Native text view class, which is the view that is displayed on the screen]
NativeViewFactory.kt [Native view factory class, which is the factory class that is used to create the native view]
```
## Built With

* [Flutter](https://flutter.dev/)

* [Kotlin](https://kotlinlang.org/)

## Stay Up-to-Date

<img src="https://github.com/AppFlowy-IO/appflowy/blob/main/doc/imgs/howtostar.gif" alt="Star project" width="700px" />
Binary file added doc/1.jpg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/2.jpg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/3.jpg
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added doc/header.png
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 0ab5249

Please sign in to comment.