flutter_v_keyboard 0.3.7
flutter_v_keyboard: ^0.3.7 copied to clipboard
A fully customizable, native-feeling virtual keyboard and text input system for Flutter across mobile, desktop, and web.
0.3.7 #
- MacBook & Laptop Viewport Sizing Fix (
KeyboardMetrics.isLargeDesktopDisplay):- Updated large-display detection in
KeyboardMetrics.isLargeDesktopDisplayto requirewidth >= 1800 && height >= 960(24"+ Full HD, 27" 2K/QHD, Ultrawide, and 4K monitors) instead of checkingheight >= 900alone, preventing MacBook Air / MacBook Pro screens (e.g.1470x956,1440x900,1512x982,1710x1107) from entering large-monitor scaling and covering ~46% of the display. - Added smooth landscape row-ceiling scaling (
(screenH * 0.056).clamp(46.0, 62.0)) inKeyboardMetrics.desktopMaxRowCeilingandKeyboardMetrics.defaultFullKeyboardHeightRatio, keeping MacBook & tablet keyboards compact (~32%–35% of screen height) while preserving comfortable sizing on 27" 2K (~510pxtotal, ~35.4%) and 1080p monitors. - Consolidated
DesktopFullKeyboardandVKeyboardScopeonto the sharedKeyboardMetricssizing helpers so scopeviewInsets,DesktopFullKeyboard,KeyboardView, and F-row ratio caps stay consistent.
- Updated large-display detection in
0.3.6 #
- Adaptive Tablet Landscape vs Large Desktop Scaling:
- Differentiated viewport scaling between large desktop monitors ($\ge 900$px height, e.g. 24", 27", 32" POS / kiosk / desktop displays at 1080p, 1440p, 4K) and tablets / compact viewports ($< 900$px height, e.g. 10.1" / 11" Android tablets and iPads at 1280x800, 1024x768).
- In
KeyboardMetrics.desktopBaselineHeight,KeyboardMetrics.resolve, andDesktopFullKeyboard: tuned row height ceiling in tablet landscape to48.0px(maxRowCeiling) and height factor to~0.33–0.36, preventing the keyboard from expanding to 50%+ of the screen and obscuring input forms/dialogs on tablet devices. - Retained comfortable, spacious proportions on 27" monitors and large desktop screens (~400px–480px, ~40%–44% of viewport).
- Clipboard History Panel & Scope Sizing Safety:
- Added an adaptive minimum height floor (
math.min(280.0, mq.size.height * 0.55)) forClipboardHistoryPanelinVKeyboardScopeto ensure header, search bar, filter chips, item cards, and bottom navigation bar remain fully visible and unobstructed on all display sizes. - Added
copyWithconvenience method onKeyboardMetrics.
- Added an adaptive minimum height floor (
- Example App Polish:
- Added smooth animated sidebar expand and collapse transitions (
AnimatedContainerwith 240msCurves.easeInOutCubic). - Added Dark Mode toggle button directly to the top window header when the sidebar is collapsed.
- Pinned form factor, OS, and language selector chips in the Desktop Keyboard tab above the scrollable area to prevent header clipping.
- Added smooth animated sidebar expand and collapse transitions (
0.3.5 #
- Large & High-Resolution Display Scaling (24", 27", 32" POS / Kiosk / Desktop Monitors):
- Replaced the hardcoded
54.0pxrow height ceiling inKeyboardMetrics.desktopBaselineHeight,DesktopFullKeyboard, andKeyboardMetrics.resolvewith dynamic viewport scaling up to92.0pxon screens with height $\ge 900$px (1080p, 1440p, 4K), preventing keys from squishing into thin horizontal ribbons on large displays. - Increased the default desktop baseline height to ~400px–480px (~38%–44% of a 1080p display) for comfortable touch targets and well-proportioned keycaps in retail POS, kiosk, and desktop environments.
- Proportional 6-row layouts with Function row (
layout75,layout87TKL,layout98,layout100) scale harmoniously from the shared desktop baseline (scaled = baseline * (6.0 / 5.0)). - Increased
KeyboardViewrow height ceiling to120.0pxandDesktopFullKeyboardkey font size clamp to26.0px.
- Replaced the hardcoded
- Touch-Friendly Numeric & Compact Layout Sizing on Wide Displays:
- Automatically expanded the default maximum width for compact layouts (
VKeyboardType.number,pin,decimal,phone) on wide displays ($\ge 1200$px width) from360.0pxto480.0px, providing large, comfortable number keys for cashier and kiosk workflows.
- Automatically expanded the default maximum width for compact layouts (
- Custom Sizing & Geometry Controls in
VKeyboardConfig:- Added
keyboardHeight: Explicit fixed keyboard content height in logical pixels overriding dynamic fraction and row-height calculations. - Added
keyboardHeightFactor: Fraction of total viewport height (e.g.0.40for 40%) occupied by the keyboard. - Added
minKeyboardHeight&maxKeyboardHeight: Explicit lower and upper bounds for keyboard content height. - Added
keyHeight: Preferred individual key row height in logical pixels. - Added
maxKeyboardWidth: Upper bound on keyboard content width; centers the keyboard horizontally when the window is wider. - Added
numericPadMaxWidth: Upper bound for numeric and compact keyboards (defaults to480.0pxon wide screens). - Added
heightandkeyHeightproperties toDesktopFullKeyboardwidget for standalone usage.
- Added
0.3.4 #
- Consistent Keyboard Height Across Layouts (
KeyboardMetrics.desktopBaselineHeight):- Unified height calculation on tablet and desktop viewports across all non-F-row layouts (
Standard,Email,URL,Password,Multiline,Number,Decimal,Phone,PIN, and 5-row desktop presetslayout60/layout65) so dialogs and forms never shift vertically when switching field types. - Preserved extra proportional height for expert 6-row layouts displaying the Function row (
layout75,layout87TKL,layout98,layout100) and utility panels (ClipboardHistoryPanel).
- Unified height calculation on tablet and desktop viewports across all non-F-row layouts (
0.3.3 #
- Unified Dark Theme Across Desktop & Mobile Layouts:
- Updated
VKeyboardTheme.dark()(and dark presets viaVKeyboardTheme.fromTheme) to share the same deep-slate palette asDesktopFullKeyboard(#13151Bbackground,#21242Dcharacter keycaps,#1A1D26special/modifier keycaps,#2B31401px key borders,#1E2330top hairline border,#353C4Epressed highlight,#2B303Ehover color,#94A3B8sub-labels, andBorderRadius.circular(6)). - Added optional
keyBorderColor,containerBorderColor,hoverKeyColor, andenterKeyColortokens toVKeyboardThemeand updatedVirtualKey,KeyboardView,EmojiPanel,ClipboardHistoryPanel, andVKeyboardLayoutPickerPanelto render crisp borders, accent-tinted Enter/Action keys, and hairline top borders viaforegroundDecoration. - Updated
VKeyboardScopeto deriveDesktopKeyboardThemeData.fromVKeyboardTheme(theme)soaccentColorandborderRadiusstay synchronized between desktop and non-desktop layouts.
- Updated
- Desktop Bottom Utility Bar (Non-Desktop Parity) & Inline Clipboard:
- Replaced the standalone dismiss pill on
DesktopFullKeyboardwith a bottom utility bar matchingKeyboardView: bottom-left close arrow (showHideKeyboardButton), optional bottom-left language globe (showGlobeKey), and bottom-right clipboard trigger (showClipboardButton), plushideIcon,globeIcon,clipboardIcon,onClipboardTap, andbottomSafeArea. - Derives bottom-bar defaults automatically from
VKeyboardController.configand switches cleanly in-place toClipboardHistoryPanelwhen opening clipboard history in embedded layouts. - Wired
VKeyboardScope(VKeyboardConfig.desktopFormFactor) to display the bottom utility bar (onDismiss: controller.hide, clipboard trigger, and_fullKeyboardMetricsheight parity).
- Replaced the standalone dismiss pill on
- Documentation & Example App:
- Documented
DesktopFullKeyboard, the 6KeyboardLayoutTypepresets (layout60–layout100),DesktopKeyboardPlatform(Windows/macOS),VKeyboardConfig.desktopFormFactor, and the bottom utility bar inREADME.md. - Updated the example app's Desktop Keyboard tab with interactive hide/reopen and inline clipboard history switching.
- Documented
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.
- 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.
