字符串资源为您的应用程序提供文本字符串，并可选地进行文本样式和格式设置。有三种类型的资源可以为您的应用程序提供字符串
所有字符串都可以应用一些样式标记和格式参数。有关样式和格式化字符串的信息，请参阅关于格式和样式的部分。
字符串
可以从应用程序或其他资源文件（例如 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>
- 元素
- 示例
- 保存在
res/values/strings.xml的 XML 文件<?xml version="1.0" encoding="utf-8"?> <resources> <string name="hello">Hello!</string> </resources>
此布局 XML 将字符串应用于 View
<TextView android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@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>
- 元素
- 示例
- 保存在
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 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”（一本书）/“daug knygų”（许多书），但是根据立陶宛语规则，当数字恰好为 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>
- 元素
- 示例
- 保存在
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 Unicode 字符 | \uXXXX |
单引号 (') |
以下任何一种
|
双引号 (") |
\"
请注意，用单引号包围字符串不起作用。 |
空格折叠和 Android 转义发生在您的资源文件作为 XML 解析之后。这意味着 <string>      </string>（空格、标点空格、Unicode em 空格）都折叠成单个空格 (" ")，因为它们在文件作为 XML 解析后都是 Unicode 空格。要保留这些空格的原样，您可以对它们加引号 (<string>"      "</string>) 或使用 Android 转义 (<string> \u0032 \u8200 \u8195</string>)。
注意：从 XML 解析器的角度来看，<string>"Test this"</string> 和 <string>"Test this"</string> 之间没有任何区别。这两种形式都不会显示任何引号，但会触发 Android 空格保留引号（在这种情况下没有任何实际效果）。
格式化字符串
如果需要格式化字符串，则可以通过将格式参数放入字符串资源中来实现，如下面的示例资源所示。
<string name="welcome_messages">Hello, %1$s! You have %2$d new messages.</string>
在此示例中，格式字符串有两个参数：%1$s 是一个字符串，%2$d 是一个十进制数字。然后，通过调用 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) 恢复这些标记。例如
- 将样式化文本资源存储为 HTML 转义字符串
<resources> <string name="welcome_messages">Hello, %1$s! You have <b>%2$d new messages</b>.</string> </resources>
在此格式化字符串中，添加了
<b>元素。请注意，左括号是使用<符号进行 HTML 转义的。 - 然后像往常一样格式化字符串，还可以调用
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 模块还包含扩展函数，使使用 span 更加容易。您可以查看GitHub 上的android.text包文档以了解更多信息。
有关使用 span 的更多信息，请参阅以下链接
使用注释进行样式设置
您可以使用Annotation类以及strings.xml资源文件中的<annotation>标签来应用复杂或自定义样式。注释标签允许您通过在XML中定义自定义键值对来标记字符串的某些部分以进行自定义样式设置，框架随后将这些键值对转换为Annotation span。然后，您可以检索这些注释并使用键和值来应用样式。
创建注释时，请确保将<annotation>标签添加到每个strings.xml文件中字符串的所有翻译。
将自定义字体应用于所有语言中的“text”一词
示例 - 添加自定义字体
-
添加
<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>
-
加载字符串资源并查找带有font键的注释。然后创建自定义 span 并替换现有 span。
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 中设置国际化文本样式
注释 span 和文本打包
因为Annotation span 也是ParcelableSpans，所以键值对会被打包和解包。只要数据包的接收者知道如何解释注释，您就可以使用Annotation span 来将自定义样式应用于打包的文本。
要在将文本传递给 Intent Bundle 时保留自定义样式，您首先需要将Annotation span 添加到您的文本中。您可以通过上面的示例中的<annotation>标签在 XML 资源中执行此操作，也可以通过创建新的Annotation并将其设置为 span 来在代码中执行此操作，如下所示
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);
有关文本样式设置的更多信息，请参阅以下链接