AZ-EditText

KO | EN

gitlite — search

#javascript #python #hacktoberfest #react #ai #typescript #llm #go #golang #android #machine-learning #rust #deep-learning #linux

★ 13 Open GitHub ↗

Customizable EditText for Android

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# AZ-EditText
Customizable EditText for Android

[![](https://jitpack.io/v/omarzer0/az-edittext.svg)](https://jitpack.io/#omarzer0/az-edittext)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)

## Preview
<img src="https://github.com/omarzer0/ImagesAndVideos/blob/main/AZ-EditText/overview.gif" width="260" height="480" />

## Features:
- Change all attrs from code and xml
- Set radius to the EditText border
- Change stroke size and active/inactive/error stroke color
- Hanldes hide/show password automatically with a single attr (app:handlePassword="true") 
- Change start drawable when the EditText is active or inactive
- Add start and/or end drawables
- Add start text
- Add click listener on start drawable, end drawable, and start text
- And more [here](#properties)

## Setup

#### Add this in your root build.gradle file
```gradle
allprojects {
  repositories {
    ...
    maven { url 'https://jitpack.io' }
  }
}
```
#### Add this to your module's build.gradle file
```gradle
dependencies {
      implementation 'com.github.omarzer0:az-edittext:0.1.2'
}
```

## Usage
* Basic usage
```xml
      <az.zero.az_edit_text.AZEditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:activeStrokeColor="#4CAF50"
        app:inactiveStrokeColor="#F1F1F1"
        app:containerRadius="8dp"
        app:containerStrokeWidth="1dp"
        app:hint="Username"
        app:startDrawable="@drawable/selector_person"
        app:textSize="16sp" />
```

* Set click listeners on each drawable and start text
```kotlin
        edPhone.setOnStartDrawableClick {
            Toast.makeText(this, "start drawable clicked", Toast.LENGTH_SHORT).show()
        }

edPhone.setOnStartTextClick {
            Toast.makeText(this, "start text clicked", Toast.LENGTH_SHORT).show()
        }

edPhone.setOnEndDrawableClick {
            Toast.makeText(this, "end drawable clicked", Toast.LENGTH_SHORT).show()
        }
```

* Observe text changes
```kotlin
   edPhone.setOnTextChange { text, length ->
            Log.d(TAG, "text changed=> length:$length text:$text\n")
   }
```

- If you want the start (drawable/color) to change when the EditText is active or inactive you can use a selector as following:
  - First create a selector
  
  ```xml
      <?xml version="1.0" encoding="utf-8"?>
      <selector xmlns:android="http://schemas.android.com/apk/res/android">
          
          <item android:drawable="@drawable/ic_person_primary" android:state_activated="true" />

<item android:drawable="@drawable/ic_person" />
      </selector>
  ```
  - Then add it to the start drawable
  
  ```xml
       <az.zero.az_edit_text.AZEditText
            android:layout_width="match_parent"
            android:layout_height="wrap_content"
            ...
            app:startDrawable="@drawable/selector_person" />
  ```

## Examples
* Phone EditText
```xml
    <az.zero.az_edit_text.AZEditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:activeStrokeColor="#FF9800"
        app:containerRadius="8dp"
        app:containerStrokeWidth="1dp"
        app:endDrawable="@drawable/ic_baseline_check_circle_outline_24"
        app:hint="1001234567"
        app:inputType="phone"
        app:startDrawable="@drawable/selector_phone"
        app:startText="+20"
        app:textSize="16sp" />
```
* Password
```xml
    <az.zero.az_edit_text.AZEditText
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:activeStrokeColor="#2196F3"
        app:containerRadius="8dp"
        app:containerStrokeWidth="1dp"
        app:hint="Password"
        app:startDrawable="@drawable/selector_password"
        app:textSize="16sp"    
                                     
        // When handlePassword is true and inputType is textPassword the show/hide password will be automatically be handeled
        app:handlePassword="true" 
        app:inputType="textPassword"
                                   
        // You can change the default Hidden and Shown drawables
        app:passwordHiddenDrawable="YOUR_DRAWABLE_ID"
        app:passwordShownDrawable="YOUR_DRAWABLE_ID"                        
     />
```

## Properties
#### use "app:" before custom attr's name

## Social media
[![](https://img.shields.io/badge/LinkedIn-0077B5?style=for-the-badge&logo=linkedin&logoColor=white)](https://www.linkedin.com/in/omar1adel)
[![](https://img.shields.io/badge/GitHub-100000?style=for-the-badge&logo=github&logoColor=white)](https://github.com/omarzer0)
[![](https://img.shields.io/badge/YouTube-FF0000?style=for-the-badge&logo=youtube&logoColor=white)](https://www.youtube.com/@devOmarAZ)

## License

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
```

AZ-EditText

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README