TextWatcher 在實際應用中主要用于監控文本框（如 EditText）中的文本變化。它允許開發者在文本更改時執行特定的操作，如實時驗證、自動完成、實時搜索等。以下是一個簡單的案例分析，展示了如何使用 TextWatcher 來實現一個實時搜索功能。

案例分析：實時搜索

1. 場景描述

在一個應用中，用戶需要在一個列表中搜索特定的項目。為了提高用戶體驗，開發者希望實現一個實時搜索功能，即當用戶在搜索框中輸入時，列表能夠自動過濾出與輸入內容匹配的項目。

2. 實現步驟

• 添加 TextWatcher：首先，在搜索框（如 EditText）中添加一個 TextWatcher。
• 監控文本變化：在 TextWatcher 的 afterTextChanged 方法中，獲取用戶輸入的文本，并執行搜索操作。
• 過濾列表：根據用戶輸入的文本，過濾出匹配的項目，并更新列表視圖。

3. 代碼示例

以下是一個簡單的代碼示例，展示了如何使用 TextWatcher 實現實時搜索功能。

// 假設我們有一個 EditText 用于搜索
EditText searchEditText = findViewById(R.id.search_edit_text);

// 創建一個 TextWatcher
searchEditText.addTextChangedListener(new TextWatcher() {
    @Override
    public void beforeTextChanged(CharSequence s, int start, int count, int after) {
        // 在文本變化之前執行的操作（如果有需要）
    }

    @Override
    public void onTextChanged(CharSequence s, int start, int before, int count) {
        // 在文本變化時執行的操作（例如，開始搜索）
    }

    @Override
    public void afterTextChanged(Editable s) {
        // 在文本變化之后執行的操作（例如，更新列表）
        String searchText = s.toString();
        filterList(searchText);
    }
});

// 過濾列表的方法
private void filterList(String searchText) {
    // 假設我們有一個列表視圖和一個數據源
    ListView listView = findViewById(R.id.list_view);
    List<Item> items = getItemDataSource(); // 獲取數據源
    List<Item> filteredItems = new ArrayList<>();

    // 根據搜索文本過濾數據源
    for (Item item : items) {
        if (item.getName().toLowerCase().contains(searchText.toLowerCase())) {
            filteredItems.add(item);
        }
    }

    // 更新列表視圖
    listView.setAdapter(new ItemAdapter(this, filteredItems));
}

// 假設我們有一個適配器用于顯示列表項
class ItemAdapter extends BaseAdapter {
    private Context context;
    private List<Item> items;

    public ItemAdapter(Context context, List<Item> items) {
        this.context = context;
        this.items = items;
    }

    @Override
    public int getCount() {
        return items.size();
    }

    @Override
    public Object getItem(int position) {
        return items.get(position);
    }

    @Override
    public long getItemId(int position) {
        return position;
    }

    @Override
    public View getView(int position, View convertView, ViewGroup parent) {
        // 填充列表項的視圖
        if (convertView == null) {
            convertView = LayoutInflater.from(context).inflate(R.layout.list_item, parent, false);
        }
        Item item = items.get(position);
        TextView nameTextView = convertView.findViewById(R.id.name_text_view);
        nameTextView.setText(item.getName());
        return convertView;
    }
}

4. 總結

通過上述案例，我們可以看到 TextWatcher 在實際應用中的強大功能。它允許開發者實時監控文本框中的文本變化，并根據這些變化執行相應的操作。在這個例子中，我們使用 TextWatcher 實現了實時搜索功能，提高了用戶搜索項目的效率。