UI之可折疊的TextView

wxjiang 7年前發布 | 16K 次閱讀 TextView Android開發 移動開發

先上效果

一、思路

1. 計算text的行數

實現可折疊的TextView最重要的一點是在setText()前計算出text所需的行數

計算行數需要分為兩種情況

1.1 沒有換行符的text

行數等于text的寬度除于TextView的寬度再加上text的寬度對TextView的寬度取余
    lines = textWidth / TextViewWidth + textWidth % TextViewWidth

1.2 含有換行符的text

1. 先用換行符拆分

2. 對于拆分后的文本
    如果不為空,則然后再按照沒有換行符的方式計算   
    如果為空,則行數為1
3. 累加所有的拆分文本行數</code></pre> 

2. 截取text

計算出text的行數之后,需要對text進行截取,截取到text能在指定的行數內顯示完的位置,

  1. 首先用換行符對text進行拆分,將text分為若干段落
  2. 對拆分后的文本段落循環計算行數累加,并累加字符數
  3. 累加的行數小于指定行數,繼續循環,直到累加的行數大于指定行數或循環完成;如果在循環完成之前累加的行數大于指定行數,則截取該次循環的段落
  4. 調用 TextUtils 的ellipsize()方法對指定的段落進行截取,ellipsize()方法中的avail參數,傳入剩余的可顯示寬度

    因為在文本的最后要拼接上“...提示文本”,所以可顯寬度的計算方式如下:

    TextViewWidth * (指定行數 - 累加行數) - (... + 提示文本)Width
    1. 把截取后的文本設置給TextView

二、實現

實現可折疊的TextView需要繼承TextView并重寫setText(CharSequence text, BufferType type)方法

因為setText(CharSequence text)方法是final的,并且setText(CharSequence text)最終調用的也是setText(CharSequence text, BufferType type)方法,所以重寫后者即可。

核心代碼

/**
 * 末尾省略號
 */
private static final String ELLIPSE = "...";
/**
 * 默認的折疊行數
 */
public static final int COLLAPSED_LINES = 4;
/**
 * 折疊時的默認文本
 */
private static final String EXPANDED_TEXT = "展開全文";
/**
 * 展開時的默認文本
 */
private static final String COLLAPSED_TEXT = "收起全文";
/**
 * 在文本末尾
 */
public static final int END = 0;
/**
 * 在文本下方
 */
public static final int BOTTOM = 1;
/**
 * 提示文字展示的位置
 */
@IntDef({END, BOTTOM})
@Retention(RetentionPolicy.SOURCE)
public @interface TipsGravityMode {}
/**
 * 折疊的行數
 */
private int mCollapsedLines;
/**
 * 折疊時的文本
 */
private String mExpandedText;
/**
 * 展開時的文本
 */
private String mCollapsedText;
/**
 * 折疊時的圖片資源
 */
private Drawable mExpandedDrawabl
/**
 * 展開時的圖片資源
 */
private Drawable mCollapsedDrawab
/**
 * 原始的文本
 */
private CharSequence mOriginalTex
/**
 * TextView中文字可顯示的寬度
 */
private int mShowWidth;
/**
 * 是否是展開的
 */
private boolean mIsExpanded;
/**
 * 提示文字位置
 */
private int mTipsGravity;
/**
 * 提示文字顏色
 */
private int mTipsColor;
/**
 * 提示文字是否顯示下劃線
 */
private boolean mTipsUnderline;
/**
 * 提示是否可點擊
 */
private boolean mTipsClickable;

... 

@Override
public void setText(CharSequence text, final BufferType type) {
    // 如果text為空或mCollapsedLines為0則直接顯示
    if (TextUtils.isEmpty(text) || mCollapsedLines == 0) {
        super.setText(text, type);
    } else if (mIsExpanded) {
        // 保存原始文本,去掉文本末尾的空字符
        this.mOriginalText = CharUtil.trimFrom(text);
        formatExpandedText(type);
    } else {
        // 保存原始文本,去掉文本末尾的空字符
        this.mOriginalText = CharUtil.trimFrom(text);
        // 獲取TextView中文字顯示的寬度,需要在layout之后才能獲取到,避免在列表中重復獲取
        if (mCollapsedLines > 0 && mShowWidth == 0) {
            getViewTreeObserver().addOnGlobalLayoutListener(new ViewTreeObserver.OnGlobalLayoutListener() {
                @Override
                public void onGlobalLayout() {
                    getViewTreeObserver().removeOnGlobalLayoutListener(this);
                    mShowWidth = getWidth() - getPaddingLeft() - getPaddingRight();
                    formatCollapsedText(type);
                }
            });
        } else {
            formatCollapsedText(type);
        }
    }
}

/**
 * 格式化折疊時的文本
 *
 * @param type ref android.R.styleable#TextView_bufferType
 */
