字串資源提供應用程式所使用的文字字串,並可選擇文字樣式和格式。有三種類型的資源可為應用程式提供字串:
所有字串都可以套用樣式標記和格式化引數。如需樣式和格式化字串的相關資訊,請參閱「格式化和樣式」。
字串
可從應用程式或從其他資源檔案參照的單一字串 (例如: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>
- 元素:
- 例如:
- XML 檔案儲存在
res/values/strings.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" />
此應用程式程式碼會擷取字串:
您可以使用
getString(int)或getText(int)擷取字串。getText(int)會保留任何套用至字串的 RTF 格式樣式。
字串陣列
可從應用程式參照的字串陣列。
注意:字串陣列是一種使用 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>
- 元素:
- 例如:
- XML 檔案儲存在
res/values/strings.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 的「Inbox」(收件匣) 與有未讀郵件時顯示的「Inbox (12)」這類的項目。使用數量字串而不是 if 聲明,也許看起來很方便,但一定要注意的一點是某些語言 (例如中文) 就完全沒有單複數的文法差別,因此一律會取得 other 字串。
選擇要使用的字串時,這完全是根據文法的「必要性」而決定。對英文來說,即使數量為 0,也會忽略 zero 的字串,這是因為 0 與 2,或是任何其他除了 1 以外的數字並沒有文法上的差異 (「Zero Books」、「One Book」、「Two Books」等等)。反之,在韓文中,「只會」用到 other 字串。
不過,別誤以為 two 只能套用至數量為 2 的情況:在某種語言中,有可能必須將 2、12、102 等數量視為同一種情況,並採取與其他數量不同的處理方式。如要瞭解語言規則的差異,請諮詢翻譯人員。
如果訊息中不含數量,就可能不適合使用複數。以立陶宛語為例,1 和 101 都使用單數形式,因此「1 本書」會翻譯為「1 knyga」,「101 本書」會翻譯為「101 knyga」。而「一本書」是「knyga」,「許多本書」則是「daug knygų」。如果英文複數訊息包含「一本書」(單數) 和「許多本書」(複數),但卻沒有實際數字,則可以翻譯為「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>
- 元素:
- 例如:
- XML 檔案儲存在
res/values/strings.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>
XML 檔案儲存在
res/values-pl/strings.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參數會選取適當的複數字串,並在%d預留位置插入第二個count參數。如果複數字串不包含字串格式,則不需要傳遞第三個參數至getQuantityString。
格式與樣式
以下是有關正確設定字串資源格式和樣是的幾點重要注意事項。
處理特殊字元
如果字串包含 XML 中有特殊用途的字元,您就必須根據標準 XML/HTML 逸出規則逸出字元。如果需要逸出 Android 中具有特殊意義的字元,則應於前面加上反斜線。
根據預設,Android 會將空白字元的序列收合在單一空格中。使用雙引號括住字串的相關部分,就可以避免出現此情況。在這種情況下,所有空白字元 (包括換行符號) 都會保留在引號內的區域中。雙引號也可讓您使用一般的單一未逸出引號。
| 字元 | 逸出形式 |
|---|---|
| @ | \@ |
| ? | \? |
| 換行 | \n |
| Tab 鍵 | \t |
| U+XXXX 萬國碼 (Unicode) 字元 | \uXXXX |
單引號 (') |
下列任何項目:
|
雙引號 (") |
\"
請注意,使用單引號括住字串並沒有效果。 |
以 XML 剖析資源檔案後,就會收合空白字元,且 Android 會逸出。也就是說,<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。 - 設定