圖文混排 Button 是高頻 UI 需求。本文對比四種實現方案:原生 drawableLeft/Top、繼承 Button 重寫 onDraw、合成佈局 (RelativeLayout/LinearLayout) 封裝、MaterialButton + iconGravity,分析優缺點、適用場景與性能差異。
<Button
android:id="@+id/btn_train"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="火車"
android:textSize="16sp"
android:textColor="#000000"
android:drawableLeft="@drawable/ic_train"
android:drawablePadding="8dp"
android:padding="12dp"
android:background="@drawable/btn_bg_selector" />
drawableStart/End/Top/Bottom (RTL 友好)。drawableTop 但文字基線對齊難控制)。public class ImageTextButton extends Button {
private Drawable icon;
private int iconWidth, iconHeight;
private int iconGravity = Gravity.LEFT | Gravity.CENTER_VERTICAL;
public ImageTextButton(Context ctx, AttributeSet attrs) {
super(ctx, attrs);
TypedArray a = ctx.obtainStyledAttributes(attrs, R.styleable.ImageTextButton);
icon = a.getDrawable(R.styleable.ImageTextButton_icon);
iconWidth = a.getDimensionPixelSize(R.styleable.ImageTextButton_iconWidth, -1);
iconHeight = a.getDimensionPixelSize(R.styleable.ImageTextButton_iconHeight, -1);
iconGravity = a.getInt(R.styleable.ImageTextButton_iconGravity, iconGravity);
a.recycle();
if (icon != null) icon.setCallback(this);
}
@Override protected void onDraw(Canvas canvas) {
super.onDraw(canvas); // 繪製背景與文字
if (icon == null) return;
// 計算圖標繪製區域 (根據 iconGravity、padding、文字寬度)
// 此處省略詳細佈局計算邏輯...
icon.setBounds(iconLeft, iconTop, iconLeft + iconWidth, iconTop + iconHeight);
icon.draw(canvas);
}
@Override protected boolean verifyDrawable(Drawable who) {
return who == icon || super.verifyDrawable(who);
}
}
<merge xmlns:android="https://schemas.android.com/apk/res/android">
<ImageView android:id="@+id/iv_icon"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:scaleType="fitCenter" />
<TextView android:id="@+id/tv_text"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:gravity="center"
android:ellipsize="end"
android:maxLines="1" />
</merge>
public class ImageTextButton extends LinearLayout {
private ImageView ivIcon;
private TextView tvText;
public ImageTextButton(Context ctx, AttributeSet attrs) {
super(ctx, attrs);
setOrientation(HORIZONTAL); // 或 VERTICAL
setGravity(Gravity.CENTER);
LayoutInflater.from(ctx).inflate(R.layout.widget_image_text_button, this, true);
ivIcon = findViewById(R.id.iv_icon);
tvText = findViewById(R.id.tv_text);
// 解析自定義屬性設置圖標、文字、間距...
}
// 提供 setText, setIcon, setIconPosition 等公共方法
}
<com.google.android.material.button.MaterialButton
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="下載"
app:icon="@drawable/ic_download"
app:iconGravity="textStart" // textStart | textEnd | textTop | textBottom
app:iconSize="20dp"
app:iconPadding="8dp"
app:cornerRadius="8dp"
style="@style/Widget.MaterialComponents.Button.OutlinedButton" />
material 庫、最低 API 21 (含兼容庫)。| 場景 | 推薦方案 | 理由 |
|---|---|---|
| 簡單圖文按鈕、列表項操作 | 方案一 (drawableLeft) | 零代碼、性能最好、系統原生狀態 | 需精確控制圖標大小/位置/動畫 | 方案二 (繼承 Button) | 繪製完全可控 |
| 複雜結構 (圖標+主標題+副標題、徽章、進度環) | 方案三 (合成佈局) | 靈活組合子 View |
| 新專案 / Material Design 風格 | 方案四 (MaterialButton) | 規範統一、功能豐富、維護成本低 |