private void formatCollapsedText(BufferType type) {
    // 將原始文本按換行符拆分成段落
    String[] paragraphs = mOriginalText.toString().split("\\n");
    // 獲取paint,用于計算文字寬度
    TextPaint paint = getPaint();
    // 文字寬度
    float textWidth;
    // 字符數,用于最后截取字符串
    int charCount = 0;
    // 剩余行數
    int lastLines = mCollapsedLines;
    for (int i = 0; i < paragraphs.length; i++) {
        // 每個段落
        String paragraph = paragraphs[i];
        // 每個段落文本的寬度
        textWidth = paint.measureText(paragraph);
        // 計算每段的行數
        int paragraphLines = (int) (textWidth / mShowWidth);
        // 如果該段為空(表示空行)或還有余,多加一行
        if (TextUtils.isEmpty(paragraph) || textWidth % mShowWidth != 0) {
            paragraphLines++;
        }
        if (paragraphLines < lastLines) {
            // 如果該段落行數小于等于剩余的行數,則減少lastLines,并增加字符數
            // 這里只計算字符數,并不拼接字符
            charCount += paragraph.length() + 1;
            lastLines -= paragraphLines;
            if (i == paragraphs.length - 1) {
                super.setText(mOriginalText, type);
                break;
            }
        } else if (paragraphLines == lastLines && i == paragraphs.length - 1) {
            // 如果該段落行數等于剩余行數,并且是最后一個段落,表示剛好能夠顯示完全
            super.setText(mOriginalText, type);
            break;
        } else {
            // 如果該段落的行數大于等于剩余的行數,則格式化文本
            // 因設置的文本可能是帶有樣式的文本,如SpannableStringBuilder,所以根據計算的字符數從原始文本中截取
            SpannableStringBuilder spannable = new SpannableStringBuilder(mOriginalText, 0, charCount);
            // 計算后綴的寬度,因樣式的問題對后綴的寬度乘2
            int expandedTextWidth = 2 * (int) (paint.measureText(ELLIPSE + mExpandedText));
            // 獲取最后一段的文本,還是因為原始文本的樣式原因不能直接使用paragraphs中的文本
            CharSequence lastParagraph = mOriginalText.subSequence(charCount, charCount + paragraph.length());
            // 對最后一段文本進行截取
            CharSequence ellipsizeText = TextUtils.ellipsize(lastParagraph, paint,
                    mShowWidth * lastLines - expandedTextWidth, TextUtils.TruncateAt.END);
            spannable.append(ellipsizeText);
            // 如果lastParagraph == ellipsizeText表示最后一段文本在可顯示范圍內,此時需要手動加上"..."
            // 如果lastParagraph != ellipsizeText表示進行了截取TextUtils.ellipsize()方法會自動加上"..."
            if (lastParagraph == ellipsizeText) {
                spannable.append(ELLIPSE);
            }
            // 設置樣式
            setSpan(spannable);
            // 使點擊有效
            setMovementMethod(LinkMovementMethod.getInstance());
            super.setText(spannable, type);
            break;
        }
    }
}

/**
 * 格式化展開式的文本,直接在后面拼接即可
 *
 * @param type
 */
private void formatExpandedText(BufferType type) {
    SpannableStringBuilder spannable = new SpannableStringBuilder(mOriginalText);
    setSpan(spannable);
    super.setText(spannable, type);
}

/**
 * 設置提示的樣式
 *
 * @param spannable 需修改樣式的文本
 */
private void setSpan(SpannableStringBuilder spannable) {
    Drawable drawable;
    // 根據提示文本需要展示的文字拼接不同的字符
    if (mTipsGravity == END) {
        spannable.append(" ");
    } else {
        spannable.append("\n");
    }
    int tipsLen;
    // 判斷是展開還是收起
    if (mIsExpanded) {
        spannable.append(mCollapsedText);
        drawable = mCollapsedDrawable;
        tipsLen = mCollapsedText.length();
    } else {
        spannable.append(mExpandedText);
        drawable = mExpandedDrawable;
        tipsLen = mExpandedText.length();
    }
    // 設置點擊事件
    spannable.setSpan(new ExpandedClickableSpan(), spannable.length() - tipsLen,
            spannable.length(), Spanned.SPAN_INCLUSIVE_EXCLUSIVE);
    // 如果提示的圖片資源不為空,則使用圖片代替提示文本
    if (drawable != null) {
        spannable.setSpan(new ImageSpan(drawable, ImageSpan.ALIGN_BASELINE),
                spannable.length() - tipsLen, spannable.length(), Spanned.SPAN_INCLUSIVE_EXCLUSIVE);
    }
}

/**
 * 提示的點擊事件
 */
private class ExpandedClickableSpan extends ClickableSpan {
    @Override
    public void onClick(View widget) {
        // 是否可點擊
        if (mTipsClickable) {
            mIsExpanded = !mIsExpanded;
            setText(mOriginalText);
        }
    }
    @Override
    public void updateDrawState(TextPaint ds) {
        // 設置提示文本的顏色和是否需要下劃線
        ds.setColor(mTipsColor == 0 ? ds.linkColor : mTipsColor);
        ds.setUnderlineText(mTipsUnderline);
    }
}

因為用戶設置給TextView的文本可能是含有樣式的文本,即實現了Spannable接口的文本,所以在拆分并拼接文本的時候不能直接使用拆分后的字符串,會丟失原有樣式,需要重新在原始文本中截取

 本文由用戶 wxjiang 自行上傳分享,僅供網友學習交流。所有權歸原作者,若您的權利被侵害,請聯系管理員。
 轉載本站原創文章,請注明出處,并保留原始鏈接、圖片水印。
 本站是一個以用戶分享為主的開源技術平臺,歡迎各類分享!