Android TextView属性

封面图 • 2025-10-29 • Android开发

在 Android 开发中，`TextView` 是一个非常常用的控件，用于显示文本内容。它继承自 `ViewGroup`，可以显示单行或多行文本，并支持多种样式和格式。

以下是 `TextView` 的常用属性（XML 中使用）：

---

## ✅ 基本属性

| 属性名 | 说明 |
|--------|------|
| `android:id` | 设置控件的唯一标识符（用于 Java/Kotlin 中引用） |
| `android:text` | 设置 TextView 显示的文本内容 |
| `android:layout_width` | 设置宽度（如 `match_parent`, `wrap_content`） |
| `android:layout_height` | 设置高度（如 `match_parent`, `wrap_content`） |
| `android:layout_margin` | 设置边距（可单独设置 `layout_marginTop`, `layout_marginBottom` 等） |

---

## ✅ 文本样式相关属性

| 属性名 | 说明 |
|--------|------|
| `android:textSize` | 设置字体大小（单位：sp 或 px） |
| `android:textColor` | 设置字体颜色（如 `#FF0000` 或 `@color/red`） |
| `android:typeface` | 设置字体类型（如 `normal`, `sans`, `serif`, `monospace`） |
| `android:textStyle` | 设置字体风格（如 `normal`, `bold`, `italic`） |
| `android:gravity` | 设置文本对齐方式（如 `center`, `left`, `right`） |
| `android:padding` | 设置内边距（如 `16dp`） |
| `android:background` | 设置背景颜色或图片 |

---

## ✅ 多行文本相关属性

| 属性名 | 说明 |
|--------|------|
| `android:inputType` | 设置输入类型（如 `textMultiLine`） |
| `android:lines` | 设置最大显示行数 |
| `android:maxLines` | 设置最大行数（推荐使用） |
| `android:ellipsize` | 设置文本过长时的省略方式（如 `end`, `start`, `middle`, `marquee`） |

---

## ✅ 链接与点击事件

| 属性名 | 说明 |
|--------|------|
| `android:autoLink` | 自动识别链接（如 `web`, `email`, `phone`） |
| `android:linksClickable` | 设置链接是否可点击 |
| `android:clickable` | 设置控件是否可点击（默认为 false） |
| `android:onClick` | 绑定点击事件方法（在 Activity 中定义） |

---

## ✅ 其他常用属性

| 属性名 | 说明 |
|--------|------|
| `android:hint` | 设置提示文本（通常用于 EditText） |
| `android:singleLine` | 设置为单行显示（已废弃，建议用 `maxLines="1"`） |
| `android:scrollHorizontally` | 设置是否允许水平滚动（仅适用于单行文本） |
| `android:drawableLeft` | 设置左侧图标 |
| `android:drawableRight` | 设置右侧图标 |
| `android:drawableTop` | 设置顶部图标 |
| `android:drawableBottom` | 设置底部图标 |

---

## ✅ 示例 XML 代码

```xml
<TextView
    android:id="@+id/myTextView"
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:text="Hello, Android!"
    android:textSize="18sp"
    android:textColor="#0000FF"
    android:textStyle="bold"
    android:gravity="center"
    android:padding="16dp"
    android:background="#FFFFFF"
    android:layout_margin="10dp" />
```

---

## 📘 注意事项

- `TextView` 默认是不可点击的，如果要响应点击事件，需要设置 `android:clickable="true"` 或在 Java/Kotlin 中设置 `setOnClickListener()`。
- 使用 `android:ellipsize="end"` 可以实现文本超出时在末尾显示省略号。
- 如果需要显示富文本（如不同颜色、字体等），可以使用 `SpannableString`。

---

如果你有特定需求（比如动态修改 TextView 内容、设置 HTML 格式文本、处理长按事件等），也可以告诉我，我可以提供更详细的解决方案。