패키지, 저장소 및 앱 카테고리 검색

GitHub 저장소tegarnugroho/v_keyboard

v_keyboard

Flutter용 사용자 정의 가능한 네이티브 느낌의 화면 키보드(모바일·데스크톱·웹).

v_keyboard 프로젝트 이미지
스타
0
포크
0
최근 푸시(UTC)
2026. 8. 20.
프로젝트 상태
활성

원본 README

아래는 영문 원문 스냅샷입니다. 최신 내용은 GitHub에서 확인하세요.

flutter_v_keyboard hero showcase

flutter_v_keyboard

A customizable virtual keyboard and text-input system for Flutter, built for mobile, desktop, and web.

pub package platforms license

Unlike simple keyboard widgets, flutter_v_keyboard pairs a drop-in VTextField with an on-screen text input engine. It delivers precise cursor management, multi-character selection replacement, multiline editing, layout switching, and focus traversal without invoking the host operating system's software keyboard.


Showcase

Everyday Typing
Standard Number / PIN Password Multiline
Standard mobile layout Number and PIN layout Password layout Multiline input layout
Customization
Light Theme Dark Theme Emoji Panel
Light theme preset Dark theme preset Categorized emoji picker
Desktop

Full physical desktop layout featuring function keys, navigation clusters, and responsive collapsing sections.

Desktop keyboard layout with function row and navigation cluster

Responsive scaling across phones, landscape mode, tablets, and wide desktop windows.

Responsive layout scaling across phone, tablet, and desktop

Clipboard History

Production-ready clipboard history integrated directly into the virtual keyboard. Tap the clipboard key on the keyboard, search snippets, pin frequent items, and paste directly into the active field.

Integrated Key History Panel Search & Filter
Integrated clipboard history key Clipboard history panel with pinned snippets Search and quick filter chips

Features

Text Input
  • Real cursor positioning, drag selection, and multi-character replacement.
  • Multiline editing with newline handling and text overflow wrapping.
  • Flutter focus system integration with TextInputAction (next, done, go, search).
  • Native keyboard avoidance by pushing application UI via viewInsets.bottom.
  • Full respect for inputFormatters, maxLength, and readOnly configurations.
Keyboard Layouts
  • Alphabetic: Standard QWERTY and Text (clean layout without emoji switch).
  • Specialized: Number, decimal, phone, PIN, password, email, and URL layouts.
  • Symbols: Multi-page switching (123, #+=) with sticky shift and double-tap caps lock.
  • Emoji: Built-in categorized emoji picker with zero external dependencies.
  • Custom: Declarative layout definition and custom key widget builders.
Desktop Experience
  • Windows On-Screen Keyboard style layout with function keys (F1–F12) and numpad.
  • Full modifier handling: Shift, Ctrl, Alt, AltGr, Meta, Caps Lock, Num Lock, and Scroll Lock.
  • Navigation clusters: Arrow keys, Home, End, Page Up, and Page Down.
  • Word-by-word navigation (Ctrl + Arrow) and word deletion (Ctrl + Backspace).
  • Hardware keyboard fallback on desktop and web targets.
  • Desktop shortcut registration via VKeyboardShortcuts.
Clipboard History
  • Automatic recording of copied and cut text snippets within the virtual keyboard pipeline.
  • Instant synchronization with the host operating system clipboard upon opening.
  • Persistent local storage surviving application restarts.
  • Deduplication with position bumping and original timestamp preservation.
  • Snippet pinning to protect critical items from eviction.
  • Search filtering with quick filter chips (All, Pinned, Recent).
  • Privacy protection: Password, PIN, and sensitive fields are never saved.
  • Hardware shortcut support (Win + V, Ctrl + Shift + V).

Installation

Add flutter_v_keyboard to your pubspec.yaml:

flutter pub add flutter_v_keyboard

Or add it manually under dependencies:

dependencies:
  flutter_v_keyboard: ^0.2.2

Quick Start

Wrap your application tree once with VKeyboardScope:

import 'package:flutter/material.dart';
import 'package:flutter_v_keyboard/flutter_v_keyboard.dart';

void main() => runApp(const MyApp());

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      builder: (context, child) => VKeyboardScope(
        child: child!,
      ),
      home: const FormPage(),
    );
  }
}

Replace TextField with VTextField:

class FormPage extends StatefulWidget {
  const FormPage({super.key});

  @override
  State<FormPage> createState() => _FormPageState();
}

class _FormPageState extends State<FormPage> {
  final _controller = TextEditingController();

  @override
  void dispose() {
    _controller.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Virtual Keyboard Example')),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: VTextField(
          controller: _controller,
          keyboardType: VKeyboardType.standard,
          textInputAction: TextInputAction.done,
          decoration: const InputDecoration(
            labelText: 'Your message',
            border: OutlineInputBorder(),
          ),
        ),
      ),
    );
  }
}

Customization

Themes

Choose between built-in presets or inherit colors and typography from your application's ThemeData:

// Built-in presets
VKeyboardScope(
  theme: VKeyboardTheme.light(accentColor: Colors.teal),
  child: child!,
);

VKeyboardScope(
  theme: VKeyboardTheme.dark(accentColor: Colors.deepOrange),
  child: child!,
);

