FocusOutline#
focused 가 true 일 때 child 둘레에 포커스 링을 그리는 순수 시각 래퍼(인프라)입니다. 링만 그릴 뿐 포커스 추적은
호출자 책임입니다 — 올바른 "포커스" 정의가 호출 지점마다 다르기 때문(텍스트 필드는 _focusNode.hasFocus, 리스트 항목은 선택 인덱스 등). 입력·버튼 등이 내부적으로 사용합니다.
Live Preview#
Web
포커스된 요소
Flutter
Loading Flutter...
class FocusOutlineDefaultExample extends StatelessComponent {
const FocusOutlineDefaultExample({super.key});
@override
Component build(BuildContext context) {
return FocusOutline(
focused: true,
child: Card(child: Text('포커스된 요소').bodyMedium),
);
}
}
class FocusOutlineDefaultExample extends StatelessWidget {
const FocusOutlineDefaultExample({super.key});
@override
Widget build(BuildContext context) {
return FocusOutline(
focused: true,
child: Card(child: Text('포커스된 요소').bodyMedium),
);
}
}
사용법#
FocusOutline(
focused: true, // 호출자가 추적한 포커스 상태
child: Card(child: Text('포커스된 요소').bodyMedium),
)
Props#
| 파라미터 | 타입 | 기본값 | 설명 |
|---|---|---|---|
child |
Widget / Component |
required | 링으로 감쌀 콘텐츠 |
focused |
bool |
false |
링 표시 여부 (호출자가 추적) |
shape |
CoreFocusOutlineShape |
rectangle |
링 모양 (rectangle / circle) |
focusOutlineStyle |
CoreFocusOutlineStyle? |
null |
링 색·두께·offset·radius 단일 진입점 |