šŸ“– Hướng Dįŗ«n Sį»­ DỄng Invoice Playground

šŸŽ›ļø Thanh CĆ“ng CỄ (Toolbar)

  • šŸ’¾ Save: Lʰu trįŗ”ng thĆ”i hiện tįŗ”i (bao gồm tįŗ„t cįŗ£ nį»™i dung, cĆ i đặt, chįŗæ độ sĆ”ng/tối, kĆ­ch thước panel, v.v.)
  • šŸ”„ Reset: KhĆ“i phỄc về trįŗ”ng thĆ”i đã lʰu gįŗ§n nhįŗ„t
  • šŸ“ Load Mock Data: Tįŗ£i dữ liệu mįŗ«u Ä‘į»ƒ thį»­ nghiệm
  • ↶ Undo / ↷ Redo: HoĆ n tĆ”c hoįŗ·c lĆ m lįŗ”i thay đổi trong editor đang focus (Ctrl/Cmd+Z, Ctrl/Cmd+Shift+Z)
  • šŸ“¦ Export ZIP: Xuįŗ„t tįŗ„t cįŗ£ file thĆ nh file ZIP vį»›i tĆŖn tį»± động bao gồm timestamp
  • šŸ“„ Import ZIP: Nhįŗ­p file ZIP đã xuįŗ„t trước đó, tį»± động điền thĆ“ng tin từ tĆŖn file
  • ⊟ Collapse All / āŠž Expand All: Thu gį»n hoįŗ·c mở rį»™ng tįŗ„t cįŗ£ cĆ”c editor section
  • šŸŒ™ Dark Mode / ā˜€ļø Light Mode: Chuyển đổi giữa chįŗæ độ tối vĆ  sĆ”ng cho toĆ n bį»™ giao diện

šŸ“ CĆ”c Editor Sections

  • Template Code (Liquid): Code template chĆ­nh sį»­ dỄng cĆŗ phĆ”p Liquid. Hį»— trợ alias draftOrder cho order
  • Styles (CSS): CSS styles vį»›i Liquid syntax, được inject vĆ o template khi render
  • Order Object (JSON): Dữ liệu order mįŗ«u (hoįŗ·c draftOrder)
  • Template Object (JSON): Cįŗ„u hƬnh template (font, size, barcode, v.v.)
  • Configuration Object (JSON): ThĆ“ng tin cį»­a hĆ ng (logo, địa chỉ, số điện thoįŗ”i, v.v.)
  • Text Object (JSON): CĆ”c text labels đa ngĆ“n ngữ

šŸŽØ TĆ­nh Năng Editor

  • Syntax Highlighting: Highlight cĆŗ phĆ”p cho Liquid, JSON, CSS
  • Fira Code Font: Font lįŗ­p trƬnh chuyĆŖn nghiệp vį»›i ligatures
  • Dracula Theme: Theme tối đẹp mįŗÆt (dark mode)
  • VS Theme: Theme sĆ”ng sįŗ”ch sįŗ½ (light mode)
  • Line Numbers: Hiển thị số dòng
  • Cursor Position: Hiển thị vị trĆ­ con trį» ở góc dưới phįŗ£i mį»—i editor

šŸ–±ļø Thao TĆ”c Vį»›i Editor

  • Click vĆ o header section: Thu gį»n/mở rį»™ng section đó
  • KĆ©o thįŗ£ section: Di chuyển Ä‘į»ƒ sįŗÆp xįŗæp lįŗ”i thứ tį»± cĆ”c section (thứ tį»± được lʰu tį»± động)
  • KĆ©o Ä‘Ę°į»ng viền giữa sections: Thay đổi kĆ­ch thước chiều cao cį»§a section
  • Keyboard shortcuts: Tįŗ„t cįŗ£ shortcuts cį»§a VS Code đều hoįŗ”t động (Find, Replace, Multi-cursor, v.v.)

ā†”ļø Panel Resize & Collapse

  • KĆ©o thanh dį»c giữa: Thay đổi kĆ­ch thước giữa Editors Panel vĆ  Preview Panel
  • Click vĆ o giữa thanh dį»c: Thu gį»n/mở rį»™ng Editors Panel (click trong vùng 40px từ tĆ¢m)

šŸ–¼ļø Preview Panel

  • Live Preview: Tį»± động cįŗ­p nhįŗ­t khi bįŗ”n chỉnh sį»­a (debounce 300ms)
  • Paper Size: Chį»n kĆ­ch thước giįŗ„y (Letter, A4, Legal, v.v.)
  • Error Display: Hiển thị lį»—i Liquid syntax ngay trong preview vį»›i số dòng chĆ­nh xĆ”c

šŸ’¾ Lʰu Trữ & Import/Export

  • Session Storage: Tį»± động lʰu nį»™i dung khi lĆ m việc (khĆ“ng mįŗ„t khi refresh)
  • Local Storage: Lʰu preferences (dark mode, paper size, section order)
  • Export Format: pdf_invoice_[tsName]_[storeName]_[templateName]_[date]_[time].zip
  • Import Parse: Tį»± động parse tĆŖn file vĆ  điền vĆ o cĆ”c input field
  • Auto-load Mock: Tį»± động load dữ liệu mįŗ«u khi mở lįŗ§n đầu

āš ļø Xį»­ Lý Lį»—i

  • Syntax Error: Hiển thị lį»—i vį»›i số dòng chĆ­nh xĆ”c trong Template Editor
  • Line Calculation: Tį»± động tĆ­nh offset do styles injection
  • Error Tips: Gợi ý sį»­a lį»—i phổ biįŗæn (vĆ­ dỄ: dùng != thay vƬ !==)
  • Visual Feedback: Hiển thị lį»—i trong preview vį»›i format dį»… Ä‘į»c

šŸŽÆ Tips & Tricks

  • Nhįŗ„n Ctrl/Cmd+S Ä‘į»ƒ save nhanh
  • Nhįŗ„n Ctrl/Cmd+Z Ä‘į»ƒ undo, Ctrl/Cmd+Shift+Z Ä‘į»ƒ redo
  • Sį»­ dỄng draftOrder thay vƬ order khi lĆ m việc vį»›i draft orders
  • Click Reset Ä‘į»ƒ quay về trįŗ”ng thĆ”i an toĆ n nįŗæu có lį»—i
  • Export ZIP thĘ°į»ng xuyĆŖn Ä‘į»ƒ backup cĆ“ng việc
  • KĆ©o thįŗ£ sections Ä‘į»ƒ sįŗÆp xįŗæp theo ý thĆ­ch
  • Thu gį»n sections khĆ“ng dùng Ä‘į»ƒ tįŗ­p trung vĆ o code quan trį»ng

šŸ”§ Input Fields

  • TS Name: TĆŖn TS (dùng trong tĆŖn file export)
  • Store Name: TĆŖn cį»­a hĆ ng (dùng trong tĆŖn file export)
  • Template Name: TĆŖn template (dùng trong tĆŖn file export, giữ nguyĆŖn chữ hoa/thĘ°į»ng)
  • Paper Size: KĆ­ch thước giįŗ„y cho preview (Letter, A4, Legal, Tabloid, A3, A5)
Template Code (Liquid)
ā–¼
Order Object (JSON)
ā–¼
Template Object (JSON)
ā–¼
Configuration Object (JSON)
ā–¼
Text Object (JSON)
ā–¼
Styles (CSS)
ā–¼

Preview (Letter Size: 8.5" Ɨ 11")