Android----SpannableString

1、背景介紹

在開發應用過程中經常會遇到顯示一些不同的字體風格的信息猶如默認的LockScreen上面的時間和充電信息。對於類似的情況，可能第一反應就是用不同的多個TextView來實現，對於每個TextView設置不同的字體風格以滿足需求。

這裡推薦的做法是使用android.text.*;和 android.text.style.*;下面的組件來實現RichText：也即在同一個TextView中設置不同的字體風格。對於某些應用，比如文本編輯，記事本，彩信，短信等地方，還必須使用這些組件才能達到想到的顯示效果。

主要的基本工具類有android.text.Spanned; android.text.SpannableString; android.text.SpannableStringBuilder;使用這些類來代替常規String。SpannableString和 SpannableStringBuilder可以用來設置不同的Span，這些Span便是用於實現Rich Text，比如粗體，斜體，前景色，背景色，字體大小，字體風格等等，android.text.style.*中定義了很多的Span類型可供使用。

這是相關的API的Class General Hierarchy：

因為Spannable等最終都實現了CharSequence接口，所以可以直接把SpannableString和SpannableStringBuilder通過TextView.setText()設置給TextView。

2、使用方法

當要顯示Rich Text信息的時候，可以使用創建一個SpannableString或SpannableStringBuilder，它們的區別在於 SpannableString像一個String一樣，構造對象的時候傳入一個String，之後再無法更改String的內容，也無法拼接多個 SpannableString；而SpannableStringBuilder則更像是StringBuilder，它可以通過其append()方法來拼接多個String：

SpannableString word = new SpannableString(The quick fox jumps over the lazy dog);
SpannableStringBuilder multiWord = new SpannableStringBuilder();
multiWord.append(The Quick Fox);
multiWord.append(jumps over);
multiWord.append(the lazy dog);

創建完Spannable對象後，就可以為它們設置Span來實現想要的Rich Text了，常見的Span有：

