向应用添加按钮

试用 Compose 方式
Jetpack Compose 是推荐用于 Android 的界面工具包。了解如何在 Compose 中添加组件。

按钮由文本和/或图标组成,用于传达用户点按该按钮时所执行的操作。

您可以通过以下三种方式在布局中创建按钮,具体取决于您想要一个带文本的按钮、一个图标还是同时包含二者:

  
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
      xmlns:app="http://schemas.android.com/apk/res-auto"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:paddingLeft="16dp"
      android:paddingRight="16dp"
      android:orientation="vertical" >
  
      <Button
          android:id="@+id/supabutton"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:text="I'm a button" />
  
      <ImageButton
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:contentDescription="A tiny Android icon"
          android:src="@drawable/baseline_android_24"
          app:tint="#ff0000" />
  
      <Button
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:drawableStart="@drawable/baseline_android_24"
          android:drawablePadding="4dp"
          android:drawableTint="#ff0000"
          android:text="I'm a button with an icon" />
  </LinearLayout>

上述代码会生成如下内容:

显示三种按钮的图片
图 1. 三种样式的按钮。

响应点击事件

当用户点按按钮时,Button 对象会收到点击事件。

如需以编程方式声明事件处理脚本,请创建一个 View.OnClickListener 对象,并通过调用 setOnClickListener(View.OnClickListener) 将其分配给按钮,如以下示例所示:

Kotlin

findViewById<Button>(R.id.supabutton)
  .setOnClickListener {
      Log.d("BUTTONS", "User tapped the Supabutton")
  }

Java

Button button = (Button) findViewById(R.id.supabutton);
button.setOnClickListener(new View.OnClickListener() {
    public void onClick(View v) {
      Log.d("BUTTONS", "User tapped the Supabutton");
    }
});

设置按钮样式

按钮的外观(背景图片和字体)因设备而异,因为不同制造商的设备通常会为输入控件采用不同的默认样式。

如需使用不同背景自定义各个按钮,请使用可绘制对象或颜色资源指定 android:background 属性。或者,您可以为按钮应用样式,它的工作方式与 HTML 样式类似,用于定义多个样式属性(例如背景、字体和大小)。如需详细了解如何应用样式,请参阅样式和主题

无边框按钮

“无边框”按钮可能会是一种非常有用的设计。无边框按钮与基本按钮类似,只不过它们没有边框或背景,但其外观仍会因状态(如点按)而改变。

如需创建无边框按钮,请对按钮应用 borderlessButtonStyle 样式,如以下示例所示:

<Button
  android:id="@+id/supabutton"
  style="?android:attr/borderlessButtonStyle"
  android:layout_width="wrap_content"
  android:layout_height="wrap_content"
  android:text="I'm a button" />

自定义背景

如果您想真正重新定义按钮的外观,可以指定自定义背景。但是,您的背景必须是根据按钮的当前状态来更改外观的状态列表资源,而不是提供简单的位图或颜色。

您可以在 XML 文件中定义状态列表,该文件定义了用于不同按钮状态的三种图片或颜色。

如需为按钮背景创建状态列表可绘制对象,请执行以下操作:

  1. 为按钮背景创建三个位图,分别代表默认、点按和聚焦的按钮状态。为确保图片适合各种尺寸的按钮,请将位图创建为九宫格位图。
  2. 将位图放入项目的 res/drawable/ 目录中。为每个位图命名,以反映其代表的按钮状态,例如 button_default.9.pngbutton_pressed.9.pngbutton_focused.9.png
  3. res/drawable/ 目录中创建一个新的 XML 文件。使用类似 button_custom.xml 的名称为其命名。插入如下所示的 XML:
    <?xml version="1.0" encoding="utf-8"?>
    <selector xmlns:android="http://schemas.android.com/apk/res/android">
        <item android:drawable="@drawable/button_pressed"
              android:state_pressed="true" />
        <item android:drawable="@drawable/button_focused"
              android:state_focused="true" />
        <item android:drawable="@drawable/button_default" />
    </selector>
    

    这会定义单个可绘制资源,该资源会根据按钮的当前状态更改其图片。

    • 第一个 <item> 定义点按(激活)按钮时要使用的位图。
    • 第二个 <item> 定义在按钮聚焦时(例如使用轨迹球或方向键突出显示按钮时)使用的位图。
    • 第三个 <item> 定义按钮处于默认状态(既未点按,也未聚焦时)时使用的位图。

    此 XML 文件表示单个可绘制资源。当 Button 为其背景引用时,显示的图片会根据按钮的状态而变化。

  4. 将可绘制 XML 文件应用为按钮背景:
    <Button
        android:id="@+id/button_send"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="@string/button_send"
        android:onClick="sendMessage"
        android:background="@drawable/button_custom"  />
    

如需详细了解此 XML 语法,包括如何定义已停用、悬停或处于其他状态的按钮,请参阅 StateListDrawable