paginate long tocs

examples/demo_pagination.py

@@ -0,0 +1,173 @@
+#!/usr/bin/env python3
+"""
+Demo script showing TOC overlay pagination functionality.
+
+This demonstrates:
+1. Opening a navigation overlay with many chapters
+2. Navigating through pages using Next/Previous buttons
+3. Switching between Contents and Bookmarks tabs with pagination
+"""
+
+import sys
+from pathlib import Path
+
+# Add project root to path
+project_root = Path(__file__).parent.parent
+sys.path.insert(0, str(project_root))
+
+from dreader import EbookReader, TouchEvent, GestureType
+
+def main():
+    print("=" * 60)
+    print("TOC Pagination Demo")
+    print("=" * 60)
+
+    # Create reader
+    reader = EbookReader(page_size=(800, 1200))
+
+    # Create a mock book with many chapters for demonstration
+    from dreader.html_generator import generate_navigation_overlay
+
+    # Generate test data: 35 chapters and 20 bookmarks
+    chapters = [{"index": i, "title": f"Chapter {i+1}: The Adventure Continues"} for i in range(35)]
+    bookmarks = [{"name": f"Bookmark {i+1}", "position": f"Page {i*10}"} for i in range(20)]
+
+    print("\nTest Data:")
+    print(f"  - {len(chapters)} chapters")
+    print(f"  - {len(bookmarks)} bookmarks")
+    print(f"  - Items per page: 10")
+    print()
+
+    # Demonstrate pagination on Contents tab
+    print("Contents Tab Pagination:")
+    print("-" * 60)
+
+    # Page 1 of TOC (chapters 1-10)
+    print("\n[Page 1/4] Chapters 1-10:")
+    html_page1 = generate_navigation_overlay(
+        chapters=chapters,
+        bookmarks=bookmarks,
+        active_tab="contents",
+        page_size=(800, 1200),
+        toc_page=0,
+        toc_items_per_page=10
+    )
+    # Extract chapter titles for display
+    for i in range(10):
+        print(f"  {i+1}. {chapters[i]['title']}")
+    print("  [← Prev] Page 1 of 4 [Next →]")
+
+    # Page 2 of TOC (chapters 11-20)
+    print("\n[Page 2/4] Chapters 11-20:")
+    html_page2 = generate_navigation_overlay(
+        chapters=chapters,
+        bookmarks=bookmarks,
+        active_tab="contents",
+        page_size=(800, 1200),
+        toc_page=1,
+        toc_items_per_page=10
+    )
+    for i in range(10, 20):
+        print(f"  {i+1}. {chapters[i]['title']}")
+    print("  [← Prev] Page 2 of 4 [Next →]")
+
+    # Page 3 of TOC (chapters 21-30)
+    print("\n[Page 3/4] Chapters 21-30:")
+    html_page3 = generate_navigation_overlay(
+        chapters=chapters,
+        bookmarks=bookmarks,
+        active_tab="contents",
+        page_size=(800, 1200),
+        toc_page=2,
+        toc_items_per_page=10
+    )
+    for i in range(20, 30):
+        print(f"  {i+1}. {chapters[i]['title']}")
+    print("  [← Prev] Page 3 of 4 [Next →]")
+
+    # Page 4 of TOC (chapters 31-35)
+    print("\n[Page 4/4] Chapters 31-35:")
+    html_page4 = generate_navigation_overlay(
+        chapters=chapters,
+        bookmarks=bookmarks,
+        active_tab="contents",
+        page_size=(800, 1200),
+        toc_page=3,
+        toc_items_per_page=10
+    )
+    for i in range(30, 35):
+        print(f"  {i+1}. {chapters[i]['title']}")
+    print("  [← Prev] Page 4 of 4 [Next →]")
+
+    # Demonstrate pagination on Bookmarks tab
+    print("\n" + "=" * 60)
+    print("Bookmarks Tab Pagination:")
+    print("-" * 60)
+
+    # Page 1 of Bookmarks (1-10)
+    print("\n[Page 1/2] Bookmarks 1-10:")
+    html_bm1 = generate_navigation_overlay(
+        chapters=chapters,
+        bookmarks=bookmarks,
+        active_tab="bookmarks",
+        page_size=(800, 1200),
+        toc_page=0,
+        bookmarks_page=0,
+        toc_items_per_page=10
+    )
+    for i in range(10):
+        print(f"  {bookmarks[i]['name']} - {bookmarks[i]['position']}")
+    print("  [← Prev] Page 1 of 2 [Next →]")
+
+    # Page 2 of Bookmarks (11-20)
+    print("\n[Page 2/2] Bookmarks 11-20:")
+    html_bm2 = generate_navigation_overlay(
+        chapters=chapters,
+        bookmarks=bookmarks,
+        active_tab="bookmarks",
+        page_size=(800, 1200),
+        toc_page=0,
+        bookmarks_page=1,
+        toc_items_per_page=10
+    )
+    for i in range(10, 20):
+        print(f"  {bookmarks[i]['name']} - {bookmarks[i]['position']}")
+    print("  [← Prev] Page 2 of 2 [Next →]")
+
+    print("\n" + "=" * 60)
+    print("Pagination Controls:")
+    print("-" * 60)
+    print("  - Click 'Next →' to go to next page")
+    print("  - Click '← Prev' to go to previous page")
+    print("  - Page indicator shows: 'Page X of Y'")
+    print("  - Buttons are disabled at boundaries:")
+    print("    • '← Prev' disabled on page 1")
+    print("    • 'Next →' disabled on last page")
+    print()
+
+    print("=" * 60)
+    print("Interactive Gesture Flow:")
+    print("-" * 60)
+    print("1. User swipes up → Opens navigation overlay (page 1)")
+    print("2. User taps 'Next →' → Shows page 2")
+    print("3. User taps 'Next →' → Shows page 3")
+    print("4. User taps chapter → Navigates to chapter & closes overlay")
+    print("5. OR taps '← Prev' → Goes back to page 2")
+    print()
+
+    print("HTML Features Implemented:")
+    print("-" * 60)
+    print("✓ Pagination links: <a href='page:next'> and <a href='page:prev'>")
+    print("✓ Page indicator: 'Page X of Y' text")
+    print("✓ Disabled styling: opacity 0.3 + pointer-events: none")
+    print("✓ Separate pagination for Contents and Bookmarks tabs")
+    print("✓ Automatic page calculation based on total items")
+    print("✓ Graceful handling of empty lists")
+    print()
+
+    print("=" * 60)
+    print("Demo Complete!")
+    print("=" * 60)
+
+if __name__ == "__main__":
+    main()