// Ambient ThemeData inheritance (with native OS font fallback stack)
VKeyboardScope(
  theme: VKeyboardTheme.fromTheme(Theme.of(context)),
  child: child!,
);
Runtime Configuration

Adjust keyboard behavior and clipboard limits through VKeyboardConfig:

VKeyboardScope(
  config: const VKeyboardConfig(
    hideOnDone: true,
    moveFocusOnNext: true,
    closeOnOutsideTap: true,
    enableLongPressDelete: true,
    enableKeyRepeat: true,
    enableClipboardHistory: true,
    maxClipboardHistoryItems: 50,
  ),
  child: child!,
);
Custom Layouts

Define custom layouts declaratively without modifying package internals:

final greekLayout = KeyboardLayout(
  id: 'greek',
  initialPage: 'main',
  pages: {
    'main': [
      'αβγδεζηθ'.split('').map(KeyData.char).toList(),
      'ικλμνξοπ'.split('').map(KeyData.char).toList(),
      [
        KeyData.shift(flex: 1.5),
        ...'ρστυφχψ'.split('').map(KeyData.char),
        KeyData.backspace(flex: 1.5),
      ],
      [
        KeyData.space(flex: 5),
        KeyData.enter(flex: 2),
      ],
    ],
  },
);

VTextField(
  keyboardType: VKeyboardType.custom,
  customLayout: greekLayout,
);
Custom Keys

Insert custom widget keys using KeyData.custom:

KeyData.custom(
  builder: (context) => Container(
    alignment: Alignment.center,
    decoration: BoxDecoration(
      color: Colors.amber.shade200,
      borderRadius: BorderRadius.circular(8),
    ),
    child: const Icon(Icons.mic, size: 20),
  ),
  text: '[voice]',
  flex: 1.2,
);
Desktop Keyboard and Shortcuts

Render a full physical keyboard layout with VKeyboardType.desktop and bind custom global shortcuts with VKeyboardShortcuts:

VKeyboardShortcuts(
  shortcuts: {
    LogicalKeySet(LogicalKeyboardKey.control, LogicalKeyboardKey.keyS): () {
      debugPrint('Save command invoked');
    },
  },
  onMedia: (intent) => debugPrint('Media key: $intent'),
  onMetaKey: () => debugPrint('Meta / Windows key tapped'),
  child: child!,
);
Sensitive Fields

Exclude sensitive information from clipboard history by setting sensitive: true:

VTextField(
  controller: _pinController,
  keyboardType: VKeyboardType.pin,
  sensitive: true, // Content will never be recorded to clipboard history
);

Architecture

flutter_v_keyboard is designed around single-responsibility layers:

Component Responsibility
VKeyboardScope Injects keyboard overlay, manages bottom safe-area insets (viewInsets.bottom), and handles tap-outside dismissal.
VKeyboardController Coordinates keyboard state, page switches, active modifiers, and clipboard history.
KeyboardSession Links the focused VTextField to the controller, synchronizing selection and cursor updates.
TextInputEngine Core text manipulation engine handling insertions, deletions, formatters, and length constraints.
KeyboardView Computes responsive layout metrics and renders keys with per-key repaint boundaries.
ClipboardHistoryManager Records snippets, enforces storage limits, handles pinning, and syncs with system clipboard.
VKeyboardTheme Defines visual colors, elevation, border radii, and system font fallback stacks.
VKeyboardConfig Controls runtime keyboard behavior flags and feature toggles.

Platform Support

Platform Support Status
Android Supported Verified via automated widget tests and example runner.
iOS Supported Verified via automated widget tests and example runner.
macOS Supported Verified via automated widget tests, integration tests, and desktop example.
Windows Supported Verified via automated widget tests and desktop example.
Linux Supported Verified via automated widget tests and desktop example.
Web Supported Verified via automated widget tests and Chrome target (storage runs in-memory).
SDK Requirements
  • Flutter: >=3.22.0
  • Dart: >=3.4.0 <4.0.0

Contributing & Links

  • Example App: Explore example/lib/main.dart for a comprehensive demonstration of all layouts, themes, and interactions.
  • Changelog: Review recent updates and breaking changes in CHANGELOG.md.
  • Issue Tracker: Report bugs or propose new features on GitHub Issues.
  • License: Released under the MIT License.
Tegar GitHub avatar
GitHub 작성자

Tegar ↗

Flutter Developer @wolkk-cloud

WolkkIndonesia
언어DartC++CMakeSwiftCKotlinObjective-C

분류

사용 중인 의존성

의존성 목록 3 개

  • flutter{"sdk":"flutter"}
  • flutter_test개발 의존성{"sdk":"flutter"}
  • flutter_lints개발 의존성^4.0.0

프로젝트에 맞는 저장소를 선택하려면?

사용 목적에 따라 검색하고 개발 활동을 비교한 뒤 원본 저장소에서 요구 사항을 확인하세요.

  1. 이름, 작성자 또는 설명으로 검색하고 기술 주제로 범위를 좁힙니다.
  2. 스타, 포크, 최근 푸시를 함께 비교하세요. 스타는 관심의 지표이며 품질을 보장하지 않습니다.
  3. 사용하기 전에 GitHub에서 README, 라이선스, Issues를 확인하세요.

출처 및 관리

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