萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 一鍵禁用整個佈局內所有子控件 (遞歸遍歷 ViewGroup) 通用工具方法

應用場景

表單「僅檢視」模式、權限控制、載入狀態:需將整個畫面所有輸入框、按鈕、下拉選單等設為不可點擊/不可編輯。

通用遞歸禁用方法

/**
 * 遞歸禁用 ViewGroup 及其所有子孫 View 的交互
 * @param viewGroup 根佈局 (如 LinearLayout, RelativeLayout, ConstraintLayout)
 */
public static void disableSubControls(ViewGroup viewGroup) {
    for (int i = 0; i < viewGroup.getChildCount(); i++) {
        View child = viewGroup.getChildAt(i);
        if (child instanceof ViewGroup) {
            // 特殊容器類型單獨處理 (Spinner, ListView 等本身可點擊)
            if (child instanceof Spinner) {
                ((Spinner) child).setEnabled(false);
                ((Spinner) child).setClickable(false);
            } else if (child instanceof ListView) {
                ((ListView) child).setEnabled(false);
                ((ListView) child).setClickable(false);
            } else if (child instanceof RecyclerView) { // 現代補充
                ((RecyclerView) child).setEnabled(false);
            } else {
                // 普通 ViewGroup 繼續遞歸
                disableSubControls((ViewGroup) child);
            }
        } else if (child instanceof EditText) {
            ((EditText) child).setEnabled(false);
            ((EditText) child).setFocusable(false);
            ((EditText) child).setClickable(false);
        } else if (child instanceof Button) {
            ((Button) child).setEnabled(false);
        } else if (child instanceof TextView) { // 含 Button、CheckBox、RadioButton 等
            child.setEnabled(false);
            child.setClickable(false);
        } else {
            // 其餘 View 統一禁用
            child.setEnabled(false);
            child.setClickable(false);
        }
    }
}

使用範例

// 在 Activity/Fragment 中
ViewGroup root = findViewById(R.id.root_layout); // 根佈局 ID
disableSubControls(root); // 一鍵禁用全部

// 恢復啟用:同理遞歸 setEnabled(true) / setClickable(true)
// 注意:Spinner/ListView/RecyclerView 的 Adapter 狀態可能需額外處理

進階:Kotlin 擴展函數版

fun ViewGroup.disableAllChildren() {
    for (i in 0 until childCount) {
        val child = getChildAt(i)
        if (child is ViewGroup) {
            when (child) {
                is Spinner, is ListView, is RecyclerView -> {
                    child.isEnabled = false
                    child.isClickable = false
                }
                else -> child.disableAllChildren()
            }
        } else {
            child.isEnabled = false
            child.isClickable = false
            if (child is EditText) child.isFocusable = false
        }
    }
}

// 調用
rootLayout.disableAllChildren()

注意事項

  • 禁用後視覺上通常會變灰 (預設 disabled 狀態),若需保持外觀請自定義 state_enabled selector。
  • setClickable(false) 可防止觸摸事件傳遞,但 setEnabled(false) 才是標準禁用語意。
  • 含有 WebView、MapView 等複雜控件時需額外處理其內部狀態。
copyright © 萬盛學電腦網 all rights reserved