맞춤 뷰 구성요소 만들기

Compose 방식 사용해 보기
Jetpack Compose는 Android에 권장되는 UI 도구 키트입니다. Compose에서 레이아웃을 사용하는 방법을 알아보세요.
Compose의 맞춤 레이아웃 →

Android는 기본 레이아웃 클래스 View 및 ViewGroup를 기반으로 UI를 빌드하기 위한 정교하고 강력한 구성요소화된 모델을 제공합니다. 플랫폼에는 UI를 구성하는 데 사용할 수 있는 사전 빌드된 다양한 View 및 ViewGroup 서브클래스(각각 위젯과 레이아웃)가 포함되어 있습니다.

사용 가능한 위젯의 일부 목록에는 Button, TextView, EditText, ListView, CheckBox, RadioButton, Gallery, Spinner와 더 특별한 용도의 위젯인 AutoCompleteTextView, ImageSwitcher, TextSwitcher가 있습니다.

사용 가능한 레이아웃에는 LinearLayout, FrameLayout, RelativeLayout 등이 있습니다. 더 많은 예는 일반 레이아웃을 참고하세요.

미리 빌드된 위젯이나 레이아웃이 필요에 맞지 않으면 자체 View 서브클래스를 만들 수 있습니다. 기존 위젯이나 레이아웃을 약간만 조정해야 하는 경우 위젯 또는 레이아웃을 서브클래스로 만들고 메서드를 재정의할 수 있습니다.

자체 View 서브클래스를 만들면 화면 요소의 모양과 기능을 정밀하게 제어할 수 있습니다. 다음은 맞춤 뷰로 할 수 있는 작업의 몇 가지 예입니다.

  • 완전히 맞춤 렌더링된 View 유형을 만들 수 있습니다. 예를 들어 아날로그 전자 컨트롤과 유사한 '볼륨 컨트롤' 노브(2D 그래픽을 사용하여 렌더링됨)를 만들 수 있습니다.
  • View 구성요소 그룹을 새로운 단일 구성요소로 결합할 수 있습니다. 예를 들어 콤보 상자 (팝업 목록과 자유 입력 텍스트 필드의 조합), 이중 창 선택기 컨트롤 (목록이 각각 하나씩 있고 각 목록에 어떤 항목이 어느 항목에 있는지 재할당할 수 있음) 등을 만들 수 있습니다.
  • EditText 구성요소가 화면에서 렌더링되는 방식을 재정의할 수 있습니다. NotePad 샘플 앱은 이 효과를 사용하여 줄이 있는 메모장 페이지를 만듭니다.
  • 키 누름과 같은 기타 이벤트를 캡처하고 게임과 같은 맞춤 방식으로 처리할 수 있습니다.

다음 섹션에서는 맞춤 뷰를 만들어 애플리케이션에서 사용하는 방법을 설명합니다. 자세한 참조 정보는 View 클래스를 참고하세요.

기본 접근 방식

다음은 자체 View 구성요소를 만들기 위해 알아야 하는 사항에 관한 대략적인 개요입니다.

  1. 자체 클래스로 기존 View 클래스 또는 서브클래스를 확장합니다.
  2. 슈퍼클래스에서 일부 메서드를 재정의합니다. 재정의할 슈퍼클래스 메서드는 on로 시작합니다(예: onDraw(), onMeasure(), 및 onKeyDown()). 이는 수명 주기 및 기타 기능 후크에 관해 재정의하는 Activity 또는 ListActivity의 on 이벤트와 유사합니다.
  3. 새 확장 클래스를 사용합니다. 완료되면 기반이 되는 뷰 대신 새 확장 클래스를 사용할 수 있습니다.

완전히 맞춤설정된 구성요소

원하는 대로 표시되도록 완전히 맞춤설정된 그래픽 구성요소를 만들 수 있습니다. 오래된 아날로그 게이지처럼 보이는 그래픽 VU 미터 또는 노래방 기계를 따라 부를 때 튀어 오르는 공이 단어를 따라 움직이는 텍스트 뷰를 원할 수 있습니다. 결합 방법에 관계없이 기본 제공 구성요소가 할 수 없는 작업이 필요할 수 있습니다.

다행히 데스크톱 워크스테이션보다 성능이 훨씬 낮은 기기에서 애플리케이션을 실행해야 할 수 있다는 점을 염두에 두고 상상력, 화면 크기 및 사용 가능한 처리 능력에 의해서만 제한되고 원하는 대로 모양과 동작을 갖춘 구성요소를 만들 수 있습니다.

