Skip to content

Latest commit

 

History

History
88 lines (71 loc) · 3.52 KB

README.md

File metadata and controls

88 lines (71 loc) · 3.52 KB
Raw

Numeric Keyboard

Maven Central license

Example

More screenshots Custom keyboard Very custom keyboard

Description

It's a simple numeric keyboard which user can't hide. This keyboard prevents focusing on your EditText and you won't see the default keyboard anymore. It supports main features of the android keyboard and can be customized in many different ways.

Library was written in Kotlin. So it will perfectly match with your new awesome project 😉

Installation

The Gradle dependency is available via Maven Central. The minimum API level is 15 (Android 4.0).

dependencies {
    // other dependencies here
    implementation 'com.konaire.numeric-keyboard:numeric-keyboard:1.2.0'
}

Usage

From layout resource

You can set background, width, margin, etc from android xml attributes:
app:field - reference to the EditText which will take user input
app:fieldMaxLength - maxLength of the bound EditText, if it has one
app:keyHeight - height for all keyboard's keys
app:keyTextColor - text color of a key
app:keyTextSize - text size of a key
app:keySpecial - right bottom key on the keyboard (disabled by default, see details in javadoc)

Note: If your EditText has android:maxLength attribute but you haven't provide app:fieldMaxLength for the keyboard, a TextWatcher for that EditText will be called even when user taps on a key after reaching the max length.

In the following example keyboard was initialized from the layout.

<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <EditText
        android:id="@+id/code"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:hint="@string/hint"
        android:inputType="number"
        android:textColor="@android:color/black"
        android:textSize="@dimen/text_size" />

    <!-- Some other stuff -->

    <com.konaire.numerickeyboard.NumericKeyboard
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="bottom"
        android:layout_marginBottom="@dimen/gap"
        app:field="@+id/code"
        app:keyTextColor="@color/green" />
</FrameLayout>

From code

Also you can set all custom parameters from the code. There is an example:

// other imports
import kotlinx.android.synthetic.main.activity_main.*

class MainActivity: AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)

        keyboard.field = field
        keyboard.fieldMaxLength = 10
        keyboard.keyTextColor = Color.GREEN
    }
}

License

The library is distributed under the MIT LICENSE.