lotfio/AlgeriaCities

Algeria Cities

Android library that help with manipulating cities in algeria.

Download!

Add it in your root build.gradle at the end of repositories:

allprojects {
        repositories {
	        ...
		maven { url 'https://jitpack.io' }
	}
}

and then

implementation 'com.github.ikerfah:AlgeriaCities:0.2'

Functions

Name	Description
getWilayaById(int)	Get desired wilaya by identifier
getWilayaByName(String)	Get desired wilaya by name
getCommunesByWilayaId(int)	Get desired communes by wilaya identifier
getAllWilaya()	Get all wilaya

Example

AlgeriaCities.getWilayaById(44)

Widgets

Name	Description
WilayaSpinner	Spinner with predefined wilaya list
CommuneSpinner	Spinner with predefined commune for selected wilaya from WilayaSpinner Check attachCommuneSpinner

Example

<com.ikerfah.algeriacities.widgets.WilayaSpinner
        android:id="@+id/spinner"
        android:spinnerMode="dropdown"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        app:lang="arabic"/>

<com.ikerfah.algeriacities.widgets.CommuneSpinner
        android:id="@+id/spinner_child"
        android:layout_width="match_parent"
        android:spinnerMode="dropdown"
        android:layout_height="wrap_content"
        app:lang="french"/>

Tips and tricks

• Use wilayaSpinner.attachCommuneSpinner(CommuneSpinner) Then the communeSpinner will change automatically when the wilaya changed
• use setOnZoneItemSelectedListener for both Wilaya/Commune spinner and get selected wilaya/commune as first parameter along with other default parameters such as position

Example

spinner.setOnZoneItemSelectedListener(object: OnZoneItemSelected<Wilaya>{
            override fun onItemSelected(
                selectedZone: Wilaya?,
                parent: AdapterView<*>?,
                view: View?,
                position: Int,
                id: Long
            ) {
                Toast.makeText(parent?.context, selectedZone?.nomFr, Toast.LENGTH_SHORT).show()
            }

            override fun onNothingSelected(parent: AdapterView<*>?) {
            }

        })

XML Attributes (only with WilayaSpinner and CommuneSpinner)

Name	Description	Values
Lang	Default spinner language	french/arabic (Default french)

Example

app:lang="french" or app:lang="arabic"

Contacts

• If you have a concrete bug report for AlgeriaCites please go to the Issues Tracker, submit your report and tag it "bug".
• If you want to criticize the project, Feel free and contact me at : i.kerfah@gmail.com

License

Copyright 2019 Issam Kerfah

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.