완전히 맞춤설정된 구성요소를 만들려면 다음을 고려하세요.

  • 확장할 수 있는 가장 일반적인 뷰는 View입니다. 따라서 일반적으로 이를 확장하여 새로운 슈퍼 구성요소를 만듭니다.
  • XML에서 속성과 매개변수를 가져올 수 있는 생성자를 제공할 수 있으며 VU 미터의 색상과 범위 또는 바늘의 너비와 감쇠와 같은 고유한 속성과 매개변수를 사용할 수 있습니다.
  • 구성요소 클래스에서 더 정교한 동작은 물론 자체 이벤트 리스너, 속성 접근자, 수정자도 만드는 것이 좋습니다.
  • 거의 확실하게 onMeasure()를 재정의해야 하며, 구성요소에 무언가를 표시하려면 onDraw()를 재정의해야 할 수 있습니다. 둘 다 기본 동작이 있지만 기본 onDraw()는 아무 작업도 하지 않으며 기본 onMeasure()는 항상 크기를 100x100으로 설정하지만 원하지 않을 수도 있습니다.
  • 필요에 따라 다른 on 메서드를 재정의할 수도 있습니다.

onDraw() 및 onMeasure() 확장

onDraw() 메서드는 2D 그래픽, 기타 표준 또는 맞춤 구성요소, 스타일이 지정된 텍스트 등 원하는 모든 것을 구현할 수 있는 Canvas를 제공합니다.

onMeasure()는 좀 더 복잡합니다. onMeasure()는 구성요소와 컨테이너 간 렌더링 계약의 중요한 부분입니다. 포함된 부분의 측정값을 효율적이고 정확하게 보고하려면 onMeasure()를 재정의해야 합니다. 이는 상위 요소의 제한 요구사항(onMeasure() 메서드에 전달됨)과 계산된 후 측정된 너비와 높이로 setMeasuredDimension() 메서드를 호출해야 한다는 요구사항으로 인해 약간 더 복잡해집니다. 재정의된 onMeasure() 메서드에서 이 메서드를 호출하지 않으면 측정 시간에 예외가 발생합니다.

개략적으로 onMeasure() 구현은 다음과 같습니다.

  • 재정의된 onMeasure() 메서드는 생성하는 너비 및 높이 측정에 관한 요구사항으로 처리되는 너비 및 높이 사양과 함께 호출됩니다. widthMeasureSpec 및 heightMeasureSpec 매개변수는 모두 크기를 나타내는 정수 코드입니다. 이러한 사양에서 요구할 수 있는 종류의 제한에 관한 전체 참조는 View.onMeasure(int, int)의 참조 문서에서 확인할 수 있습니다. 이 참조 문서에는 전체 측정 작업도 설명되어 있습니다.
  • 구성요소의 onMeasure() 메서드는 구성요소를 렌더링하는 데 필요한 측정 너비와 높이를 계산합니다. 통과된 사양을 초과할 수도 있지만, 전달된 사양을 벗어나지 않도록 노력해야 합니다. 이 경우 상위 요소는 다른 측정 사양을 사용하여 클리핑, 스크롤, 예외 발생, onMeasure()에 다시 시도하도록 요청하는 등 실행할 작업을 선택할 수 있습니다.
  • 너비와 높이가 계산되면 계산된 측정값으로 setMeasuredDimension(int width, int height) 메서드를 호출합니다. 그렇지 않으면 예외가 발생합니다.

다음은 프레임워크가 뷰에서 호출하는 다른 표준 메서드를 요약한 것입니다.

카테고리 메서드 설명
생성 생성자 코드에서 뷰를 생성할 때 호출되는 생성자의 양식과 레이아웃 파일에서 뷰가 확장될 때 호출되는 양식이 있습니다. 두 번째 양식은 레이아웃 파일에 정의된 속성을 파싱하고 적용합니다.
onFinishInflate() 뷰와 뷰의 모든 하위 요소가 XML에서 확장되었을 때 호출됩니다.
레이아웃 onMeasure(int, int) 이 뷰와 그 하위 요소의 크기 요구사항을 결정하기 위해 호출됩니다.
onLayout(boolean, int, int, int, int) 뷰가 모든 하위 요소에 크기와 위치를 할당해야 할 때 호출됩니다.
onSizeChanged(int, int, int, int) 이 뷰의 크기가 변경될 때 호출됩니다.
그리기 onDraw(Canvas) 뷰가 콘텐츠를 렌더링해야 할 때 호출됩니다.
이벤트 처리 onKeyDown(int, KeyEvent) 키 다운 이벤트가 발생할 때 호출됩니다.
onKeyUp(int, KeyEvent) 주요 업 이벤트가 발생할 때 호출됩니다.
onTrackballEvent(MotionEvent) 트랙볼 모션 이벤트가 발생할 때 호출됩니다.
onTouchEvent(MotionEvent) 터치스크린 모션 이벤트가 발생할 때 호출됩니다.
초점 onFocusChanged(boolean, int, Rect) 뷰가 포커스를 얻거나 잃을 때 호출됩니다.
onWindowFocusChanged(boolean) 뷰가 포함된 창이 포커스를 얻거나 잃을 때 호출됩니다.
연결 onAttachedToWindow() 뷰가 창에 연결될 때 호출됩니다.
onDetachedFromWindow() 뷰가 창에서 분리될 때 호출됩니다.
onWindowVisibilityChanged(int) 뷰가 포함된 창의 가시성이 변경될 때 호출됩니다.

