flutter_trigger_input 0.4.1

High-performance Flutter Rich Text Input for Mentions (@), Hashtags (#), and Links. Built on Delta Architecture with atomic deletion, custom context menus, and JSON sync.

flutter_trigger_input

A highly customizable Flutter widget for detecting and handling interactive triggers like mentions, hashtags, and links within a text field.

🧠 Why Choose Delta Architecture?

Most Flutter mentions packages use simple string offset calculations, which often break during complex edits or IME (Input Method Editor) changes. flutter_trigger_input uses a modern Delta Architecture (Segment-based state management):

• High Performance: Only affected segments are updated during edits, avoiding expensive recalculations of the entire text field.
• Data Integrity: Special entities (like mentions) are treated as atomic units, preventing accidental partial modifications.
• Backend Friendly: Content is exported as a structured JSON array (Quill-like Delta format), making it easy to store and render across different platforms.

🚀 Powerful Flutter Mentions & Hashtags Features

• Multi-Trigger Support: Handle @mentions, #hashtags, [links], and more simultaneously.
• Delta Architecture: Manages content as structured segments (JSON), perfect for backend storage.
• Keyword Spaces: Support for triggers with spaces (e.g., @John Doe) via allowSpace: true.
• Atomic Deletion: Entities are deleted as single units.
• Auto Link Replacement: Automatically converts pasted URLs into interactable text.
• Custom Context Menus: Define custom actions for each trigger type.

🛠 Usage

1. Initialize the Controller

Define your triggers and their respective styles.

final _controller = TriggerInputController<SuggestionInfo>(
  triggers: [
    Mention(
      trigger: '@',
      style: const TextStyle(color: Colors.blue, fontWeight: FontWeight.bold),
    ),
    Mention(
      trigger: '#',
      style: const TextStyle(color: Colors.pink),
    ),
  ],
);

2. Add the Widget

TriggerInputField<SuggestionInfo>(
  controller: _controller,
  allowSpace: true,
  onMentionSearchChanged: (trigger, keyword) {
    // Fetch and update suggestions in your state
    final results = mySearchLogic(trigger, keyword);
    _controller.state.suggestionInfos.value = results;
  },
)

3. Get Structured Data

Access the content in a structured JSON format (Delta) for your API.

String jsonMarkup = _controller.tfController.markupText;
// Output: [{"insert": "Hi "}, {"insert": "@John", "attributes": {"mention": {"id": "1"}}}]

📝 Credits

• bbob_dart

🤝 Issues and feedback

Feel free to open a Github issue for suggestions or bug reports.