Base
A base Fragment class that uses DataBinding and provides common functionality for data-bound fragments.
Extends ParentsBindingFragment to provide common binding functionality and permission management.
DataBinding을 사용하고 데이터 바인딩 Fragment에 대한 공통 기능을 제공하는 기본 Fragment 클래스입니다.
ParentsBindingFragment를 상속받아 공통 바인딩 기능과 권한 관리를 제공합니다.
Why this class exists / 이 클래스가 필요한 이유:
Android's DataBinding requires manual DataBindingUtil.inflate() and lifecycleOwner setup for each Fragment.
This class eliminates boilerplate by accepting a layout resource ID and automatically configuring DataBinding.
Enables two-way data binding with ViewModel and automatic UI updates through LiveData observables (StateFlow requires manual collection).
Android의 DataBinding은 각 Fragment마다 수동으로 DataBindingUtil.inflate() 및 lifecycleOwner 설정이 필요합니다.
이 클래스는 레이아웃 리소스 ID를 받아 자동으로 DataBinding을 구성하여 보일러플레이트를 제거합니다.
ViewModel과의 양방향 데이터 바인딩 및 LiveData 옵저버블을 통한 자동 UI 업데이트를 가능하게 합니다 (StateFlow는 수동 수집 필요).
Design decisions / 설계 결정 이유:
Uses constructor parameter for layout resource ID to enable simple single-line class declaration.
Automatically sets lifecycleOwner to viewLifecycleOwner in onViewCreated() for LiveData observation tied to the view lifecycle.
Implements final createBinding() to prevent subclasses from breaking the DataBinding initialization contract.
Inherits event collection infrastructure from ParentsBindingFragment for consistent ViewModel integration.
Properly cleans up binding in onDestroyView() by setting lifecycleOwner to null and calling unbind().
간단한 한 줄 클래스 선언을 위해 생성자 파라미터로 레이아웃 리소스 ID를 사용합니다.
onViewCreated()에서 뷰 생명주기에 연결된 LiveData 관찰을 위해 lifecycleOwner를 viewLifecycleOwner로 자동 설정합니다.
final createBinding()을 구현하여 하위 클래스가 DataBinding 초기화 계약을 깨는 것을 방지합니다.
일관된 ViewModel 통합을 위해 ParentsBindingFragment로부터 이벤트 수집 인프라를 상속받습니다.
onDestroyView()에서 lifecycleOwner를 null로 설정하고 unbind()를 호출하여 바인딩을 적절히 정리합니다.
Usage / 사용법:
Extend this class with your Fragment and pass the layout resource ID.
The lifecycleOwner is automatically set to viewLifecycleOwner in onViewCreated() - no manual setup required for LiveData observation.
Bind your ViewModel to the binding object in onViewCreated(binding, savedInstanceState) (binding is accessible via getBinding()).
Use XML data binding expressions to bind views to ViewModel properties.
Override onEventVmCollect(binding:BINDING) to collect ViewModel events with repeatOnLifecycle().
Fragment에서 이 클래스를 상속받고 레이아웃 리소스 ID를 전달하세요.
lifecycleOwner는 onViewCreated()에서 viewLifecycleOwner로 자동 설정됨 - LiveData 관찰을 위한 수동 설정이 필요하지 않습니다.
onViewCreated(binding, savedInstanceState)에서 ViewModel을 binding 객체에 바인딩하세요 (binding은 getBinding()을 통해 접근 가능).
XML 데이터 바인딩 표현식을 사용하여 뷰를 ViewModel 프로퍼티에 바인딩하세요.
repeatOnLifecycle()로 ViewModel 이벤트를 수집하려면 onEventVmCollect(binding:BINDING)를 오버라이드하세요.
Usage example:
class HomeFragment : BaseDataBindingFragment<FragmentHomeBinding>(R.layout.fragment_home) {
private val viewModel: HomeViewModel by lazy { getViewModel() }
override fun onViewCreated(binding: FragmentHomeBinding, savedInstanceState: Bundle?) {
binding.viewModel = viewModel
// lifecycleOwner is already set automatically - no manual setup needed
setupViews()
}
override fun onEventVmCollect(binding:BINDING) {
viewLifecycleOwner.lifecycleScope.launch {
viewLifecycleOwner.repeatOnLifecycle(Lifecycle.State.STARTED) {
viewModel.events.collect { handleEvent(it) }
}
}
}
}Parameters
The type of the DataBinding class.
DataBinding 클래스의 타입.
The layout resource ID for the fragment.
Fragment의 레이아웃 리소스 ID.
Whether to attach the inflated view to the parent container.
인플레이션된 뷰를 부모 컨테이너에 첨부할지 여부.
Fragment에서는 특별한 경우가 아니라면 기본값 false 사용을 권장합니다.
See also
For the parent class providing binding lifecycle.
바인딩 생명주기를 제공하는 부모 클래스는 ParentsBindingFragment를 참조하세요.
For ViewBinding-enabled Fragment.
ViewBinding을 사용하는 Fragment는 BaseViewBindingFragment를 참조하세요.
Properties
Functions
Called immediately after the binding object is created, inside onCreateView().
Use only for binding variable assignment (e.g. binding.vm = vm).
Do NOT access viewLifecycleOwner, start collectors, or call lifecycle-aware APIs here — viewLifecycleOwner is not yet available at this point.
onCreateView() 내부에서 바인딩 객체가 생성된 직후 호출됩니다.
바인딩 변수 할당(예: binding.vm = vm)에만 사용하세요.
viewLifecycleOwner 접근, collector 시작, lifecycle-aware API 호출은 금지입니다 — 이 시점에서는 viewLifecycleOwner를 아직 사용할 수 없습니다.
Called when the view previously created by onCreateView has been detached from the fragment.
Cleans up the binding reference to prevent memory leaks by setting lifecycleOwner to null and calling unbind().
onCreateView에서 생성된 뷰가 Fragment에서 분리될 때 호출됩니다.
lifecycleOwner를 null로 설정하고 unbind()를 호출하여 메모리 누수를 방지하기 위해 바인딩 참조를 정리합니다.
Called to start collecting ViewModel events.
Typically invoked once per lifecycle (e.g., onCreate or onViewCreated).
ViewModel 이벤트 수집을 시작할 때 호출됩니다.
보통 생명주기 당 1회(onCreate 또는 onViewCreated) 호출됩니다.
Called when the binding is initialized in onViewCreated().
Implement setup logic that requires binding here.
onViewCreated에서 바인딩이 초기화된 후 호출됩니다.
바인딩이 필요한 초기화 로직을 여기서 수행하세요.
Called immediately after onCreateView() has returned.
Sets the binding's lifecycleOwner to viewLifecycleOwner for proper LiveData observation tied to the view lifecycle.
onCreateView()가 반환된 직후 호출됩니다.
뷰 생명주기에 연결된 적절한 LiveData 관찰을 위해 바인딩의 lifecycleOwner를 viewLifecycleOwner로 설정합니다.
Requests permissions using the delegate.
Call only after the Fragment is attached (isAdded == true).
델리게이트를 사용하여 권한을 요청합니다.
Fragment가 attach된 이후(isAdded == true)에만 호출하세요.
Creates and shows an indefinite duration Snackbar from a Fragment.
Logs an error if the Fragment's view is null.
Fragment에서 무제한 시간 Snackbar를 생성하고 표시합니다.
Fragment의 view가 null이면 에러를 로깅합니다.
Creates and shows a long duration Snackbar from a Fragment.
Logs an error if the Fragment's view is null.
Fragment에서 긴 시간 Snackbar를 생성하고 표시합니다.
Fragment의 view가 null이면 에러를 로깅합니다.
Creates and shows a short duration Snackbar from a Fragment.
Logs an error if the Fragment's view is null.
Fragment에서 짧은 시간 Snackbar를 생성하고 표시합니다.
Fragment의 view가 null이면 에러를 로깅합니다.
Creates and shows a long duration Toast message from a Fragment.
Logs an error if the Fragment's context is null.
Fragment에서 긴 시간 Toast 메시지를 생성하고 표시합니다.
Fragment의 context가 null이면 에러를 로깅합니다.
Creates and shows a short duration Toast message from a Fragment.
Logs an error if the Fragment's context is null.
Fragment에서 짧은 시간 Toast 메시지를 생성하고 표시합니다.
Fragment의 context가 null이면 에러를 로깅합니다.
Executes the given block and returns a result if the Fragment's context is not null.
Returns null and logs an error if the context is null.
Fragment의 context가 null이 아닌 경우 주어진 블록을 실행하고 결과를 반환합니다.
context가 null이면 null을 반환하고 에러를 로깅합니다.
Executes the given block and returns a result if the Fragment's view is not null.
Returns null and logs an error if the view is null.
Fragment의 view가 null이 아닌 경우 주어진 블록을 실행하고 결과를 반환합니다.
view가 null이면 null을 반환하고 에러를 로깅합니다.