복합 컨트롤

완전히 맞춤설정된 구성요소를 만들지 않고 기존 컨트롤 그룹으로 구성된 재사용 가능한 구성요소를 함께 만들려는 경우에는 복합 구성요소 (또는 복합 컨트롤)를 만드는 것이 가장 좋을 수 있습니다. 요약하면 이는 좀 더 원자적인 여러 컨트롤 또는 뷰를 단일 항목으로 취급할 수 있는 논리적 항목 그룹으로 결합합니다. 예를 들어 콤보 상자는 한 줄로 된 EditText 필드와 팝업 목록이 첨부된 인접한 버튼의 조합일 수 있습니다. 사용자가 버튼을 탭하여 목록에서 무언가를 선택하면 EditText 필드가 채워지지만 원하는 경우 EditText에 직접 입력할 수도 있습니다.

Android에서는 Spinner 및 AutoCompleteTextView라는 두 가지 다른 뷰를 사용하여 이 작업을 쉽게 실행할 수 있습니다. 그럼에도 불구하고, 콤보 상자에 대한 이러한 개념이 좋은 예입니다.

복합 구성요소를 만들려면 다음 단계를 따르세요.

  • Activity와 마찬가지로 선언적 (XML 기반) 접근 방식을 사용하여 포함된 구성요소를 만들거나 코드에서 프로그래매틱 방식으로 중첩합니다. 일반적인 시작점은 일종의 Layout이므로 Layout를 확장하는 클래스를 만듭니다. 콤보 상자의 경우 가로 방향의 LinearLayout를 사용할 수 있습니다. 내부에 다른 레이아웃을 중첩할 수 있으므로 복합 구성요소는 임의의 복잡성과 구조를 가질 수 있습니다.
  • 새 클래스의 생성자에서 슈퍼클래스가 예상하는 매개변수를 가져와서 먼저 슈퍼클래스 생성자에 전달합니다. 그런 다음 새 구성요소 내에서 사용할 다른 뷰를 설정할 수 있습니다. 여기에서 EditText 필드와 팝업 목록을 만듭니다. 생성자가 가져와서 사용할 수 있는 자체 속성과 매개변수를 XML에 도입할 수 있습니다.
  • 선택적으로 포함된 뷰가 생성할 수 있는 이벤트에 대한 리스너를 만듭니다. 일례로는 목록 항목이 선택되면 EditText의 콘텐츠를 업데이트하기 위한 목록 항목 클릭 리스너의 리스너 메서드가 있습니다.
  • 원하는 경우 접근자와 수정자를 사용하여 자체 속성을 만듭니다. 예를 들어 구성요소에서 초기에 EditText 값을 설정하고 필요할 때 콘텐츠를 쿼리하도록 합니다.
  • 필요한 경우 onDraw() 및 onMeasure()를 재정의합니다. 일반적으로 Layout를 확장할 때는 이 작업이 필요하지 않습니다. 레이아웃에 잘 작동하는 기본 동작이 있기 때문입니다.
  • 원하는 경우 onKeyDown()와 같은 다른 on 메서드를 재정의합니다. 예를 들어 특정 키를 탭할 때 콤보 상자의 팝업 목록에서 특정 기본값을 선택합니다.

Layout를 맞춤 컨트롤의 기본으로 사용하면 다음과 같은 장점이 있습니다.

  • 활동 화면과 마찬가지로 선언적 XML 파일을 사용하여 레이아웃을 지정하거나 프로그래매틱 방식으로 뷰를 만들고 코드의 레이아웃에 중첩할 수 있습니다.
  • onDraw() 및 onMeasure() 메서드와 기타 대부분의 on 메서드는 적절한 동작을 가지므로 재정의할 필요가 없습니다.
  • 임의의 복잡한 복합 뷰를 신속하게 생성하여 단일 구성요소인 것처럼 재사용할 수 있습니다.

기존 뷰 유형 수정

원하는 것과 유사한 구성요소가 있다면 그 구성요소를 확장하고 변경하려는 동작을 재정의할 수 있습니다. 완전히 맞춤설정된 구성요소로 할 수 있는 모든 작업을 할 수 있지만, View 계층 구조에서 좀 더 전문화된 클래스로 시작하면 원하는 작업을 무료로 실행하는 동작을 얻을 수 있습니다.

