안드로이드에서 마키(Marquee) 스크롤 텍스트 구현하는 방법

이 예제는 안드로이드에서 마키(Marquee) 효과가 적용된 스크롤 텍스트를 만드는 방법을 보여줍니다. 마키란 긴 텍스트가 화면에서 좌우로 흐르듯 자동으로 스크롤되는 애니메이션 효과를 말하며, 전광판처럼 공지사항이나 긴 문구를 한 줄로 표시할 때 유용하게 사용됩니다.

1단계: 새 프로젝트 생성

Android Studio를 실행하고 File → New Project 메뉴로 이동한 후, 새 프로젝트 생성에 필요한 모든 세부 정보를 입력하여 프로젝트를 만듭니다.

2단계: 레이아웃 XML 작성

res/layout/activity_main.xml 파일에 아래 코드를 추가합니다.

<?xml version = "1.0" encoding = "utf-8"?>
<RelativeLayout
    xmlns:android = "https://schemas.android.com/apk/res/android"
    xmlns:tools = "https://schemas.android.com/tools"
    android:layout_width = "match_parent"
    android:gravity = "center"
    android:layout_height = "match_parent">
    <TextView
        android:id = "@+id/text"
        android:textSize = "20dp"
        android:textAlignment = "center"
        android:layout_width = "match_parent"
        android:ellipsize = "marquee"
        android:fadingEdge = "horizontal"
        android:marqueeRepeatLimit = "marquee_forever"
        android:scrollHorizontally = "true"
        android:textColor = "#ff4500"
        android:text = "Simple application that shows how to use marquee, with a long text"
        android:layout_height = "wrap_content"
        android:singleLine = "true" />
</RelativeLayout>

위 코드의 핵심은 TextView에 마키 관련 속성들을 설정한 부분입니다. 각 속성의 역할은 다음과 같습니다.

android:ellipsize = "marquee"
android:fadingEdge = "horizontal"
android:marqueeRepeatLimit = "marquee_forever"
android:scrollHorizontally = "true"
android:singleLine = "true"

ellipsize="marquee": 텍스트가 잘릴 때 마키 애니메이션을 적용합니다.
fadingEdge="horizontal": 가로 방향으로 텍스트가 부드럽게 사라지는 페이드 효과를 추가합니다.
marqueeRepeatLimit="marquee_forever": 스크롤을 무한 반복하도록 설정합니다.
scrollHorizontally="true": 가로 방향 스크롤을 허용합니다.
singleLine="true": 텍스트를 한 줄로 제한하여 마키 효과가 동작하도록 합니다.

3단계: MainActivity 코드 작성

src/MainActivity.java 파일에 아래 코드를 추가합니다.

package com.example.andy.myapplication;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.widget.TextView;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        TextView txt = findViewById(R.id.text);
        txt.setSelected(true);
    }
}

여기서 가장 중요한 부분은 txt.setSelected(true)입니다. 안드로이드의 마키 효과는 뷰가 선택(selected) 상태일 때만 동작하기 때문에, 반드시 이 코드를 호출해야 텍스트가 스크롤됩니다.

실행 결과 확인

애플리케이션을 실행해 보겠습니다. 실제 안드로이드 기기가 컴퓨터에 연결되어 있다고 가정합니다. Android Studio에서 프로젝트의 액티비티 파일 중 하나를 열고 툴바의 Run 아이콘을 클릭하세요. 목록에서 본인의 모바일 기기를 선택하면, 기기 화면에 다음과 같은 결과가 표시됩니다.

안드로이드에서 마키(Marquee) 스크롤 텍스트 구현하는 방법

위 결과에서 볼 수 있듯이, TextView의 텍스트가 오른쪽에서 왼쪽으로 부드러운 스크롤 애니메이션과 함께 흐르는 것을 확인할 수 있습니다. 이처럼 몇 가지 XML 속성과 setSelected(true) 호출만으로도 전광판 스타일의 마키 텍스트를 손쉽게 구현할 수 있습니다.