flutter_chen_keyboard
一個功能強大且易于使用的 Flutter 鍵盤增強庫,專為提升移動應用的鍵盤交互體驗而設計。
📖 庫簡介
flutter_chen_keyboard
是一個專注于鍵盤相關功能的 Flutter 工具庫,旨在為開發者提供更流暢、更智能的鍵盤交互解決方案。通過簡單的 API 設計和豐富的自定義選項,幫助開發者輕松構建用戶友好的鍵盤交互界面。
? 核心特性
🎯 智能鍵盤管理
- 多手勢關閉:支持 40+ 種手勢類型觸發鍵盤關閉
- 滾動自動關閉:滾動頁面時智能關閉鍵盤
- 方向性檢測:精確識別上下左右滑動方向
- 延遲關閉:支持自定義延遲時間關閉鍵盤
🔧 開發者友好
- 預設配置:提供標準配置,開箱即用
- 擴展方法:簡單的鏈式調用,一行代碼搞定
- 性能優化:智能檢測焦點狀態,避免不必要的操作
- 調試支持:內置錯誤處理和調試信息輸出
📱 全平臺兼容
- ? iOS
- ? Android
- ? Web
- ? Desktop (Windows/macOS/Linux)
效果展示
🚀 快速開始
基礎用法
// 使用預設配置(推薦)
KeyboardDismisser.standard(child: YourWidget(),
)// 或使用擴展方法(最簡單)
YourWidget().dismissKeyboard()
自定義配置
KeyboardDismisser(gestures: [GestureType.onTap,GestureType.onPanUpdateUpDirection,],dismissOnScroll: true,delay: Duration(milliseconds: 200),onKeyboardDismissed: () => print('鍵盤已關閉'),child: YourWidget(),
)
🛠? 已實現功能
KeyboardDismisser 組件
增強版鍵盤關閉組件,支持多種手勢和自定義配置選項。
主要功能:
- 40+ 種手勢類型支持(點擊、長按、拖拽、縮放等)
- 智能方向檢測(上下左右平移)
- 滾動時自動關閉鍵盤
- 延遲關閉和回調支持
- 性能優化和錯誤處理
🔮 未來規劃
隨著庫的發展,計劃陸續添加更多鍵盤相關功能:
- 鍵盤高度監聽器 - 實時監聽鍵盤高度變化
- 鍵盤狀態管理器 - 全局鍵盤狀態管理
- 自適應布局組件 - 鍵盤彈出時自動調整布局
- 鍵盤工具欄 - 自定義鍵盤上方工具欄
- 鍵盤動畫效果 - 平滑的鍵盤顯示/隱藏動畫
- 輸入法切換助手 - 輸入法相關輔助功能
💡 設計理念
- 簡單易用:提供直觀的 API,降低學習成本
- 高度可定制:豐富的配置選項滿足不同場景需求
- 性能優先:智能優化,確保流暢的用戶體驗
- 全平臺支持:一套代碼,多平臺運行
- 持續進化:根據開發者反饋不斷完善功能
📋 適用場景
- 登錄/注冊表單頁面
- 聊天應用界面
- 搜索頁面
- 評論輸入界面
- 任何需要優化鍵盤交互的場景
讓鍵盤交互變得更簡單、更智能、更流暢 -
flutter_chen_keyboard