예를 들어 NotePad 샘플 앱은 Android 플랫폼 사용의 여러 측면을 보여줍니다. 그중에서 EditText 뷰를 확장하여 줄이 있는 메모장을 만드는 것입니다. 이는 완벽한 예가 아니며 이를 위한 API는 변경될 수 있지만 원칙을 보여줍니다.

Android 스튜디오로 메모장 샘플을 가져오거나 제공된 링크를 사용하여 소스를 살펴보세요. 특히 NoteEditor.java 파일에서 LinedEditText의 정의를 참고하세요.

다음은 이 파일에서 참고할 사항입니다.

  1. 정의

    클래스는 다음 행으로 정의됩니다.
    public static class LinedEditText extends EditText

    LinedEditText는 NoteEditor 활동 내에서 내부 클래스로 정의되지만 NoteEditor 클래스 외부에서 NoteEditor.LinedEditText로 액세스할 수 있도록 공개되어 있습니다.

    또한 LinedEditText는 static입니다. 즉, 상위 클래스의 데이터에 액세스할 수 있는 소위 '합성 메서드'를 생성하지 않습니다. 즉, NoteEditor와 밀접한 관련이 있는 것이 아니라 별도의 클래스로 동작합니다. 이렇게 하면 외부 클래스에서 상태에 액세스할 필요가 없는 경우 내부 클래스를 더 간단하게 만들 수 있습니다. 생성된 클래스를 작게 유지하고 다른 클래스에서 쉽게 사용할 수 있도록 합니다.

    LinedEditText는 이 경우에 맞춤설정할 뷰인 EditText를 확장합니다. 완료되면 새 클래스가 일반 EditText 뷰를 대체할 수 있습니다.

  2. 클래스 초기화

    항상 그렇듯이 슈퍼클래스가 먼저 호출됩니다. 기본 생성자는 아니지만 매개변수화된 생성자입니다. EditText는 XML 레이아웃 파일에서 확장될 때 이러한 매개변수로 만들어집니다. 따라서 생성자는 이를 가져와서 슈퍼클래스 생성자에도 전달해야 합니다.

  3. 재정의된 메서드

    이 예에서는 onDraw() 메서드만 재정의하지만 맞춤 구성요소를 직접 만들 때 다른 메서드를 재정의해야 할 수 있습니다.

    이 샘플의 경우 onDraw() 메서드를 재정의하면 EditText 뷰 캔버스에서 파란색 선을 칠할 수 있습니다. 캔버스는 재정의된 onDraw() 메서드에 전달됩니다. super.onDraw() 메서드는 메서드가 종료되기 전에 호출됩니다. 슈퍼클래스 메서드를 호출해야 합니다. 이 경우 포함할 선을 칠한 후 끝에서 호출하세요.

  4. 맞춤 구성요소

    이제 맞춤 구성요소가 준비되었습니다. 그렇다면 이 구성요소를 어떻게 사용할 수 있을까요? 메모장 예에서는 맞춤 구성요소가 선언적 레이아웃에서 직접 사용되므로 res/layout 폴더의 note_editor.xml를 살펴보세요.

    <view xmlns:android="http://schemas.android.com/apk/res/android"
    class="com.example.android.notepad.NoteEditor$LinedEditText"
    android:id="@+id/note"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="@android:color/transparent"
    android:padding="5dp"
    android:scrollbars="vertical"
    android:fadingEdge="vertical"
    android:gravity="top"
    android:textSize="22sp"
    android:capitalize="sentences"
/>

    맞춤 구성요소는 XML의 일반 뷰로 생성되며, 클래스는 전체 패키지를 사용하여 지정됩니다. 정의한 내부 클래스는 Java 프로그래밍 언어에서 내부 클래스를 참조하는 표준 방법인 NoteEditor$LinedEditText 표기법을 사용하여 참조됩니다.

    맞춤 뷰 구성요소가 내부 클래스로 정의되지 않은 경우 XML 요소 이름으로 뷰 구성요소를 선언하고 class 속성을 제외할 수 있습니다. 예를 들면 다음과 같습니다.

    <com.example.android.notepad.LinedEditText
  id="@+id/note"
  ... />

    LinedEditText 클래스는 이제 별도의 클래스 파일입니다. 클래스가 NoteEditor 클래스에 중첩되어 있으면 이 기법이 작동하지 않습니다.

    정의의 다른 속성과 매개변수는 맞춤 구성요소 생성자로 전달된 후 EditText 생성자로 전달되므로 EditText 뷰에 사용하는 것과 동일한 매개변수입니다. 자체 매개변수를 추가할 수도 있습니다.

커스텀 구성요소를 생성하는 것은 필요한 만큼만 복잡합니다.

더 정교한 구성요소는 더 많은 on 메서드를 재정의하고 자체 도우미 메서드를 도입하여 속성과 동작을 크게 맞춤설정할 수 있습니다. 유일한 한계는 상상력과 구성요소의 필요한 작업입니다.