• AbsoluteSizeSpan(int size) ---- 設置字體大小，參數是絕對數值，相當於Word中的字體大小RelativeSizeSpan(float proportion) ---- 設置字體大小，參數是相對於默認字體大小的倍數，比如默認字體大小是x, 那麼設置後的字體大小就是x*proportion，這個用起來比較靈活，proportion>1就是放大(zoom in), proportion<1就是縮小(zoom out)
  ScaleXSpan(float proportion) ---- 縮放字體，與上面的類似，默認為1,設置後就是原來的乘以proportion，大於1時放大(zoon in)，小於時縮小(zoom out)BackgroundColorSpan(int color) ----背景著色，參數是顏色數值，可以直接使用android.graphics.Color裡面定義的常量，或是用Color.rgb(int, int, int)ForegroundColorSpan(int color) ----前景著色，也就是字的著色，參數與背景著色一致TypefaceSpan(String family) ----字體，參數是字體的名字比如“sans, sans-serif等StyleSpan(Typeface style) -----字體風格，比如粗體，斜體，參數是android.graphics.Typeface裡面定義的常量，如Typeface.BOLD，Typeface.ITALIC等等。StrikethroughSpan----如果設置了此風格，會有一條線從中間穿過所有的字，就像被劃掉一樣

  對於這些Sytle span在使用的時候通常只傳上面所說明的構造參數即可，不需要設置其他的屬性，如果需要的話，也可以對它們設置其他的屬性，詳情可以參見文檔。
  SpannableString和SpannableStringBuilder都有一個設置上述Span的方法：

  /**
   * Set the style span to Spannable, such as SpannableString or SpannableStringBuilder
   * @param what --- the style span, such as StyleSpan
   * @param start --- the starting index of characters to which the style span to apply
   * @param end --- the ending index of characters to which the style span to apply
   * @param flags --- the flag specified to control
   */
  setSpan(Object what, int start, int end, int flags);

  其中參數what是要設置的Style span，start和end則是標識String中Span的起始位置，而 flags是用於控制行為的，通常設置為0或Spanned中定義的常量，常用的有：

  • Spanned.SPAN_EXCLUSIVE_EXCLUSIVE --- 不包含兩端start和end所在的端點
    Spanned.SPAN_EXCLUSIVE_INCLUSIVE --- 不包含端start，但包含end所在的端點Spanned.SPAN_INCLUSIVE_EXCLUSIVE --- 包含兩端start，但不包含end所在的端點Spanned.SPAN_INCLUSIVE_INCLUSIVE--- 包含兩端start和end所在的端點

    這裡理解起來就好像數學中定義區間，開區間還是閉區間一樣的。還有許多其他的Flag，可以參考這裡。這裡要重點說明下關於參數0,有很多時候，如果設置了上述的參數，那麼Span會從start應用到Text結尾，而不是在start和end二者之間，這個時候就需要使用Flag 0。

    3、Linkify

    另外，也可以對通過TextView.setAutoLink(int)設置其Linkify屬性，其用處在於，TextView會自動檢查其內容，會識別出phone number, web address or email address，並標識為超鏈接，可點擊，點擊後便跳轉到相應的應用，如Dialer，Browser或Email。Linkify有幾個常用選項，更多的請參考文檔：

    • Linkify.EMAIL_ADDRESS -- 僅識別出TextView中的Email在址，標識為超鏈接，點擊後會跳到Email，發送郵件給此地址
      Linkify.PHONE_NUMBERS -- 僅識別出TextView中的電話號碼，標識為超鏈接，點擊後會跳到Dialer，Call這個號碼Linkify.WEB_URLS-- 僅識別出TextView中的網址，標識為超鏈接，點擊後會跳到Browser打開此URLLinkify.ALL -- 這個選項是識別出所有系統所支持的特殊Uri，然後做相應的操作

      4、權衡選擇

      個人認為軟件開發中最常見的問題不是某個技巧怎麼使用的問題，而是何時該使用何技巧的問題，因為實現同一個目標可能有N種不同的方法，就要權衡利弊，選擇最合適的一個，正如常言所雲，沒有最好的，只有最適合的。如前面所討論的，要想用不同的字體展現不同的信息可能的解法，除了用Style Span外還可以用多個TextView。那麼就需要總結下什麼時候該使用StyleSpan，什麼時候該使用多個TextView：

      1. 1. 如果顯示的是多個不同類別的信息，就應該使用多個TextView，這樣也方便控制和改變各自的信息，例子就是默認LockScreen上面的日期和充電信息，因為它們所承載不同的信息，所以應該使用多個TextView來分別呈現。如果顯示的是同一類信息，或者同一個信息，那麼應該使用StyleSpan。比如，短信息中，要把聯系人的相關信息突出顯示；或是想要Highlight某些信息等。如果要實現Rich text，沒辦法，只能使用Style span。如果要實現某些特效，也可以考慮使用StyleSpan。設置不同的字體風格只是Style span的初級應用，如果深入研究，可以發現很多奇妙的功效。

            Spannable與ImageSapn結合使用可實現在EditText中實現圖文混排的效果

             

            下面是一些實例代碼

            1. /**
            2. * 超鏈接
            3. */
            4. private void addUrlSpan() {
            5. SpannableString spanString = new SpannableString(超鏈接);
            6. URLSpan span = new URLSpan(tel:0123456789);
            7. spanString.setSpan(span, 0, 3, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
            8. tv.append(spanString);
            9. }
            10.  
            11.  
            12. /**
            13. * 文字背景顏色
            14. */
            15. private void addBackColorSpan() {
            16. SpannableString spanString = new SpannableString(顏色2);
            17. BackgroundColorSpan span = new BackgroundColorSpan(Color.YELLOW);
            18. spanString.setSpan(span, 0, 3, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
            19. tv.append(spanString);
            20. }
            21.  
            22.  
            23. /**
            24. * 文字顏色
            25. */
            26. private void addForeColorSpan() {
            27. SpannableString spanString = new SpannableString(顏色1);
            28. ForegroundColorSpan span = new ForegroundColorSpan(Color.BLUE);
            29. spanString.setSpan(span, 0, 3, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
            30. tv.append(spanString);
            31. }
            32.  
            33.  
            34. /**
            35. * 字體大小
            36. */
            37. private void addFontSpan() {
            38. SpannableString spanString = new SpannableString(36號字體);
            39. AbsoluteSizeSpan span = new AbsoluteSizeSpan(36);
            40. spanString.setSpan(span, 0, 5, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
            41. tv.append(spanString);
            42. }
            43.  
            44.  
            45. /**
            46. * 粗體，斜體
            47. */
            48. private void addStyleSpan() {
            49. SpannableString spanString = new SpannableString(BIBI);
            50. StyleSpan span = new StyleSpan(Typeface.BOLD_ITALIC);
            51. spanString.setSpan(span, 0, 2, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
            52. tv.append(spanString);
            53. }
            54.  
            55.  
            56. /**
            57. * 刪除線
            58. */
            59. private void addStrikeSpan() {
            60. SpannableString spanString = new SpannableString(刪除線);
            61. StrikethroughSpan span = new StrikethroughSpan();
            62. spanString.setSpan(span, 0, 3, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
            63. tv.append(spanString);
            64. }
            65.  
            66. /**
            67. * 下劃線
            68. */
            69. private void addUnderLineSpan() {
            70. SpannableString spanString = new SpannableString(下劃線);
            71. UnderlineSpan span = new UnderlineSpan();
            72. spanString.setSpan(span, 0, 3, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
            73. tv.append(spanString);
            74. }
            75.  
            76.  
            77.  
            78. /**
            79. * 圖片
            80. */
            81. private void addImageSpan() {
            82. SpannableString spanString = new SpannableString( );
            83. Drawable d = getResources().getDrawable(R.drawable.ic_launcher);
            84. d.setBounds(0, 0, d.getIntrinsicWidth(), d.getIntrinsicHeight());
            85. ImageSpan span = new ImageSpan(d, ImageSpan.ALIGN_BASELINE);
            86. spanString.setSpan(span, 0, 1, Spannable.SPAN_EXCLUSIVE_EXCLUSIVE);
            87. tv.append(spanString);
            88. }
            89. }