Android Dev Summit, October 23-24: two days of technical content, directly from the Android team. Sign-up for livestream updates.

문자열 리소스

문자열 리소스는 옵션 사항인 텍스트 스타일 지정 및 서식 지정 기능과 함께 애플리케이션에 사용할 수 있는 텍스트 문자열을 제공합니다. 애플리케이션에 문자열을 제공할 수 있는 리소스 유형으로는 세 가지가 있습니다.

문자열
단일 문자열을 제공하는 XML 리소스입니다.
문자열 배열
문자열로 구성된 배열을 제공하는 XML 리소스입니다.
수량 문자열(복수형)
복수형 표시를 위해 여러 문자열을 포함하는 XML 리소스입니다.

모든 문자열은 몇 가지 스타일 지정 마크업 및 서식 지정 인수를 적용할 수 있습니다. 문자열의 스타일 및 서식을 지정하는 방법에 대한 자세한 내용은 서식 지정 및 스타일 지정 관련 섹션을 참조하세요.

문자열

애플리케이션 또는 다른 리소스(예:XML 출력)에서 참조할 수 있는 단일 문자열입니다.

참고: 문자열은 name 특성에 제공된 값(XML 파일의 이름이 아님)을 사용하여 참조되는 단순한 리소스입니다. 따라서 XML 파일의 단일 <resources> 요소 아래에 문자열 리소스를 다른 단순한 리소스와 결합할 수 있습니다.

파일 위치:
res/values/filename.xml
파일 이름은 무엇이든 가능합니다. <string> 요소의 name이 리소스 ID로 사용됩니다.
컴파일된 리소스 데이터 유형:
String에 대한 리소스 포인터입니다.
리소스 참조:
Java: R.string.string_name
XML: @string/string_name
구문:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string
        name="string_name"
        >text_string</string>
</resources>
요소:
<resources>
필수. 이는 루트 요소여야 합니다.

특성은 없습니다.

<string>
스타일 지정 태그를 포함할 수 있는 문자열입니다. 아포스트로피와 따옴표는 이스케이프 처리해야 합니다. 문자열에 적절한 스타일과 서식을 지정하는 방법에 대한 자세한 내용은 아래에 나와 있는 서식 지정 및 스타일 지정을 참조하세요.

특성:

name
문자열. 문자열의 이름입니다. 이 이름이 리소스 ID로 사용됩니다.
예:
res/values/strings.xml에 저장된 XML 파일:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="hello">Hello!</string>
</resources>

다음 레이아웃 XML은 뷰에 문자열을 적용합니다.

<TextView
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/hello" />

다음 애플리케이션 코드는 문자열을 검색합니다.

Kotlin

val string: String = getString(R.string.hello)

Java

String string = getString(R.string.hello);

getString(int) 또는 getText(int)를 사용하여 문자열을 검색할 수 있습니다. getText(int)는 문자열에 적용된 모든 서식 있는 텍스트 스타일을 유지합니다.

문자열 배열

애플리케이션에서 참조될 수 있는 문자열로 구성된 배열입니다.

참고: 문자열 배열은 name 특성에 제공된 값(XML 파일의 이름이 아님)을 사용하여 참조되는 단순한 리소스입니다. 따라서 XML 파일의 단일 <resources> 요소 아래에 문자열 배열 리소스를 다른 단순한 리소스와 결합할 수 있습니다.

파일 위치:
res/values/filename.xml
파일 이름은 무엇이든 가능합니다. <string-array> 요소의 name이 리소스 ID로 사용됩니다.
컴파일된 리소스 데이터 유형:
String 배열에 대한 리소스 포인터입니다.
리소스 참조:
Java: R.array.string_array_name
구문:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array
        name="string_array_name">
        <item
            >text_string</item>
    </string-array>
</resources>
요소:
<resources>
필수. 이는 루트 요소여야 합니다.

특성은 없습니다.

<string-array>
문자열로 구성된 배열을 정의합니다. 하나 이상의 <item> 요소를 포함합니다.

특성:

name
문자열. 배열의 이름입니다. 이 이름이 배열을 참조하기 위한 리소스 ID로 사용됩니다.
<item>
스타일 지정 태그를 포함할 수 있는 문자열입니다. 이 값은 다른 문자열 리소스에 대한 참조일 수 있습니다. <string-array> 요소의 하위 요소여야 합니다. 아포스트로피와 따옴표는 이스케이프 처리해야 합니다. 문자열에 적절한 스타일과 서식을 지정하는 방법에 대한 자세한 내용은 아래에 나와 있는 서식 지정 및 스타일 지정을 참조하세요.

