flutter_v_keyboard 0.3.2
flutter_v_keyboard: ^0.3.2 copied to clipboard
A fully customizable, native-feeling virtual keyboard and text input system for Flutter across mobile, desktop, and web.
0.3.2 #
DesktopFullKeyboardWidget (Edge-to-Edge Responsive Desktop OSK):- Added the edge-to-edge desktop virtual keyboard widget powered by proportional
Expanded(flex: N)keycaps andLayoutBuilderheight/typography scaling from narrow windows (480x800) to ultrawide & 4K monitors (3440x1440,3840x2160). - Added 6 hardware form-factor presets via
KeyboardLayoutType:layout60(pure alphanumeric +Fnlayer for F-keys, Delete, and arrows),layout65,layout75,layout87TKL,layout98(1800-compact with zero inter-cluster gap), andlayout100(Full-Size with Main15u, Navigation3u, and 4-column Numpad4u). - Exposed modular building blocks (
KeyModel,KeyType,VirtualKeyAction,DesktopFullLayoutData,VirtualKeyButton, andDesktopKeyboardThemeDatawith.dark(),.light(), and.fromVKeyboardTheme()presets). - Supports LED status indicators (
FN,CAPS,NUM), key-repeat, hover/press visual feedback,isFullWidth/maxWidth/maxKeyboardHeightRatioconstraints,onKeyPressed,onSpecialKeyPressed,onShortcutTriggered, and optionalVKeyboardController/VKeyboardScopebinding. - Added
VKeyboardConfig.desktopFormFactorsoVKeyboardScopecan automatically renderDesktopFullKeyboardwith the chosen preset whenVKeyboardType.desktopfields are focused, including the non-desktop-style bottom utility bar (showHideKeyboardButtondown-arrow close button on the bottom-left, optionalshowGlobeKey, andshowClipboardButtonon the bottom-right).
- Added the edge-to-edge desktop virtual keyboard widget powered by proportional
- Windows & macOS Desktop Conventions (
DesktopKeyboardPlatform):- Switch between
DesktopKeyboardPlatform.windows(Ctrl,Win,Alt,AltGr,Menu,Backspace,Enter,PrtSc,Num) andDesktopKeyboardPlatform.macos(fn,⌃ control,⌥ option,⌘ command,delete,return,F13–F15,clear) viaplatform,showPlatformToggle, andonPlatformChanged. - Dispatches macOS
Cmd+A/C/X/Vclipboard shortcuts alongside standardCtrl/Alt/Shiftshortcut combos.
- Switch between
- Multi-Language Desktop Layouts & CJK IME Integration:
- Enabled all 15 built-in locales (
en_US,en_GB,de_DE,fr_FR,es_ES,nordic,tr_TR,ru_RU,el_GR,ko_KR,ja_JP,zh_CN,zh_TW,th_TH,vi_VN) across all 6 form-factor presets (60%–100%) and both OS platforms, includingAltGrmappings and Unicode cased Shift/CapsLock support. - Added a taskbar/menubar-style
🌐locale picker pill (showLocaleSelector,availableLayouts,layoutId,onLayoutChanged) with a 2-column desktop selector modal and IME hints, plus active locale Spacebar labels and Spacebar long-press language switching. - Integrated automatic
CandidateBarrendering (showCandidateBar) forzh_CN(Pinyin),zh_TW(Zhuyin), andja_JP(Kana) composition alongsideko_KRHangul andvi_VNTelex when connected toVKeyboardController/VTextField.
- Enabled all 15 built-in locales (
0.3.1 #
- Fix: layout picker did nothing when
VKeyboardScopesits inMaterialApp.builder:- Holding the space bar (or the globe key) called
showDialog/showModalBottomSheetfrom inside the keyboard. With the recommendedMaterialApp.buildersetup the scope is above theNavigator, so the call threw and no picker appeared (with touch and mouse alike). - The picker is now rendered by
VKeyboardScopeitself, above the keyboard. It needs noNavigator, keeps focus on the active field (so the keyboard stays open), and shares the keyboard's tap region, so tapping it never dismisses the keyboard. Tapping the backdrop closes it without switching. - The picker closes automatically when the keyboard hides or the controller is disposed.
- Holding the space bar (or the globe key) called
- New API:
VKeyboardController.openLayoutPicker()returns aFuture<String?>with the selected layout id (nullif dismissed).closeLayoutPicker([layoutId])closes it, andisLayoutPickerOpenreports its state.VKeyboardLayoutPickerPanel: the layout list widget, exposed for custom picker UIs.
showVKeyboardLayoutPickeruses the in-scope picker when called below the owningVKeyboardScopeand falls back to a dialog / bottom sheet otherwise.
0.3.0 #
- Multi-Language Keyboard Layouts:
- Add 15 built-in locale layouts with localized main and symbol pages:
en_US: US English QWERTY (default, identical to previous releases).en_GB: UK English QWERTY with£currency symbol.de_DE: German QWERTZ with swappedY/Z,ä,ö,ü,ß, and€.fr_FR: French AZERTY with swappedA/QandZ/W,Madjacent toL,é,è,à,ç,ù, and€.es_ES: Spanish QWERTY withñ,¿,¡, and€.nordic: Nordic QWERTY withå,ä,ö,æ,ø, and€/kr.tr_TR: Turkish Q withğ,ü,ş,ı,ö,ç,₺, and strict dotted/dotless casing (i ↔ İ,ı ↔ I).ru_RU: Russian Cyrillic ЙЦУКЕН with₽.el_GR: Greek layout with Greek alphabet,€, andΕλληνικά (Greek) · GRlabel.ko_KR: Korean 2-Set Hangul (두벌식) with syllable composition, compound vowels/batchim, and₩.ja_JP: Japanese JIS Kana with¥currency, voicing marks (゛,゜), and dakuten composition.zh_CN: Simplified Chinese Pinyin layout with fullwidth punctuation (,,。,、) and¥.zh_TW: Traditional Chinese Zhuyin (注音 / Bopomofo) layout with tone marks and Traditional punctuation.th_TH: Thai Kedmanee (เกษมณี) layout with independent/dependent vowels, tone marks, Thai numerals, and฿.vi_VN: Vietnamese Telex QWERTY layout with diacritic alternates,₫currency, and Telex composition.
- Add declarative global registry
VKeyboardLayouts(register,getLayout,allLayouts,supportedLocales,altGrMapFor,isoLayoutIds,isLatin).
- Add 15 built-in locale layouts with localized main and symbol pages:
- CJK Offline IME Engines & Candidate Bar:
- Pure offline dictionary engines for Simplified Chinese Pinyin (
zh_CN), Traditional Chinese Zhuyin (zh_TW), and Japanese JIS Kana/Kanji (ja_JP). - Real-time
CandidateBarwidget rendered above the keyboard for candidate selection with numbered shortcuts, tap selection, and space bar commit. - Configurable via
VKeyboardConfig.enableImeCandidatesandmaxImeCandidates.
- Pure offline dictionary engines for Simplified Chinese Pinyin (
- Hangul Syllable Composition Engine (
HangulComposer):- Pure algorithmic Unicode Hangul composition (UAX #29 / Hangul Syllable Composition standard:
0xAC00 + (cho * 21 + jung) * 28 + jong) with zero external dependencies. - Real-time syllable combination (e.g.
ㅎ+ㅏ+ㄴ=한). - Compound vowel merging (e.g.
ㅗ+ㅏ=ㅘ,고+ㅏ=과). - Compound batchim merging (e.g.
ㄹ+ㄱ=ㄺ,달+ㄱ=닭). - Batchim splitting when a vowel follows (e.g.
간+ㅏ=가na,닭+ㅣ=달기). - Step-by-step backspace decomposition (e.g.
닭->달->다->ㄷ-> delete).
- Pure algorithmic Unicode Hangul composition (UAX #29 / Hangul Syllable Composition standard:
- Kana Voicing Mark Engine (
KanaComposer):- Algorithmic dakuten (
゛) and handakuten (゜) sound composer for Japanese typing (e.g.か+゛=が,は+゜=ぱ). - Step-by-step backspace decomposition (
が->か,ぱ->は).
- Algorithmic dakuten (
- Vietnamese Telex Engine (
VietnameseTelexComposer):- Pure algorithmic Telex syllable composer with circumflex (
aa->â,ee->ê,oo->ô), breve/horn (aw->ă,ow->ơ,uw/w->ư,uow->ươ), and stroke (dd->đ). - Full tone mark support (
ssắc,fhuyền,rhỏi,xngã,jnặng,zremove tone). - Modern orthographic tone placement on diphthongs/triphthongs and step-by-step backspace decomposition.
- Pure algorithmic Telex syllable composer with circumflex (
- Smart Latin Fallback for Email, URL, and Password Fields:
- Automatically switches non-Latin layouts (Korean, Japanese, Chinese, Thai, Russian, Greek) to standard Latin QWERTY when typing into
Email,URL, orPasswordfields. - Explicit
'English'space bar label on fallback layouts. - Automatic suppression of IME engines and diacritic composers on sensitive and ASCII fields.
- Automatically switches non-Latin layouts (Korean, Japanese, Chinese, Thai, Russian, Greek) to standard Latin QWERTY when typing into
- Space Bar Hold & Runtime Layout Switcher:
- Holding (long-pressing) the space bar opens
showVKeyboardLayoutPickerdisplaying active selection, localized display names, and short codes (bottom sheet on mobile, dialog on desktop/tablet). - Space bar subtly displays the active language name (e.g.
English (US),Deutsch,Русский,한국어,日本語) when multiple layouts are enabled. - Transient space bar announcement banner displaying active layout display name briefly (~1.5s fade out) upon switching.
- Optional globe key (
Icons.language) in the bottom bar, configurable viaVKeyboardConfig.showGlobeKey(defaults tofalse). - Screen-reader accessible with semantic announcements via
SemanticsService.
- Holding (long-pressing) the space bar opens
- Theming Enhancements:
- Added
activeKeyColorandactiveForegroundColortoVKeyboardThemefor high-contrast active modifier / engaged lock keys (active Shift, Caps Lock, held modifiers) in both light and dark themes.
- Added
- Bottom Bar Clipboard History Button:
- Dedicated clipboard history trigger button placed on the far right of the bottom safe-area bar, aligned with the dismiss button, configurable via
VKeyboardConfig.showClipboardButton.
- Dedicated clipboard history trigger button placed on the far right of the bottom safe-area bar, aligned with the dismiss button, configurable via
- Long-Press Accents:
- Character keys support
alternatesviaKeyData.char('e', alternates: ['é', 'è', 'ê', 'ë']). - Long-pressing letter keys presents an interactive accent callout popup above the key.
- Fully compatible with key repeat and backspace deletion.
- Character keys support
- Desktop Layout ISO & AltGr Support:
- Full desktop keyboard (
VKeyboardType.desktop) adapts to ISO layout standards with ISO Enter and the extra key beside Left Shift for ISO locales (en_GB,de_DE,fr_FR,es_ES,nordic,tr_TR,ru_RU). - Locale-specific AltGr character mappings (e.g.,
AltGr + Q→@,AltGr + E→€inde_DE).
- Full desktop keyboard (
- Cross-Platform Layout Selection Persistence:
- Saves user's selected keyboard layout across app restarts via
LayoutSelectionStorage(file-backed on Android, iOS, Windows, macOS, Linux, and in-memory on Web).
- Saves user's selected keyboard layout across app restarts via
- Reactive Focus & Dynamic Keyboard Type Handling:
VTextField.didUpdateWidgetdynamically rebuilds and re-attachesKeyboardSessionwhenkeyboardTypeor other field attributes change while focused.VKeyboardController.attachresets the active keyboard page when input types change on the same field.- Space bar display name accurately reads from the active layout, resolving stale fallback states.
- Public API Additions:
VKeyboardLocaleenum: Type-safe enum for all 15 built-in locale layouts (enUS,enGB,deDE,frFR,esES,nordic,trTR,ruRU,elGR,koKR,jaJP,zhCN,zhTW,thTH,viVN) withisLatin,id,displayName,shortLabel, andfromId().VKeyboardConfig:enabledLocales,defaultLocale,enabledLayouts,defaultLayout,showGlobeKey,showClipboardButton,enableImeCandidates,maxImeCandidates,persistLayoutSelection,openPickerOnTap.VKeyboardController:currentLocale,setLocale(locale),currentLayoutId,setLayout(id),nextLayout(),onLayoutChangedstream,insertText(text),composingText,candidates,commitCandidate(text).VKeyboardTheme:activeKeyColor,activeForegroundColor.CandidateBar: Horizontal candidate bar widget for IME suggestion selection.VKeyboardScope:onLayoutChangedcallback.showVKeyboardLayoutPicker: modal bottom sheet on mobile or centered dialog on desktop/tablet to pick active layout.
- Example App & Preview Improvements:
- Replace floating overlay stack in the embedded preview with in-place page switching for
EmojiPanelandClipboardHistoryPanel. - Synchronize panel heights and bottom safe-area dismiss buttons to ensure smooth transitions with zero vertical shift when opening the emoji panel.
- Add interactive
VKeyboardLocaleselector chips and demonstration of custom math layout.
- Replace floating overlay stack in the embedded preview with in-place page switching for
0.2.4 #
- Gboard-Style Dismiss Arrow:
- Add a downward arrow button (
Icons.keyboard_arrow_down_rounded) below the keyboard grid inKeyboardView(like Google Keyboard / Gboard) to dismiss/close the virtual keyboard. - Configurable via
VKeyboardConfig.showHideKeyboardButton(default:true), automatically omitted on desktop layouts. - Accurately synchronizes bottom bar height with
VKeyboardScope's safe area insets andviewInsets.bottomso focused text fields remain properly visible above the keyboard. - Add dismiss button support across
EmojiPanelandClipboardHistoryPanelbottom safe area areas. - Support custom
hideIconandonHidecallback inKeyboardView.
- Add a downward arrow button (
VKeyboardTypeEnum with Value:- Add
labelproperty toVKeyboardTypeenum (standard('QWERTY'),decimal('Decimal'), etc.) for type-safe, human-readable display names.
- Add
- Example App & Bug Fixes:
- Fix
DropdownButtonassertion error when selectingDecimal,URL, orPasswordkeyboard types by switching the preview dropdown to strictly typedDropdownButton<VKeyboardType>. - Fix example app initial state opening the clipboard panel on first launch by defaulting
_showClipboardInPreviewtofalse.
- Fix
0.2.3 #
- Scroll-into-view improvement:
- Restrict automatic focus scroll-into-view (
_scrollIntoView) inVTextFieldto vertical ancestorScrollables only. - Fixes unwanted horizontal displacement and snapping when focusing input fields inside horizontal scroll containers such as
TabBarView,PageView, or carousels. - Preserves vertical scrolling behavior for fields obscured by the on-screen keyboard within vertical scroll views.
- Restrict automatic focus scroll-into-view (
0.2.2 #
- Use absolute image URLs in the README so the showcase renders on pub.dev.
0.2.1 #
- OS Clipboard Synchronization:
- Automatically synchronize clipboard history with host operating system clipboard across Android, iOS, macOS, Windows, Linux, and Web via
ClipboardHistoryManager.syncFromSystemClipboard(). - Copy and cut shortcuts (
Cmd+C,Ctrl+C,Cmd+X,Ctrl+X) seamlessly populate system clipboard and history. - Add
VKeyboardConfig.syncSystemClipboardconfiguration toggle.
- Automatically synchronize clipboard history with host operating system clipboard across Android, iOS, macOS, Windows, Linux, and Web via
- Virtual Keyboard Clipboard Trigger:
- Add small, subtle clipboard history icon key directly into virtual keyboard layouts (
123/symbols page and desktop cluster) without altering keyboard height. - Accessible semantic label and tooltip for clipboard key actions.
- Add small, subtle clipboard history icon key directly into virtual keyboard layouts (
- UI & Experience Polish:
- Modernized
ClipboardHistoryPanelwith refined typography, professional icon set, item counter badge, and quick filter chips (All,Pinned,Recent). - High-contrast visual styling and robust system font fallback stacks across light and dark themes.
- Modernized
- Bug Fixes & Reliability:
- Fix framework locked widget tree assertion: defer
setState()inVKeyboardScopeduring unmount and persistent callback phases. - Export
ClipboardHistoryPanelandEmojiPaneldirectly in package public exports.
- Fix framework locked widget tree assertion: defer
- Showcase & Example App:
- Redesigned example app with macOS-style window framing, interactive playground, floating clipboard preview, and full-screen desktop keyboard view.
- Update all showcase screenshots in README with latest high-resolution app captures.
0.2.0 #
- Clipboard History (
Win + Vstyle):- Add
ClipboardHistoryManagerwithrecord(),togglePin(),deleteItem(),clearUnpinned(),clearAll(), andsearch(). - Add cross-platform persistence with
ClipboardHistoryStorage(file-backed on Android, iOS, Windows, macOS, Linux, and in-memory on Web). - Add dedicated
ClipboardHistoryPanelUI with search filtering, 2-line visual preview, relative timestamps, pin/unpin toggles, delete action, and clear confirmation. - Add keyboard entry points: clipboard key on
123/symbols page, emoji panel bottom bar, and desktop cluster. - Add hardware keyboard shortcuts:
Win + VandCtrl + Shift + VonVTextField. - Add
VKeyboardConfig.enableClipboardHistoryandVKeyboardConfig.maxClipboardHistoryItems. - Add privacy and sensitive field protection: excludes
obscureText,VKeyboardType.password,VKeyboardType.pin, andVTextField(sensitive: true)from history recording. - Integrate with
TextInputEnginepipeline, respectingmaxLength,inputFormatters,readOnly, and selection replacement.
- Add
0.1.2 #
- Add built-in
VKeyboardTheme.light()andVKeyboardTheme.dark()presets. - Add
VKeyboardType.textfor a standard QWERTY layout without the emoji key.
0.1.1 #
- Use absolute image URLs in the README so the showcase renders on pub.dev.
0.1.0 #
Initial release.
VTextField— a drop-in,TextField-compatible field driven by an on-screen keyboard (no OS keyboard), with real cursor, selection, multiline editing and full Flutter focus integration.VKeyboardScope— hosts the keyboard, animates it in/out and pushes content like the system keyboard (viewInsets).- Built-in layouts: standard, number, decimal, phone, pin, password, email, url, multiline, emoji, full desktop (Windows OSK style) and custom.
- Desktop module: modifiers (Shift/Ctrl/Alt/AltGr/Meta), Caps/Num/Scroll Lock,
navigation (arrows, Home/End/Page, by-word), built-in + custom shortcuts
(
VKeyboardShortcuts), clipboard (Ctrl+A/C/X/V), key repeat, hover/locked visuals, and native Windows keys via FFI (Print Screen, media, Win/Menu). - Scrollable, categorised emoji panel (zero runtime dependency).
- Responsive sizing for phone/tablet/desktop and resizable windows; Material 3
theming via
VKeyboardTheme; behaviour viaVKeyboardConfig. - Hardware-keyboard fallback on desktop/web; accessibility semantics.
- Unit + widget tests; comprehensive example app.