בטא בקרוב. הפיצ׳ר עדיין בפיתוח, ולכן שמות ופרטים עשויים להשתנות לפני השחרור.

עורך ויזואלי

לוחצים על רכיב באפליקציה שרצה ומגיעים לקוד שמצייר אותו. העורך הוויזואלי הוא מצב בפני עצמו: האפליקציה גדולה במרכז, הקוד לצידה, הצ'אט עם הסוכן מימין והקומפוננטות שלכם למטה. ממזערים אותו, וה-IDE חוזר בדיוק כפי שהשארתם אותו.

Bronze המצב, מעבר עכבר, לחיצה שמובילה לקוד ונתיב הרכיב כלולים ב-Bronze ומעלה. Silver הרכיב בצ'אט, עריכת props וסגנונות וספריית הקומפוננטות כלולים ב-Silver, Gold ו-Platinum. בתוכנית אחרת הכפתור נשאר ומציג איזו תוכנית כוללת אותו.

מצב העורך הוויזואלי בחנות React: ProductCard.jsx לצד התצוגה המקדימה החיה, שורת הנתיב מתחת לתצוגה, הכפתור הנבחר כצ'יפ בצ'אט עם הסוכן ופס הקומפוננטות עם כרטיסים חייםמצב העורך הוויזואלי בחנות React: ProductCard.jsx לצד התצוגה המקדימה החיה, שורת הנתיב מתחת לתצוגה, הכפתור הנבחר כצ'יפ בצ'אט עם הסוכן ופס הקומפוננטות עם כרטיסים חיים
מצב העורך הוויזואלי בחנות React: ProductCard.jsx לצד התצוגה המקדימה החיה, שורת הנתיב מתחת לתצוגה, הכפתור הנבחר כצ'יפ בצ'אט עם הסוכן ופס הקומפוננטות עם כרטיסים חיים

פתיחת העורך הוויזואלי

פותחים את האפליקציה ב-App Preview (שרת פיתוח שרץ, פורט או כל כתובת), ולוחצים על Visual edit בסרגל שלה, על העיפרון Visual Editor בשורת הכותרת, או מקישים ⌥⇧V (Alt+Shift+V) כשהתצוגה המקדימה בפוקוס. App Preview: Toggle Visual Edit ב-Find Action עושה אותו דבר.

המצב מסדר:

  • את התצוגה המקדימה החיה גדולה במרכז, עם לשונית לכל דף (ולכל קומפוננטה מוצמדת) וסרגל בשורה אחת: כתובת, פורט, תפריט מכשיר Responsive, רוחב × גובה, זום, Visual edit, Pick element, ספריית הקומפוננטות ו-Run (מפעיל את הסקריפט dev, start או serve בטרמינל);
  • את הקוד לצידה: הקבצים הפתוחים כלשוניות, והקובץ של הרכיב הנבחר בשורה שלו;
  • את הצ'אט עם הסוכן מימין;
  • את ספריית הקומפוננטות כפס למטה.

Minimize בלשוניות התצוגה המקדימה, Esc, ⌥⇧V או אותו כפתור סוגרים את המצב ומחזירים את ה-IDE בדיוק כפי שהיה: הלשוניות, הסרגל הצדדי והפאנל התחתון. פותחים שוב, וממשיכים מאיפה שהפסקתם.

מעבר עכבר, לחיצה, ישר לקוד

  • מעבר עכבר מסמן את הרכיב שמתחת לסמן. התגית שלו מציגה קודם את הקומפוננטה, ואחר כך את הרכיב והגודל: PayButton · button.pay.primary 73×35.
  • לחיצה בוחרת את הרכיב. המסגרת שלו נשארת, והקובץ שלו נפתח לצד התצוגה המקדימה עם הסמן בשורה ובעמודה של הרכיב. ממשיכים ללחוץ: כל לחיצה בוחרת את הרכיב הבא.
  • קישורים וכפתורים נבחרים, לא נפתחים ולא נלחצים.

לומר לסוכן בצ'אט

הרכיב הנבחר נכנס לצ'אט עם הסוכן כצ'יפ, button.buy · ProductCard.jsx:8. כותבים לידו מה רוצים ("שיתאים לעיצוב: שיהיה כתוב לתשלום 72.00 €") ושולחים: הסוכן מקבל את נתיב הרכיב, ה-props, הקובץ והשורה, הסלקטור, הסגנונות וה-HTML יחד עם המילים שלכם. לחיצה חדשה מחליפה את הצ'יפ, כך שבצ'אט תמיד נמצא הרכיב שאתם מסתכלים עליו. מעבר עכבר על הצ'יפ מציג את הקובץ, השורה והרכיב; אייקון ההעתקה שעליו מעתיק את כל פרטי הרכיב.

