⌨️ עורך קוד (WebApp Editor)
טעינת CodeMirror ומצב isLoading
נטען את CodeMirror בצורה דינמית.
אם הטעינה נכשלת → מנגנון fallback (textarea) מופעל.
במהלך הטעינה מוצג מצב
isLoadingכדי למנוע אינטראקציה מיותרת.
let isLoading = true;
try {
const cm = await import('codemirror');
// init editor...
} catch (e) {
console.warn('Editor fallback to textarea', e);
} finally {
isLoading = false;
}
החבילה המקומית של CodeMirror, וכיוון לכל שורה
EditorManager(webapp/static/js/editor-manager.js) טוען קודם אתwebapp/static/js/codemirror.local.js, שמגדירwindow.CodeMirror6. רק כשהיא לא עולה הוא בונה אתwindow.CodeMirror6ממודולים ב-CDN, ובמסלול הזה אין את התוספים שהחבילה המקומית מוסיפה.החבילה נבנית מקובץ ה-entry
webapp/static_build/codemirror.bundle.entry.mjsעםwebapp/static_build/build-cm.mjs, מהגרסאות שב-package-lock.json. הבנייה רצה מתוךwebapp/static_build: esbuild כותב בחבילה הערות עם נתיבי המודולים יחסית לתיקייה שממנה רצים, ובנייה מתיקייה אחרת משנה את כל ההערות האלה. בנייה מתוך התיקייה, בלי שינוי ב-entry, מחזירה קובץ זהה בייט-בייט לזה שבריפו (נבדק באוקטובר 2026), ולכן הדיף של שינוי ב-entry הוא רק השינוי עצמו. הסקריפטbuild-cmשב-package.jsonמריץ את אותו קובץ מהשורש, ולכן הוא משנה את ההערות. מתקינים מהשורש ובונים מהתיקייה:
npm ci --ignore-scripts
cd webapp/static_build && node build-cm.mjs
rtlExceptCodeBlocks(ב-entry, ומיוצא ב-window.CodeMirror6): העורך כולו מימין לשמאל, ורק השורות של בלוק קוד מקבלותdir="ltr". בלוק קוד הוא מה שהמנתח של Markdown בעורך כבר זיהה — הצמתיםFencedCode(בין```, כולל שורות הגדר) ו-CodeBlock(שורות מוזחות) בעץ התחביר — ולא ביטוי משלנו.EditorView.perLineTextDirectionגורם ל-CodeMirror לקרוא את הכיוון של כל שורה בנפרד, כך שהסמן, הבחירה והחצים עוקבים אחריו.initEditorעםtextDirection: 'rtl'מוסיף אותו, ואת המחלקהcodemirror-container--rtl, שב-codemirror-custom.cssהופכת את העורך לימין-לשמאל ונותנת לשורה ריווח לפי הכיוון שלה (ה-.cm-lineשל CodeMirror מרווח בצדדים פיזיים, ובעורך מימין לשמאל הטקסט נצמד לגבול). בעורך הפשוט, כש-CodeMirror לא עלה, הכול מימין לשמאל: ב-textarea אין כיוון לשורה בודדת. משתמש בו העורך הציבורי (/markdown-editor); עמודי העריכה וההעלאה נשארים משמאל לימין, כמו עורך קוד. כשהחבילה נטענה מה-CDN, האפשרות נרשמת כאזהרה בקונסול, והעורך נשאר משמאל לימין. עד אוקטובר 2026 כל שורה קיבלהdir="auto"(perLineAutoDirection), כלומר כיוון לפי האות החזקה הראשונה בה — ושורות כמו- [x] משימהאו שורת היישור של טבלה יצאו משמאל לימין בתוך מסמך עברי.createBasicSetup({ gutters })—basicSetupעם האפשרות להוריד את העמודה שבצד הטקסט: בלי מספרי שורות ובלי חיצי קיפול (קיצורי הקיפול במקלדת נשארים).initEditorעםgutters: falseמשתמש בו; העורך הציבורי מעביר אותה. הוא קיים גם במסלול ה-CDN שלloadCodeMirror, שבונהbasicSetupמשלו.הדבקה שמחליפה את כל המסמך — לתוך עורך ריק, או אחרי ”בחר הכל“ — משאירה את הסמן ואת העורך בתחילת המסמך (
getFullPasteExtension: מסנן טרנזקציות על ה-userEventinput.paste), ושולחת על ה-textarea את האירועeditor:document-replaced, שבו התצוגה החיה (live-preview.js) חוזרת גם היא לראש המסמך. כפתור ”הדבק“ מסמן את ההדבקה שלו באותו userEvent (insertTextAtCursor), ובעורך הפשוטwatchTextareaFullPasteעושה את אותו דבר. הדבקה לתוך טקסט קיים לא משתנה: הסמן אחרי מה שהודבק.ההודעה הזמנית (”כל הקוד סומן“, ”הוזרק: טבלה“) צפה בקצה הרווח שאחרי הכפתורים (
.editor-info-statusבתוך.editor-info-slot, ב-codemirror-custom.css), ואינה תופסת מקום — כך שורת הכפתורים לא משנה גובה והעורך לא זז. קבוצת הכפתורים (.editor-clipboard-actions) בנויה משתי יחידות (addSwitcherButton): הראשונה,.editor-clip-head— ”בטל“, ”בצע שוב“, ”בחר הכל“ ו“העתק“, כולם באותו גובה (כפתור של אייקון בלבד נמתח לגובה של כפתור עם טקסט); והשנייה,.editor-clip-tail— ”הדבק“, התא של ההודעה, ובעמודי העריכה וההעלאה סרגל ה-MD, אחרון בשורה, אחרי התא (moveToEditorRowב-markdown-toolbar.js). היחידה השנייה לא נשברת: כשאין לה מקום היא יורדת לשורה הבאה כולה, ולכן MD תמיד באותה שורה עם ”הדבק“. התא ממלא את הרווח שבין ”הדבק“ לסרגל ומתכווץ לאפס כשאין רווח, וההודעה צפה בקצה שלו — ולכן היא לא מכסה את כפתור ה-MD. בשורה צרה הרווח קטן מההודעה, והיא מכסה לכמה שניות חלק מהכפתורים שלפניה; יש לה רקע, ו-pointer-events: noneמשאיר אותם לחיצים. בטלפון (עד 768px) הכפתורים בגודל הטקסט שלהם, וההודעה צפה גם שם. עד נובמבר 2026 בטלפון הכפתורים התרחבו למלא את השורה, ו“הדבק“, שירד לשורה שנייה לבד, תפס את כולה; התא והסרגל ישבו מחוץ לקבוצה, ולכן MD ירד לשורה משלו (גם ברוחב שבו ”הדבק“ נכנס לשורה הראשונה), והודעה בטלפון הוסיפה שורה והורידה את העורך (נמדד: 13px בעורך הציבורי, 25px בעמוד העריכה). אין יותר תווית ”קיצורי מקלדת זמינים“ (נובמבר 2026): היא תפסה רוחב שכפתורי ”בטל“ / ”בצע שוב“ צריכים, ובעורך הציבורי ברוחב 1024 עד 1180 ”הדבק“ ירד בגללה לשורה שנייה. עד אז ההודעה ישבה במקומה, והתווית היא שהחזיקה לה את המקום — בלעדיה, הודעה הורידה את העורך (נמדד: 17px בעורך הציבורי ברוחב 1024, 31px בעמוד העריכה ברוחב 820), ולכן ההודעה צפה. בעורך הפשוט נשארה התווית ”עורך טקסט בסיסי“, בקצה התא (updateInfoBanner).התווית של שדה הקוד — ”קוד“ בעמודי העריכה וההעלאה, ”Markdown“ בעורך הציבורי — מוסתרת מהעין (
sr-only) ונשארת לקורא מסך. היא לא נמחקת:addSwitcherButtonמציב את שורת הכפתורים מיד אחריה. עד נובמבר 2026 בעמודי העריכה וההעלאה היא הייתה שורה גלויה מעל העורך.”בטל“ ו“בצע שוב“ — שני כפתורים, אייקון בלי טקסט, בתחילת השורה של ”בחר הכל / העתק / הדבק“ בכל עמודי העורך (
.btn-editor-undo/.btn-editor-redoב-addSwitcherButton). הם מפעילים אתundo/redoשל ההיסטוריה של CodeMirror, אותן פקודות ש-historyKeymapשל@codemirror/commandsמפעיל ב-Ctrl+Z / Ctrl+Y (נבדק בגרסה 6.10.0), ולכן הכפתור והמקלדת עובדים על אותה היסטוריה. כפתור מושבת כשאין לו מה לעשות (undoDepth/redoDepth), והמצב מתעדכן אחרי כל עדכון של העורך (getHistoryButtonsExtension) ובכל החלפת עורך (syncHistoryButtons). הלחיצה לא לוקחת את הפוקוס (preventDefaultעלmousedown): הסמן לא נכנס לעורך, ובטאבלט לא נפתחת מקלדת, ואם הסמן כבר בעורך הוא נשאר שם. בעמוד מימין לשמאל החצים בתמונת ראי, כך שהחץ של ”בטל“ פונה ימינה (codemirror-custom.css). ארבע הפקודות מיוצאות ב-window.CodeMirror6, מהחבילה המקומית וממסלול ה-CDN שלloadCodeMirror. בעורך הפשוט הכפתורים מוסתרים: ל-textarea אין היסטוריה משלו, וה“בטל“ של הדפדפן (document.execCommand('undo')) הוא מחסנית אחת לכל העמוד. נמדד בכרומיום, בעמוד העריכה: אחרי הקלדה בעורך ואחריה בשדה שם הקובץ, הוא ביטל את מה שהוקלד בשם הקובץ, גם כשהפוקוס הועבר קודם ל-textarea; והוא העביר את הפוקוס ל-textarea, כלומר בטאבלט היה פותח מקלדת. ההסבר בקוד — ב-runHistoryCommand.
שמירת העדפות משתמש – שני נתיבי API
כדי לשמור תאימות לאחור, מומלץ לכתוב לשני נתיבים:
POST /api/ui_prefsPOST /api/user/preferences
async function savePrefs(prefs) {
const body = JSON.stringify(prefs);
const headers = { 'Content-Type': 'application/json' };
// כתיבה לשני מסלולים (best-effort)
await Promise.allSettled([
fetch('/api/ui_prefs', { method: 'POST', headers, body }),
fetch('/api/user/preferences', { method: 'POST', headers, body }),
]);
}
savePrefs({ wrap: true, fontSize: 14, theme: 'ocean' });
שדות טיפוסיים: wrap, fontSize, theme, tabSize.
המלצות
אחסון לוקאלי משלים (
localStorage) להאצת טעינה.ולידציה צד־שרת לערכים חריגים.
לוגים מאוחדים עם
request_idעבור פעולות עריכה ושמירת העדפות.