IntlPhoneInput

A custom view for Android that allows the user to enter his phone number in an elegant and friendly way.

License	The Apache Software License, Version 2.0
Categories	Net
GroupId	net.rimoto
ArtifactId	intlphoneinput
Last Version	1.0.1
Release Date	Mar 12, 2017
Type	aar
Description	IntlPhoneInput A custom view for Android that allows the user to enter his phone number in an elegant and friendly way.
Project URL	https://github.com/rimoto/IntlPhoneInput
Source Code Management	https://github.com/rimoto/IntlPhoneInput

Download intlphoneinput

Filename	Size
intlphoneinput-1.0.1.pom
intlphoneinput-1.0.1.aar	914 KB
intlphoneinput-1.0.1-sources.jar	5 KB
intlphoneinput-1.0.1-javadoc.jar	41 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/net.rimoto/intlphoneinput/ -->
<dependency>
    <groupId>net.rimoto</groupId>
    <artifactId>intlphoneinput</artifactId>
    <version>1.0.1</version>
    <type>aar</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/net.rimoto/intlphoneinput/
implementation 'net.rimoto:intlphoneinput:1.0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/net.rimoto/intlphoneinput/
implementation ("net.rimoto:intlphoneinput:1.0.1")

Apache Buildr

'net.rimoto:intlphoneinput:aar:1.0.1'

Apache Ivy

<dependency org="net.rimoto" name="intlphoneinput" rev="1.0.1">
  <artifact name="intlphoneinput" type="aar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='net.rimoto', module='intlphoneinput', version='1.0.1')
)

Scala SBT

libraryDependencies += "net.rimoto" % "intlphoneinput" % "1.0.1"

Leiningen

[net.rimoto/intlphoneinput "1.0.1"]

Dependencies

compile (2)

Group / Artifact	Type	Version
com.googlecode.libphonenumber : libphonenumber	jar	7.7.2
com.android.support » appcompat-v7	jar	25.2.0

Project Modules

There are no modules declared in this project.

International Phone Input

What is it?

IntlNumberInput is a custom view for Android that allows the user to enter his phone number in an elegant and friendly way. It adds a flag dropdown to any input, automatically detects the user's country, displays a relevant placeholder and auto formats the number as they type.

***Full Demo Video - https://youtu.be/vDL6gBtltng ***

Features

1. Formatting the number as the user types Aautomatically
2. Automatically set the input placeholder to an example number for the selected country
3. Selecting a country from the dropdown will update the dial code in the input
4. Typing a different dial code will automatically update the displayed flag
5. Easy embedding as a Custom View
6. Listener available to detect validity change
7. Automatically detect phone number when information available
8. Listen to "done" even on the keyboard
9. More..

Download

Download via Gradle or Maven:

compile 'net.rimoto:intlphoneinput:1.0.1'

or Maven:

<dependency>
  <groupId>net.rimoto</groupId>
  <artifactId>intlphoneinput</artifactId>
  <version>1.0.1</version>
</dependency>

Usage

It's easy like 1-2-3!

1. Add the view to your layout XML:

<net.rimoto.intlphoneinput.IntlPhoneInput
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:id="@+id/my_phone_input" />

2. Set text size, text color and flag padding:

<net.rimoto.intlphoneinput.IntlPhoneInput
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    app:textSize="14sp"
    app:textColor="#000000"
    app:flagPaddingBottom="4dp"
    app:flagPaddingEnd="4dp"
    app:flagPaddingStart="4dp"
    app:flagPaddingTop="4dp"
    app:flagPaddingBottom="4dp"
    android:id="@+id/my_phone_input" />

3. Add it in your java

IntlPhoneInput phoneInputView = (IntlPhoneInput) findById(R.id.my_phone_input);

4. Check for validity and get the number!

String myInternationalNumber;
if(phoneInputView.isValid()) {
    myInternationalNumber = phoneInputView.getNumber();
}

Public methods

1. boolean isValid()

2. void setEnabled(boolean enabled)

3. void setOnValidityChange(IntlPhoneInputListener listener)

   public interface IntlPhoneInputListener {
     void done(View view, boolean isValid);
   }

   This simple structure allows you to use lambda expression! (with retrolambda):

   mIntlPhoneInput.setOnValidityChange((view, isValid) -> {
     if(isValid) {...}
   }
   

4. void setOnKeyboardDone(IntlPhoneInputListener listener)

5. void hideKeyboard()

6. void setDefault() - Set default number: if can detect line by permission(requires android.permission.READ_PHONE_STATE), else- example number for country as hint(detect by SIM info if has permission, else by locale). This method automatically invoked on init

7. void setEmptyDeafult(String iso) - Set example hint for iso

8. void setEmptyDefault() - Set example hint by locale

9. void setNumber(String number) - Set number, number in E.164 format(i.e. [phone])

10. String getNumber() or String getText() - Get number in E.164 format

Attributions

1. Inspired by intl-tel-input for jQuery
2. Flag images from region-flags
3. Original country data from mledoze's World countries in JSON, CSV and XML
4. Formatting/validation/example number code from libphonenumber

Sponsors

Thanks to our sponsors for this project:

1. Rimoto

LICENSE

Copyright 2015 Rimoto LTD, AlmogBaku

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.

Rimoto

Versions

Version
1.0.1 Mar 12, 2017
0.9.4 Oct 17, 2016
0.9.1 Jan 5, 2016
0.9.0 Jan 1, 2016