[Flutter] 두 키보드 포커스 해제 방법의 차이 (FocusScope VS FocusManager)

서론

Flutter에서 키보드를 내리는 방법에는 여러 가지가 있다. 그중에서도 가장 많이 사용하는 방법이 FocusManager.instance.primaryFocus?.unfocus();와

FocusScope.of(context).unfocus();이 있다.

이번 글에서는 이 두 방식의 차이점과 각각의 특징에 대해 자세히 살펴보려고 한다.

 

---

1. FocusManager.instance.primaryFocus?.unfocus();

이 방식은 현재 활성화된 입력 포커스를 전역적으로 해제하는 방법이다. Flutter의 FocusManager는 애플리케이션 전체의 포커스 상태를 관리하는데, 여기서 primaryFocus를 통해 현재 활성화된 포커스를 가져올 수 있다. 이 값을 사용해 포커스를 해제하면 키보드가 내려가는 원리다.

특징

• 전역적으로 동작한다: 특정 context와 관계없이 현재 활성화된 포커스를 해제한다.
• 간단하다: 코드 한 줄로 손쉽게 사용할 수 있다.

장점

• 어디서든 호출할 수 있다. BuildContext가 필요 없으니 전역적인 키보드 해제 동작을 구현할 때 간편하다.
• 현재 포커스 상태를 직접 가져와 해제하므로 직관적이다.

단점

• 특정 위젯 트리 내에서만 동작을 제한하거나 세밀하게 제어하기 어렵다.

FocusManager.instance.primaryFocus?.unfocus();

 

 

---

2. FocusScope.of(context).unfocus();

이 방식은 특정 위젯 트리와 관련된 포커스를 해제할 때 사용된다. Flutter에서는 포커스를 관리하는 범위(scope)라는 개념이 있는데, FocusScope는 해당 범위 안의 모든 포커스를 관리한다. 이 범위 내의 포커스를 해제하면 키보드가 내려가는 방식이다.

특징

• 로컬하게 동작한다: 특정 위젯 트리의 context를 기반으로 해당 트리 내의 포커스를 해제한다.
• 포커스 스코프를 제어한다: 여러 위젯 간 포커스를 세밀하게 조작하거나 제어할 수 있다.

장점

• 특정 범위의 포커스를 해제할 수 있어, 여러 입력 필드가 있는 화면에서도 필요한 부분만 제어할 수 있다.
• FocusScope를 활용하면 포커스를 전환하거나 특정 조건에서만 동작하도록 구현할 수 있다.

단점

• 호출하려면 반드시 BuildContext가 필요하다.
• 전역적으로 키보드를 숨기기에는 적합하지 않을 수 있다.

사용 예시

FocusScope.of(context).unfocus();

 

 

 

---

주요 차이점

 

특징	FocusManger.instance	FocusScope.of(context)
동작 범위	전역적으로 활성화된 포커스	특정 context 내의 포커스
context 필요 여부	필요 없음	필요
대상	현재 활성화된 포커스	해당 컨텍스트와 연결된 포커스
주요 활용	전역 키보드 해제	특정 위젯 트리 내 포커스 해제
세부 제어 가능 여부	불가능	가능

 

---

 

언제 어떤 방식을 써야 할까?

FocusManager.instance.primaryFocus?.unfocus();

• 전역적으로 키보드를 내리고 싶을 때.
• 특정 위젯이나 화면과 관계없이 활성화된 포커스를 빠르게 해제해야 할 때.

FocusScope.of(context).unfocus();

• 특정 화면이나 위젯 트리 내에서만 포커스를 해제하고 싶을 때.
• 여러 TextField가 있는 화면에서 로컬하게 포커스를 관리해야 할 때.
• FocusScope를 활용해 포커스를 전환하거나 세밀한 제어가 필요할 때.

---

 

결론

두 방식 모두 키보드를 내리는 데 자주 사용되지만, 상황에 따라 적절한 방식을 선택하는 것이 중요하다.

전역적으로 간단히 포커스를 해제하려면 FocusManager.instance.primaryFocus?.unfocus();가 더 적합하다.

반면, 특정 컨텍스트 내에서만 동작하도록 제한하려면 FocusScope.of(context).unfocus();를 사용하는 게 맞다.

Flutter 개발을 하면서 이 두 가지를 적절히 활용하면 키보드 제어가 훨씬 수월해질 것이다.