특성은 없습니다.

예:
res/values/strings.xml에 저장된 XML 파일:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string-array name="planets_array">
        <item>Mercury</item>
        <item>Venus</item>
        <item>Earth</item>
        <item>Mars</item>
    </string-array>
</resources>

다음 애플리케이션 코드는 문자열 배열을 검색합니다.

Kotlin

val array: Array = resources.getStringArray(R.array.planets_array)

Java

Resources res = getResources();
String[] planets = res.getStringArray(R.array.planets_array);

수량 문자열(복수형)

각 언어는 수량과 관련한 문법적 일치에 대한 규칙이 각각 다릅니다. 예를 들어, 영어의 경우 수량 1은 특별한 케이스입니다. '1 book'이라고 쓰지만, 다른 수량은 'n books'라고 씁니다. 단수형과 복수형 간의 이러한 구별은 매우 일반적인 것이며, 다른 언어에서는 더 미세하게 구별하기도 합니다. Android에서 지원하는 전체 집합은 zero, one, two, few, manyother입니다.

지정된 언어 및 수량에 사용할 케이스를 결정하기 위한 규칙은 매우 복잡할 수 있으므로, Android는 적합한 리소스를 선택하는 getQuantityString()과 같은 메서드를 제공합니다.

예전부터 '수량 문자열'(그리고 API에서도 여전히 이렇게 부름)이라고 불렀지만 수량 문자열은 오직 복수형에만 사용되어야 합니다. 예를 들어 읽지 않은 메시지가 있는지 여부에 따라 표시되는 Gmail의 '받은 편지함' 및 '받은 편지함(12)'과 같은 항목을 구현하기 위해 수량 문자열을 사용하는 것은 올바르지 않을 수 있습니다. if 문 대신 수량 문자열을 사용하는 것이 편해 보일 수 있지만, 일부 언어(예: 중국어)의 경우 이러한 문법적 구분을 전혀 하지 않으므로 항상 other 문자열을 사용해야 합니다.

어느 문자열을 사용할지 선택할 때는 전적으로 문법적 필요성만을 근거로 해야 합니다. 영어의 경우 zero에 대한 문자열은 수량이 0인 경우에도 무시됩니다. 그 이유는 0이 2 또는 1을 제외한 다른 숫자와 문법적으로 다르지 않기 때문입니다('zero books', 'one book','two books' 등). 반대로 한국어의 경우 other 문자열 사용합니다.

two가 수량 2에만 적용될 수 있는 듯이 들리는 것에 현혹되지 마세요. 2, 12, 102(기타 등등)가 모두 서로 같게 취급되지만 다른 수량과 다르게 취급되도록 요구하는 언어가 있을 수 있습니다. 번역자에게 문의하여 언어에서 실제로 어떠한 구분이 필요한지 파악해야 합니다.

수량에 중립적인 표현(예:"Books: 1")을 사용하여 수량 문자열 사용을 피할 수 있는 경우가 많이 있습니다. 이것이 애플리케이션에 적합한 스타일이라면 개발자와 번역자 모두에게 편리합니다.

참고: 복수형 모음은 name 특성에 제공된 값(XML 파일의 이름이 아님)을 사용하여 참조되는 단순한 리소스입니다. 따라서 XML 파일의 단일 <resources> 요소 아래에 복수형 리소스를 다른 단순한 리소스와 결합할 수 있습니다.

파일 위치:
res/values/filename.xml
파일 이름은 무엇이든 가능합니다. <plurals> 요소의 name이 리소스 ID로 사용됩니다.
리소스 참조:
Java: R.plurals.plural_name
구문:
<?xml version="1.0" encoding="utf-8"?>
<resources>
    <plurals
        name="plural_name">
        <item
            quantity=["zero" | "one" | "two" | "few" | "many" | "other"]
            >text_string</item>
    </plurals>
</resources>
요소:
<resources>
필수. 이는 루트 요소여야 합니다.

특성은 없습니다.

<plurals>
문자열 모음이며, 수량에 따라 그중 특정 문자열이 제공됩니다. 하나 이상의 <item> 요소를 포함합니다.

