如何设置Android TextView文本换行？

一、TextView的基本属性

TextView是Android中常用的控件之一，用于显示文本内容。在默认情况下，TextView的文本内容需要手动添加换行符才能换行显示。但是，TextView本身提供了一些属性可以帮助我们实现文本的换行显示。

1.单行显示
设置TextView的 android:singleLine属性为true可以使其显示单行的文本内容。当文本内容超过一行时，只会显示一部分并以省略号代替剩余文本。

    <TextView
        android:id="@+id/tv_single_line"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="This is a single line textview"
        android:singleLine="true"
        />

2.行数限制
设置TextView的android:lines属性可以限制文本的行数，当文本内容超过指定的行数时，只会显示一部分并以省略号代替剩余文本。

    <TextView
        android:id="@+id/tv_lines_limit"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="This is a textview with limited lines"
        android:lines="2"
        />

3.自动换行
设置TextView的android:ellipsize属性为none，android:singleLine属性为false可以实现自动换行的效果。当文本内容超过一行时，会自动换行显示。

    <TextView
        android:id="@+id/tv_auto_wrap"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="This is a textview with automatic line wrapping"
        android:singleLine="false"
        android:ellipsize="none"
        />

二、使用XML实现文本换行

除了通过设置属性实现文本换行，我们还可以在XML布局文件中使用一些标签来实现文本显示的换行和格式化。下面介绍三种方式。

1.使用\n
在TextView中直接使用\n换行符可以实现文本的换行显示，注意需要在字符串里转义\n。

    <TextView
        android:id="@+id/tv_xml_wrap_n"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="This is \na textview \nwith \\n"
        />

2.使用HTML标记
在TextView中使用HTML标记可以实现文本的格式化和换行显示。可以使用<br>标记实现换行，<b>标记实现文本加粗，<i>标记实现文本斜体等。

    <TextView
        android:id="@+id/tv_xml_wrap_html"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/text_with_html"
        />

    <string name="text_with_html"><br />This is a <b>text view</b> with <i>HTML</i> markup.<br /><br />This is another line of text.<br /><br /><u>Underline text.</u><br /><br />This is a <font color=\"#ff0000\">red color</font> text.<br /><br />This is a <big>big size</big> text.<br /><br />This is a <small>small size</small> text."
    </string>

3.使用CDATA
使用CDATA标记可以将文本内容原样输出，适用于显示特殊字符等需求。

    <TextView
        android:id="@+id/tv_xml_wrap_cdata"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/text_with_cdata"
        />

    <string name="text_with_cdata"><![CDATA[This is a textvie...]]></string>

三、使用Java代码实现文本换行

除了使用XML布局文件实现文本换行，我们也可以使用Java代码来动态设置TextView的文本内容，并实现文本的包装和格式化。下面给出一个使用Java代码实现文本换行的示例。

    TextView tv = findViewById(R.id.tv_java_wrap);
    String text = "This is a long text that needs to be wrapped. The quick brown fox jumps over the lazy dog.";
    SpannableStringBuilder builder = new SpannableStringBuilder();

    int startIndex = 0;
    int endIndex = text.indexOf(' ', startIndex + 1);

    while (endIndex != -1) {
        String word = text.substring(startIndex, endIndex + 1);
        builder.append(word);

        if (word.endsWith(" ")) {
            builder.setSpan(new SpaceWidthSpan(10), builder.length() - 1, builder.length(), Spanned.SPAN_EXCLUSIVE_EXCLUSIVE);
        }

        startIndex = endIndex + 1;
        endIndex = text.indexOf(' ', startIndex + 1);
    }

    builder.append(text.substring(startIndex));

    tv.setText(builder, TextView.BufferType.SPANNABLE);

在这个示例中，我们先定义了一个需要换行显示的字符串。然后使用SpannableStringBuilder动态构造一个SpannableString对象，并通过设置Span的方式实现文本换行和格式化。

这里的SpaceWidthSpan是一个自定义的Span类，用于设置单词之间的空格宽度。需要在Java代码中定义。

四、总结

通过以上三种方式，我们可以实现TextView文本的换行显示。在实际开发过程中，我们可以根据具体的需求选择不同的方式来实现文本包装和格式化。

参考文献

原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/190612.html