맞춤 뷰 구성요소 만들기

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() 메서드는 Canvas를 제공하는데, 이를 통해 2D 그래픽, 기타 표준 또는 맞춤 구성요소, 스타일이 지정된 텍스트는 물론 상상할 수 있는 어떤 것이든 구현할 수 있습니다.

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를 확장할 때는 일반적으로 필요하지 않습니다.
  • 선택적으로 다른 on 메서드(예: onKeyDown())를 재정의하여 특정 키를 탭했을 때 콤보 상자의 팝업 목록에서 특정 기본값을 선택할 수 있습니다.

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

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

기존 보기 유형 수정

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

예를 들어 메모장 샘플 앱은 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의 일반 뷰로 생성되며, 클래스는 전체 패키지를 사용하여 지정됩니다. 정의한 내부 클래스는 자바 프로그래밍 언어에서 내부 클래스를 참조하는 표준 방법인 NoteEditor$LinedEditText 표기법을 사용하여 참조됩니다.

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

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

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

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

맞춤 구성요소는 필요에 따라 단순하거나 복잡하게 만들 수 있습니다.

좀 더 정교한 구성요소에서는 더 많은 on 메서드를 재정의하고 자체 도우미 메서드를 도입하여 속성과 동작을 실제로 맞춤설정할 수 있습니다. 별다른 제약 없이 원하는 대로 마음껏 구성요소를 맞춤설정할 수 있습니다.