특성:

name
문자열. 문자열 쌍의 이름입니다. 이 이름이 리소스 ID로 사용됩니다.
<item>
복수형 또는 단수형 문자열입니다. 이 값은 다른 문자열 리소스에 대한 참조일 수 있습니다. <plurals> 요소의 하위 요소여야 합니다. 아포스트로피와 따옴표는 이스케이프 처리해야 합니다. 문자열에 적절한 스타일과 서식을 지정하는 방법에 대한 자세한 내용은 아래에 나와 있는 서식 지정 및 스타일 지정을 참조하세요.

특성:

quantity
키워드. 이 문자열이 사용되는 시기를 나타내는 값입니다. 유효한 값(괄호 안에 일부 예가 포함되어 있음):
설명
zero언어가 숫자 0에 대한 특수한 처리를 요구하는 경우(예: 아랍어).
one언어가 1과 같은 숫자에 대한 특수한 처리를 요구하는 경우(예: 영어 및 기타 대부분 언어의 경우 숫자 1. 러시아어의 경우 1로 끝나지만 11로 끝나지 않는 숫자(이 클래스에 나와 있음)).
two언어가 2와 같은 숫자에 대한 특수한 처리를 요구하는 경우(예: 웨일스어의 경우 2 또는 슬로베니아어의 경우 102).
few언어가 '작은' 숫자에 대한 특수한 처리를 요구하는 경우(예: 체코어의 경우 2, 3, 4 또는 폴란드어의 경우 2, 3 또는 4로 끝나지만 12, 13 또는 14로 끝나지 않는 숫자).
many언어가 '큰' 숫자에 대한 특수한 처리를 요구하는 경우(예: 몰타어의 경우 11-99로 끝나는 숫자).
other언어가 지정된 수량에 대한 특수한 처리를 요구하는 경우(예: 중국어의 경우 모든 숫자 또는 영어의 경우 42).
예:
res/values/strings.xml에 저장된 XML 파일:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <plurals name="numberOfSongsAvailable">
        <!--
             As a developer, you should always supply "one" and "other"
             strings. Your translators will know which strings are actually
             needed for their language. Always include %d in "one" because
             translators will need to use %d for languages where "one"
             doesn't mean 1 (as explained above).
          -->
        <item quantity="one">%d song found.</item>
        <item quantity="other">%d songs found.</item>
    </plurals>
</resources>

res/values-pl/strings.xml에 저장된 XML 파일:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <plurals name="numberOfSongsAvailable">
        <item quantity="one">Znaleziono %d piosenkę.</item>
        <item quantity="few">Znaleziono %d piosenki.</item>
        <item quantity="other">Znaleziono %d piosenek.</item>
    </plurals>
</resources>

사용:

Kotlin

val count = getNumberOfSongsAvailable()
val songsFound = resources.getQuantityString(R.plurals.numberOfSongsAvailable, count, count)

Java

int count = getNumberOfSongsAvailable();
Resources res = getResources();
String songsFound = res.getQuantityString(R.plurals.numberOfSongsAvailable, count, count);

getQuantityString() 메서드를 사용할 때는 문자열에 숫자로 문자열 서식 지정이 포함된 경우 count를 두 번 전달해야 합니다. 예를 들어 문자열 %d songs found에 대해 첫 번째 count 매개변수는 적절한 복수형 문자열을 선택하고, 두 번째 count 매개변수는 %d 자리표시자에 삽입됩니다. 복수형 문자열에 문자열 서식 지정이 포함되어 있지 않은 경우에는 이 매개변수를 getQuantityString에 전달할 필요가 없습니다.

형식과 스타일

다음은 문자열 리소스에 올바른 서식 및 스타일을 지정하는 방법에 대해 알아야 할 몇 가지 중요 사항입니다.

특수 문자 처리

문자열에 XML 또는 Android에서 특별히 사용하는 문자가 포함되면 해당 문자는 이스케이프 처리를 해야 합니다. 어떤 문자는 앞에 역슬래시를 붙여서 이스케이프 처리를 하고 어떤 문자는 XML 이스케이프 처리가 필요합니다. 아포스트로피와 홑따옴표는 겹따옴표로 전체 문자열을 감싸서 처리할 수 있습니다. 아래는 몇 가지 예시입니다.