כששני מקומות בקוד מתאימים לרכיב באותה מידה (אותו כפתור כתוב פעמיים), הצ'יפ מציג את שניהם, Toolbar.jsx:9 Toolbar.jsx:5. לוחצים על אחד: הוא נפתח, והוא זה שהעריכות והסוכן משתמשים בו.

צ'יפ הבחירה בצ'אט עם הסוכן עם שני מקומות לבחירה ב-Toolbar.jsxצ'יפ הבחירה בצ'אט עם הסוכן עם שני מקומות לבחירה ב-Toolbar.jsx
צ'יפ הבחירה בצ'אט עם הסוכן עם שני מקומות לבחירה ב-Toolbar.jsx

שורת הנתיב של הרכיב

מתחת לתצוגה המקדימה, שורת הנתיב מציגה דף › … › קומפוננטה › רכיב כשהרכיב הנבחר מודגש, ומימין: Open source עם הקובץ והשורה, אייקון ה-props, נעץ שמוסיף את הקומפוננטה כלשונית בתצוגה המקדימה, ו-× לניקוי הבחירה.

עריכת props וסגנונות

אייקון ה-props בשורת הנתיב פותח פאנל לצד הדף (הדף מצטמצם, כך שכל הרכיבים נשארים לחיצים; Esc או × סוגרים אותו) עם ה-props או המאפיינים של הרכיב והסגנונות שלו. מעבירים עכבר על ערך ולוחצים ✎ (או לחיצה כפולה), מקלידים ולוחצים Enter:

מהנכתב אל
textהטקסט הפשוט שבין התגיות ב-JSX: ‏<h3>Order total</h3> הופך ל-<h3>Your total</h3>
prop או מאפייןערך הטקסט שלו ב-JSX, עם המירכאות שלו: label="Apply", title='…', size={"lg"}; ‏class נכתב כ-className
Add attribute‏name=value מוסיף מאפיין חדש לתגית HTML
סגנוןכלל ה-CSS של המחלקה של הרכיב (.buy { border-radius: 14px; }) או כלל ה-CSS module שלו (styles.pay); כשאין כלל, ‏style={{ … }} בתוך הרכיב

כל שינוי הוא עריכה אחת שאפשר לבטל בעורך של הקובץ, הקובץ נשמר, והדף מציג אותו מיד בזמן ששרת הפיתוח נטען מחדש. הערה מציינת לאן הוא נכתב.

‏Ingot אף פעם לא מנחש: ביטוי (value={total}), תגיות מקוננות, prop שהקומפוננטה לא כותבת ב-JSX שלה, או סגנון ששני כללי CSS יכולים לקבל — נשארים כמו שהם. ההערה מסבירה למה, והבקשה נכנסת לתיבת הצ'אט (Set color to … (it could go in .blurb in src/shop.css:26 or .blurb in src/extra.css:1)), כך שלחיצה על Enter מעבירה אותה לסוכן.

חלון ה-props והסגנונות אחרי עריכת סגנון ששני כללי CSS יכולים לקבל, עם הבקשה בתיבת הצ'אטחלון ה-props והסגנונות אחרי עריכת סגנון ששני כללי CSS יכולים לקבל, עם הבקשה בתיבת הצ'אט
חלון ה-props והסגנונות אחרי עריכת סגנון ששני כללי CSS יכולים לקבל, עם הבקשה בתיבת הצ'אט

ספריית הקומפוננטות

הפס למטה מציג את הקומפוננטות שלכם (לפי תיקייה) ואת חבילות ה-UI שלכם (הקומפוננטות שה-API שלהן מייצא, כפי שהן ב-node_modules). מחפשים, בוחרים תיקייה או חבילה, ו:

  • כרטיסים חיים מציגים קומפוננטה כפי שהדף מצייר אותה עכשיו; קומפוננטות שלא מופיעות בדף מציגות את השם ואת הרכיב החיצוני שלהן.
  • גוררים כרטיס לקוד כדי לכתוב <Name /> במקום שבו משחררים, או לתצוגה המקדימה כדי לכתוב אותו אחרי הרכיב שמתחת לסמן. ה-import נוסף כשהוא חסר בקובץ: נתיב יחסי לקומפוננטות שלכם, ושם החבילה לחבילות.
  • + From selection מבקש מהסוכן, בתיבת הצ'אט, קומפוננטה חדשה מהרכיב הנבחר.
  • Open package פותח את ה-package.json שלה; Update to x.y.z מופיע כשיש גרסה חדשה יותר ומריץ את ההתקנה בטרמינל. לחיצה כפולה על כרטיס פותחת את הקומפוננטה.

