m1ngsama/TUT
1
0
Fork 0
mirror of https://github.com/m1ngsama/TUT.git synced 2026-02-08 00:54:05 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions
TUT/KEYBOARD.md
m1ngsama be6cc4ca44 feat: Add full in-page search functionality 
Completed Phase 1 high priority task - comprehensive search system:

Search Features:
- Press '/' to enter search mode with dedicated search input
- Case-insensitive search across all content
- Enter to execute search and find all matches
- Real-time match highlighting:
  * Yellow background = current match
  * Blue background = other matches
- Navigate results with 'n' (next) and 'N' (previous)
- Smart scrolling - auto-scroll to current match
- Match counter in status bar (e.g., "Match 3/10")
- Esc to cancel search input
- Search state clears when loading new pages

Implementation Details:
- Added search state to MainWindow::Impl
  * search_mode, search_query, search_matches, current_match
- Search input component (similar to address bar)
- executeSearch() - finds all matching lines
- nextMatch()/previousMatch() - cycle through results
- Content renderer highlights matches dynamically
- Status panel shows search results with emoji indicator

User Experience:
- Intuitive vim-style '/' to search
- Visual feedback with color highlighting
- Match position indicator in status
- Non-intrusive - doesn't interfere with navigation
- Seamless integration with existing UI

Keyboard shortcuts:
- /: Start search
- Enter: Execute search
- n: Next match
- N: Previous match
- Esc: Cancel search

Documentation:
- Updated KEYBOARD.md with search section and usage example
- Updated STATUS.md to reflect completion
- Added search to interactive features list

The browser now has powerful in-page search! 🔍✅
2026-01-01 00:51:05 +08:00

3.2 KiB
Raw Blame History

TUT Browser - Keyboard Shortcuts

🎯 Quick Reference

Navigation

Key Action
o Open address bar (type URL and press Enter)
Backspace Go back
f Go forward
r or F5 Refresh current page
q or Esc or F10 Quit browser

Scrolling

Key Action
j or ↓ Scroll down one line
k or ↑ Scroll up one line
Space or PageDown Page down
b or PageUp Page up
g Go to top
G Go to bottom

Links

Key Action
Tab Select next link
Shift+Tab Select previous link
1-9 Jump to link by number
Enter Follow selected link

📝 Usage Examples

Basic Browsing

./build_ftxui/tut https://example.com

# 1. Press 'j' or 'k' to scroll
# 2. Press 'Tab' to cycle through links
# 3. Press 'Enter' to follow the selected link
# 4. Press 'Backspace' to go back
# 5. Press 'q' to quit

Direct Link Navigation

./build_ftxui/tut https://tldp.org/HOWTO/HOWTO-INDEX/howtos.html

# See numbered links like [1], [2], [3]...
# Press '1' to jump to first link
# Press '2' to jump to second link
# Press 'Enter' to follow the selected link

Address Bar

# 1. Press 'o' to open address bar
# 2. Type new URL
# 3. Press 'Enter' to navigate
# 4. Press 'Esc' to cancel

In-Page Search

# Search for text on current page
# 1. Press '/' to open search bar
# 2. Type your search query (case-insensitive)
# 3. Press 'Enter' to find all matches
# 4. Press 'n' to go to next match
# 5. Press 'N' to go to previous match
# 6. Matches are highlighted (yellow = current, blue = other matches)
# 7. Status bar shows "Match X/Y" count

🎨 UI Elements

Top Bar

  • [◀] - Back button (dimmed when can't go back)
  • [▶] - Forward button (dimmed when can't go forward)
  • [⟳] - Refresh
  • Address bar - Shows current URL
  • [⚙] - Settings (not yet implemented)
  • [?] - Help (not yet implemented)

Content Area

  • Shows rendered HTML content
  • Displays page title at top
  • Shows scroll position at bottom

Bottom Panels

  • Bookmarks Panel - Shows bookmarks (not yet implemented)
  • Status Panel - Shows:
    • Load stats (KB downloaded, time, link count)
    • Currently selected link URL

Status Bar

  • Shows function key shortcuts
  • Shows current status message

⚡ Pro Tips

  1. Fast Navigation: Use number keys (1-9) to instantly jump to links
  2. Quick Scrolling: Use Space and b for fast page scrolling
  3. Link Preview: Watch the status bar to see link URLs before following
  4. Efficient Browsing: Use g to jump to top, G to jump to bottom
  5. Address Bar: Type o quickly to enter a new URL

Search

Key Action
/ Start search (type query and press Enter)
n Next search result
N Previous search result
Esc Cancel search

🐛 Known Limitations

  • Ctrl+L not yet working for address bar (use 'o' instead)
  • No bookmarks yet (Ctrl+D)
  • No history panel yet (F3)

🚀 Coming Soon

  • Bookmarks (add, remove, list)
  • History (view and navigate)
  • Better link highlighting
  • Form support