문자 이스케이프 형식
@ \@
? \?
< &lt;
& &amp;
홑따옴표(')

다음 중 아무것이나:

  • &apos;
  • \'
  • 겹따옴표로 전체 문자열 감싸기(예: "This'll work")
겹따옴표(")

다음 중 아무것이나:

  • &quot;
  • \"

단, 겹따옴표를 이스케이프 처리해야 합니다. 홑따옴표로 문자열을 감싸는 것으로는 처리되지 않습니다.

문자열 서식 지정

문자열의 서식을 지정해야 할 경우, 다음 예시와 같이 문자열 리소스에 서식 인수를 추가하여 지정할 수 있습니다.

<string name="welcome_messages">Hello, %1$s! You have %2$d new messages.</string>

이 예시는 서식 문자열에 두 개의 인수가 있습니다. %1$s는 문자열이고 %2$d는 10진수입니다. getString(int, Object...)을 호출하여 문자열의 서식을 지정해보겠습니다. 예를 들면 다음과 같습니다.

Kotlin

var text = getString(R.string.welcome_messages, username, mailCount)

Java

String text = getString(R.string.welcome_messages, username, mailCount);

HTML 마크업을 사용하여 스타일 지정

HTML 마크업을 사용하여 문자열에 스타일을 추가할 수 있습니다. 예를 들면 다음과 같습니다.

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <string name="welcome">Welcome to <b>Android</b>!</string>
</resources>

지원되는 HTML 요소:.

  • 굵은꼴: <b>, <em>
  • 기울임꼴: <i>, <cite>, <dfn>
  • 텍스트 25% 확대: <big>
  • 텍스트 20% 축소: <small>
  • 글꼴 속성 설정: <font face=”font_family“ color=”hex_color”>. 사용 가능한 글꼴 집합은 monospace, serif, sans_serif 등이 있습니다.
  • 고정 폭 글꼴 집합: <tt>
  • 취소선: <s>, <strike>, <del>
  • 밑줄: <u>
  • 위첨자: <sup>
  • 아래첨자: <sub>
  • 글 머리꼴: <ul>, <li>
  • 줄바꿈: <br>
  • 분할: <div>
  • CSS 스타일: <span style=”color|background_color|text-decoration”>
  • 문단: <p dir=”rtl | ltr” style=”…”>

서식을 적용하지 않을 경우 setText(java.lang.CharSequence)를 호출하여 직접 TextView 텍스트를 설정할 수 있습니다. 그러나 경우에 따라 서식 문자열로도 사용되는 스타일이 지정된 텍스트 리소스를 생성하고자 할 수 있습니다. 알반적으로는 format(String, Object...)getString(int, Object...) 메서드가 문자열에서 모든 스타일 정보를 제거하기 때문에 불가능합니다. 이에 대한 해결 방법은 이스케이프 처리된 항목을 사용하여 HTML 태그를 쓰는 것입니다. 그러면 서식 지정이 수행된 후 이 항목이 fromHtml(String)로 복구됩니다. 예를 들면 다음과 같습니다.

  1. 스타일이 지정된 텍스트 리소스를 HTML로 이스케이프 처리된 문자열로 저장합니다.
    <resources>
      <string name="welcome_messages">Hello, %1$s! You have &lt;b>%2$d new messages&lt;/b>.</string>
    </resources>
    

    이 서식이 지정된 문자열에 <b> 요소가 추가됩니다. 여는 괄호는 HTML에서 &lt; 표기법을 사용하여 이스케이프 처리됩니다.

  2. 그런 다음 평상시처럼 문자열의 서식을 지정하고 fromHtml(String)을 호출하여 이 HTML 텍스트를 스타일이 지정된 텍스트로 변환합니다.

    Kotlin

    val text: String = getString(R.string.welcome_messages, username, mailCount)
    val styledText: Spanned = Html.fromHtml(text, FROM_HTML_MODE_LEGACY)
    

    Java

    String text = getString(R.string.welcome_messages, username, mailCount);
    Spanned styledText = Html.fromHtml(text, FROM_HTML_MODE_LEGACY);
    

fromHtml(String) 메서드가 모든 HTML 항목의 서식을 지정하므로 htmlEncode(String)를 사용하여 서식이 지정된 텍스트에 사용할 문자열에서 모든 가능한 HTML 문자를 이스케이프 처리해야 합니다. 예를 들어, '<' 또는 '&'와 같은 문자를 포함한 문자열의 서식을 지정할 경우 서식을 지정하기 전에 이스케이프 처리해야 합니다. 그래야 fromHtml(String)을 통해 전달될 때 문자가 원래 쓰여진 방식대로 표시됩니다. 예를 들면 다음과 같습니다.

Kotlin

val escapedUsername: String = TextUtils.htmlEncode(username)

val text: String = getString(R.string.welcome_messages, escapedUsername, mailCount)
val styledText: Spanned = Html.fromHtml(text, FROM_HTML_MODE_LEGACY)

Java

String escapedUsername = TextUtils.htmlEncode(username);

String text = getString(R.string.welcome_messages, escapedUsername, mailCount);
Spanned styledText = Html.fromHtml(text);

Spannable을 사용한 스타일 지정

Spannable은 색상 및 글꼴 두께와 같은 서체 속성을 사용하여 스타일을 지정할 수 있는 텍스트 객체입니다. SpannableStringBuilder를 사용하여 텍스트를 빌드한 후 android.text.style 패키지에 정의된 스타일을 텍스트에 적용할 수 있습니다.

다음과 같은 도우미 메서드를 사용하여 스팬 가능한 텍스트를 생성하는 작업의 대부분을 설정할 수 있습니다.

Kotlin

/**
 * Returns a CharSequence that concatenates the specified array of CharSequence
 * objects and then applies a list of zero or more tags to the entire range.
 *
 * @param content an array of character sequences to apply a style to
 * @param tags the styled span objects to apply to the content
 *        such as android.text.style.StyleSpan
 */
private fun apply(content: Array<out CharSequence>, vararg tags: Any): CharSequence {
    return SpannableStringBuilder().apply {
        openTags(tags)
        content.forEach { charSequence ->
            append(charSequence)
        }
        closeTags(tags)
    }
}

/**
 * Iterates over an array of tags and applies them to the beginning of the specified
 * Spannable object so that future text appended to the text will have the styling
 * applied to it. Do not call this method directly.
 */
private fun Spannable.openTags(tags: Array<out Any>) {
    tags.forEach { tag ->
        setSpan(tag, 0, 0, Spannable.SPAN_MARK_MARK)
    }
}

/**
 * "Closes" the specified tags on a Spannable by updating the spans to be
 * endpoint-exclusive so that future text appended to the end will not take
 * on the same styling. Do not call this method directly.
 */
private fun Spannable.closeTags(tags: Array<out Any>) {
    tags.forEach { tag ->
    if (length > 0) {
            setSpan(tag, 0, length, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE)
        } else {
            removeSpan(tag)
        }
    }
}

Java

/**
 * Returns a CharSequence that concatenates the specified array of CharSequence
 * objects and then applies a list of zero or more tags to the entire range.
 *
 * @param content an array of character sequences to apply a style to
 * @param tags the styled span objects to apply to the content
 *        such as android.text.style.StyleSpan
 *
 */
private static CharSequence applyStyles(CharSequence[] content, Object[] tags) {
    SpannableStringBuilder text = new SpannableStringBuilder();
    openTags(text, tags);
    for (CharSequence item : content) {
        text.append(item);
    }
    closeTags(text, tags);
    return text;
}

/**
 * Iterates over an array of tags and applies them to the beginning of the specified
 * Spannable object so that future text appended to the text will have the styling
 * applied to it. Do not call this method directly.
 */
private static void openTags(Spannable text, Object[] tags) {
    for (Object tag : tags) {
        text.setSpan(tag, 0, 0, Spannable.SPAN_MARK_MARK);
    }
}

/**
 * "Closes" the specified tags on a Spannable by updating the spans to be
 * endpoint-exclusive so that future text appended to the end will not take
 * on the same styling. Do not call this method directly.
 */
private static void closeTags(Spannable text, Object[] tags) {
    int len = text.length();
    for (Object tag : tags) {
        if (len > 0) {
            text.setSpan(tag, 0, len, Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
        } else {
            text.removeSpan(tag);
        }
    }
}

다음의 bold, italic, color 메서드는 위의 도우미 메서드를 래핑하고 android.text.style 패키지에 정의된 스타일을 적용하는 구체적인 예시를 보여줍니다. 다른 유형의 텍스트 스타일 지정을 수행하는 유사한 메서드를 생성할 수 있습니다.

Kotlin

/**
 * Returns a CharSequence that applies boldface to the concatenation
 * of the specified CharSequence objects.
 */
fun bold(vararg content: CharSequence): CharSequence = apply(content, StyleSpan(Typeface.BOLD))

/**
 * Returns a CharSequence that applies italics to the concatenation
 * of the specified CharSequence objects.
 */
fun italic(vararg content: CharSequence): CharSequence = apply(content, StyleSpan(Typeface.ITALIC))

/**
 * Returns a CharSequence that applies a foreground color to the
 * concatenation of the specified CharSequence objects.
 */
fun color(color: Int, vararg content: CharSequence): CharSequence =
        apply(content, ForegroundColorSpan(color))

Java

/**
 * Returns a CharSequence that applies boldface to the concatenation
 * of the specified CharSequence objects.
 */
public static CharSequence bold(CharSequence... content) {
    return apply(content, new StyleSpan(Typeface.BOLD));
}

/**
 * Returns a CharSequence that applies italics to the concatenation
 * of the specified CharSequence objects.
 */
public static CharSequence italic(CharSequence... content) {
    return apply(content, new StyleSpan(Typeface.ITALIC));
}

/**
 * Returns a CharSequence that applies a foreground color to the
 * concatenation of the specified CharSequence objects.
 */
public static CharSequence color(int color, CharSequence... content) {
    return apply(content, new ForegroundColorSpan(color));
}

이 메서드를 함께 엮어서 다양한 스타일을 문구 내의 각 단어에 적용하는 방법의 예시는 다음과 같습니다.

Kotlin

// Create an italic "hello, " a red "world",
// and bold the entire sequence.
val text: CharSequence = bold(italic(getString(R.string.hello)),
        color(Color.RED, getString(R.string.world)))

Java

// Create an italic "hello, " a red "world",
// and bold the entire sequence.
var text = bold(italic(getString(R.string.hello)),
  color(Color.RED, getString(R.string.world)))
</pre>
</section><section><h3 id="java">Java</h3>
<pre class="prettyprint lang-java">
// Create an italic "hello, " a red "world",
// and bold the entire sequence.
CharSequence text = bold(italic(getString(R.string.hello)),
    color(Color.RED, getString(R.string.world)));

core-ktx Kotlin 모듈에도 스팬을 더욱 쉽게 처리할 수 있는 확장 기능이 포함되어 있습니다. 자세한 내용은 Github에서 android.text 패키지 문서를 참조하세요.

스팬을 처리하는 방법에 대한 자세한 내용은 다음 링크를 참조하세요.

주석으로 스타일 지정

strings.xml 리소스 파일에서 Annotation 클래스와 <annotation> 태그를 함께 사용하여 복잡한 스타일이나 사용자 지정 스타일을 지정할 수 있습니다. 주석 태그를 사용하면 XML 프레임워크에서 사용자 지정 키-값 쌍을 정의한 다음, Annotation 스팬으로 변환하여 사용자 지정 스타일을 지정할 문자열 부분을 표시할 수 있습니다. 그런 다음, 주석을 검색하고 키와 값을 이용해 스타일을 적용합니다.

주석을 작성할 때는 모든 string.xml 파일에 있는 문자열의 모든 번역문에 <annotation> 태그를 추가하세요.


모든 언어로 'text' 단어에 사용자 지정 서체 적용

예 - 사용자 지정 서체 추가

  1. <annotation> 태그를 추가하고 키-값 쌍을 정의합니다. 이 경우 키는 font이고 값은 사용할 글꼴 유형, 즉 title_emphasis입니다.

    // values/strings.xml
    <string name="title">Best practices for <annotation font="title_emphasis">text</annotation> on Android</string>
    
    // values-es/strings.xml
    <string name="title"><annotation font="title_emphasis">Texto</annotation> en Android: mejores prácticas</string>
    
  2. 문자열 리소스를 로드하고 font 키로 주석을 찾습니다. 그런 다음, 사용자 정의 스팬을 생성하고 기존 스팬을 대체합니다.

    Kotlin

    // get the text as SpannedString so we can get the spans attached to the text
    val titleText = getText(R.string.title) as SpannedString
    
    // get all the annotation spans from the text
    val annotations = titleText.getSpans(0, titleText.length, Annotation::class.java)
    
    // create a copy of the title text as a SpannableString.
    // the constructor copies both the text and the spans. so we can add and remove spans
    val spannableString = SpannableString(titleText)
    
    // iterate through all the annotation spans
    for (annotation in annotations) {
       // look for the span with the key font
       if (annotation.key == "font") {
          val fontName = annotation.value
          // check the value associated to the annotation key
          if (fontName == "title_emphasis") {
             // create the typeface
             val typeface = getFontCompat(R.font.permanent_marker)
             // set the span at the same indices as the annotation
             spannableString.setSpan(CustomTypefaceSpan(typeface),
                titleText.getSpanStart(annotation),
                titleText.getSpanEnd(annotation),
                Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)
          }
       }
    }
    
    // now, the spannableString contains both the annotation spans and the CustomTypefaceSpan
    styledText.text = spannableString
    

    Java

    // get the text as SpannedString so we can get the spans attached to the text
    SpannedString titleText = (SpannedString) getText(R.string.title_about);
    
    // get all the annotation spans from the text
    Annotation[] annotations = titleText.getSpans(0, titleText.length(), Annotation.class);
    
    // create a copy of the title text as a SpannableString.
    // the constructor copies both the text and the spans. so we can add and remove spans
    SpannableString spannableString = new SpannableString(titleText);
    
    // iterate through all the annotation spans
    for (Annotation annotation: annotations) {
      // look for the span with the key font
      if (annotation.getKey().equals("font")) {
        String fontName = annotation.getValue();
        // check the value associated to the annotation key
        if (fontName.equals("title_emphasis")) {
        // create the typeface
        Typeface typeface = ResourcesCompat.getFont(this, R.font.roboto_mono);
        // set the span at the same indices as the annotation
        spannableString.setSpan(new CustomTypefaceSpan(typeface),
          titleText.getSpanStart(annotation),
          titleText.getSpanEnd(annotation),
          Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
        }
      }
    }
    
    // now, the spannableString contains both the annotation spans and the CustomTypefaceSpan
    styledText.text = spannableString;
    

같은 텍스트를 여러 번 사용하는 경우, SpannableString 객체는 한 번만 생성한 다음 필요에 따라 재사용해야 잠재적인 성능 및 메모리 문제를 예방할 수 있습니다.

주석 사용에 대한 자세한 예시는 Android에서 국제화된 텍스트에 스타일 지정을 참조하세요.

주석 스팬 및 텍스트 파슬링

Annotation 스팬은 ParcelableSpans이기도 하기 때문에 키-값 쌍은 파슬링되기도 하고 파슬링을 해제하기도 합니다. 파슬을 수신하는 쪽이 주석을 해석하는 방법을 아는 경우 Annotation 스팬을 사용해서 파슬링된 텍스트에 사용자 지정 스타일을 적용할 수 있습니다.

텍스트를 인텐트 번들에 전달할 때 사용자 지정 스타일을 유지하려면 Annotation 스팬을 텍스트에 추가해야 합니다. 위의 예시와 같이 <annotation> 태그를 사용하여 XML 리소스에서 추가하거나 아래와 같이 새로운 Annotation을 생성하고 스팬으로 설정하여 코드에서 추가할 수 있습니다.

Kotlin

val spannableString = SpannableString("My spantastic text")
val annotation = Annotation("font", "title_emphasis")
spannableString.setSpan(annotation, 3, 7, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE)

// start Activity with text with spans
val intent = Intent(this, MainActivity::class.java)
intent.putExtra(TEXT_EXTRA, spannableString)
startActivity(intent)

Java

SpannableString spannableString = new SpannableString("My spantastic text");
Annotation annotation = new Annotation("font", "title_emphasis");
spannableString.setSpan(annotation, 3, 7, 33);

// start Activity with text with spans
Intent intent = new Intent(this, MainActivity.class);
intent.putExtra(TEXT_EXTRA, spannableString);
this.startActivity(intent);

Bundle에서 SpannableString로 텍스트를 검색한 다음, 위의 예시와 같이 첨부된 주석을 파싱합니다.

Kotlin

// read text with Spans
val intentCharSequence = intent.getCharSequenceExtra(TEXT_EXTRA) as SpannableString

Java

// read text with Spans
SpannableString intentCharSequence = (SpannableString)intent.getCharSequenceExtra(TEXT_EXTRA);

텍스트 스타일 지정에 대한 자세한 내용은 다음 링크를 참조하세요.