עבודה משותפת

בסשן Ingot Together, הרכיבים שחברי הצוות בחרו באותו דף מוצגים עם מסגרת בצבע שלהם והשם שלהם, וראשי התיבות שלהם מופיעים בלשוניות התצוגה המקדימה.

הבחירות של שני חברי צוות בתצוגה המקדימה, כל אחת עם מסגרת ותגית שםהבחירות של שני חברי צוות בתצוגה המקדימה, כל אחת עם מסגרת ותגית שם
הבחירות של שני חברי צוות בתצוגה המקדימה, כל אחת עם מסגרת ותגית שם

איך Ingot מוצא את הקוד

שום דבר לא מתווסף לפרויקט שלכם: בלי פלאגין, בלי חבילה, בלי קובץ הגדרות, ולא משנה איך מפעילים את שרת הפיתוח. ‏Ingot מחזיק אינדקס משלו של ה-JSX, ה-TSX, ה-HTML, ה-Vue וה-Svelte של הפרויקט (בזיכרון, אף פעם לא נכתב לפרויקט) ומשווה אליו כל לחיצה:

  1. האינדקס. כל רכיב שכתוב בקוד, עם הקובץ, השורה והעמודה שלו, התגית או הקומפוננטה, הקומפוננטה שהקוד שלה כותב אותו, שמות המחלקות הקבועים, הטקסט שלו, ומאפיינים שמזהים אותו (id, data-testid, aria-label, href, type, placeholder ועוד). שמירת קובץ מעדכנת את האינדקס מיד.
  2. הלחיצה. התצוגה המקדימה שולחת את מה שהדף יודע על הרכיב: תגית, מחלקות, טקסט, אותם מאפיינים, הרכיבים שסביבו, ושמות הקומפוננטות שהפריימוורק נותן בזמן ריצה, אם יש.
  3. ההתאמה הטובה ביותר נפתחת. ‏Ingot נותן ציון לכל מקום שיכול היה לצייר את הרכיב ופותח את הטוב ביותר בשורה המדויקת. מחלקות של CSS modules מתאימות למפתח שלהן (styles.pay הוא _pay_x1y2 בדף), ושימוש בקומפוננטה נמצא לפי הטקסט שהוא מעביר (<PayButton label="Apply" /> לכפתור שכתוב עליו Apply).

רכיב שמצויר בתוך קומפוננטה של ספרייה מוביל לקוד שלכם שמשתמש בה (ה-<Button> בדף שלכם, לא הקובץ של הספרייה).

מה ש-build של פיתוח אומר על עצמו (data-ingot-source, מידע פיתוח של React 18, ‏Vue ו-Svelte) משמש רק כאות נוסף. הוא אף פעם לא נדרש: React 19, ‏JSX פשוט וכל bundler עובדים אותו דבר.

הגדרות

הגדרהאיפהברירת מחדל
ingot.appPreview.visualEditorSettings › Features › Visual editorפעיל
ingot.appPreview.visualEditor.sourceIndexSettings › Features › Find the source in Ingot's indexפעיל
ingot.appPreview.visualEditor.componentLibrarySettings › Features › Component libraryפעיל
ingot.appPreview.visualEditor.openSourceOnSelectSettings › Tools › Visual editorפעיל
ingot.appPreview.visualEditor.styleEditsSettings › Tools › Visual editor › Write style edits to CSSפעיל

כשפתיחת הקוד בבחירה כבויה, לחיצה רק בוחרת; פותחים את הקובץ עם Open source בשורת הנתיב. כשכתיבת סגנונות ל-CSS כבויה, הסגנונות נכתבים בתוך הרכיב.

טוב לדעת

  • Pick element ב-App Preview (מחוץ למצב) עדיין בוחר רכיב אחד לסוכן ואז נעצר.
  • מצב העורך הוויזואלי אף פעם לא משנה את הפריסה השמורה שלכם: מזעור תמיד מחזיר לפריסה שהייתה.