ViewBindingKTX

English | 中文

ViewBinding reduces exceptions caused by id or type errors, which are recommended by both Google officials and Jake Wharton, but it can be a bit cumbersome to use, so this library can help you use ViewBinding with as little code as possible in any usage scenario.

Feature

• Support for the usage of Kotlin and Java
• Support for the usage of reflection and non-reflection
• Support to modify your base class to support ViewBinding
• Support for BaseRecyclerViewAdapterHelper
• Support for Activity, Fragment, Dialog, Adapter
• Support automatic release of binding class instance in Fragment
• Support for custom combination view
• Support for create PopupWindow
• Support for TabLayout to set custom view
• Support for NavigationView to set header view
• Support for DataBinding to automatically set the lifecycle owner

Gradle

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

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

Add dependencies and configurations：

android {
buildFeatures {
viewBinding true
}
}
dependencies {
// The following are optional, please add as needed
implementation 'com.github.DylanCaiCoding.ViewBindingKTX:viewbinding-ktx:2.1.0'
implementation 'com.github.DylanCaiCoding.ViewBindingKTX:viewbinding-nonreflection-ktx:2.1.0'
implementation 'com.github.DylanCaiCoding.ViewBindingKTX:viewbinding-base:2.1.0'
implementation 'com.github.DylanCaiCoding.ViewBindingKTX:viewbinding-brvah:2.1.0'
}

Usage

📝 >> Usage documentation <<

Sample

Get the binding instance using the Kotlin property delegate：

classMainActivity : AppCompatActivity() {
privateval binding:ActivityMainBinding by binding()
overridefunonCreate(savedInstanceState:Bundle?) {
super.onCreate(savedInstanceState)
binding.tvHelloWorld.text ="Hello Android!"
}
}

classHomeFragment : Fragment(R.layout.fragment_home) {
privateval binding:FragmentHomeBinding by binding()
privateval childBinding:LayoutChildBinding by binding(Method.INFLATE)
overridefunonViewCreated(view:View, savedInstanceState:Bundle?) {
super.onViewCreated(view, savedInstanceState)
binding.container.addView(childBinding.root)
}
}

Use in the base class:

classMainActivity : BaseBindingActivity<ActivityMainBinding>() {
overridefunonCreate(savedInstanceState:Bundle?) {
super.onCreate(savedInstanceState)
binding.tvHelloWorld.text ="Hello Android!"
}
}

classHomeFragment: BaseBindingFragment<FragmentHomeBinding>() {
overridefunonViewCreated(view:View, savedInstanceState:Bundle?) {
super.onViewCreated(view, savedInstanceState)
binding.tvHelloWorld.text ="Hello Android!"
}
}

Use in BaseRecyclerViewAdapterHelper：

classFooAdapter : BaseQuickAdapter<Foo, BaseViewHolder>(R.layout.item_foo) {
overridefunconvert(holder:BaseViewHolder, item:Foo) {
holder.getBinding(ItemFooBinding::bind).apply {
tvFoo.text = item.value
}
}
}

See the usage documentation for more usage.

Change log

Releases

Author's other libraries

Library	Description
Longan	Probably the best Kotlin utils library for Android.
LoadingStateView	Decoupling the code of toolbar or loading status view.
MMKV-KTX	Use MMKV with property delegates.
Tracker	A lightweight tracking framework based on the tracking idea of Buzzvideo.

Thanks

Thanks ViewBindingPropertyDelegate for providing an idea without reflection

License

Copyright (C) 2020. Dylan Cai
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.