FocusOutline | CoUI

FocusOutline

focused 일 때 child 둘레에 포커스 링을 그리는 순수 시각 래퍼 (인프라)

FocusOutline#

focusedtrue 일 때 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 단일 진입점