문자열 리소스

문자열 리소스를 사용하여 애플리케이션의 텍스트 문자열에 최적의 텍스트 스타일과 서식을 지정할 수 있습니다. 애플리케이션에 문자열을 제공할 수 있는 리소스 유형으로는 세 가지가 있습니다.

문자열
단일 문자열을 제공하는 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의 경우: @[package:]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<String> = resources.getStringArray(R.array.planets_array)

Java

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

수량 문자열(복수형)

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

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

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

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

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

메시지에 수량 번호가 포함되어 있지 않다면 복수형에 좋은 후보가 아닐 수 있습니다. 예를 들어 리투아니아어에서는 1과 101 모두에 단수형이 사용되므로 '1 book'은 '1 knyga'로 번역되고 '101 Books'는 '101 knyga'로 번역됩니다. 반면 'a book'은 'knyga'이고 'many books'는 'daug knygų'입니다. 영어 복수형 메시지에 'a book'(단수형)과 'many books'(복수형)가 포함되어 있지만 실제 숫자는 없는 경우 'knyga'(a book)/'daug knygų'(many books)로 번역될 수 있습니다. 리투아니아어 규칙에서는 숫자가 101이 되면 'knyga'(단일 책)로 표시됩니다.

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

API 24 이상에서는 훨씬 더 강력한 ICU MessageFormat 클래스를 대신 사용할 수 있습니다.

참고: 복수형 모음은 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에서 특수하게 사용되는 문자가 포함된 경우 표준 XML/HTML 이스케이프 규칙에 따라 해당 문자를 이스케이프 처리해야 합니다. Android에서 특별한 의미를 갖는 문자를 이스케이프 처리해야 하는 경우 앞에 백슬래시를 사용해야 합니다.

기본적으로 Android는 일련의 공백 문자를 단일 공백으로 축소합니다. 문자열에서 관련 부분을 큰따옴표로 묶어서 이를 방지할 수 있습니다. 이 경우 줄바꿈을 포함하여 모든 공백 문자가 따옴표로 묶인 영역 내에 유지됩니다. 큰따옴표를 사용하면 이스케이프되지 않은 일반 작은따옴표도 사용할 수 있습니다.

문자 이스케이프 형식
@ \@
? \?
줄바꿈 \n
\t
U+XXXX 유니코드 문자 \uXXXX
작은따옴표(')

다음 중 아무것이나:

  • \'
  • 전체 문자열을 큰따옴표로 묶습니다(예: "This'll work").
큰따옴표(") \"

문자열을 작은따옴표로 묶는 것은 작동하지 않습니다.

리소스 파일이 XML로 파싱된 후 공백 축소 및 Android 이스케이프가 발생합니다. 즉, <string> &#32; &#8200; &#8195;</string>(공백, 구두점 공백, 유니코드 Em 공백)은 파일이 XML로 파싱된 후 모두 유니코드 공백이기 때문에 모두 단일 공백(" ")으로 축소됩니다. 이러한 공백을 그대로 유지하려면 따옴표를 사용하거나(<string>" &#32; &#8200; &#8195;"</string>) Android 이스케이프(<string> \u0032 \u8200 \u8195</string>)를 사용하면 됩니다.

참고: XML 파서의 관점에서 <string>"Test this"</string><string>&quot;Test this&quot;</string> 사이에는 차이가 없습니다. 두 양식 모두 따옴표는 표시하지 않지만 Android 공백 유지 따옴표를 트리거합니다(이 경우 실질적인 효과는 없음).

문자열 서식 지정

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

<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>
  • 기울임꼴: <i>, <cite>, <dfn>, <em>
  • 텍스트 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.
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);
    
    // 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);

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