לימוד React
תיאור ה-UI

ייבוא וייצוא קומפוננטות

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

You will learn

  • מהו קובץ קומפוננטת שורש
  • איך לייבא ולייצא קומפוננטה
  • מתי להשתמש בייבוא/ייצוא סטייל ברירת מחדל ומתי סטייל בשם
  • איך לייבא ולייצא כמה קומפוננטות מאותו קובץ
  • איך לפצל קומפוננטות לכמה קבצים

קובץ קומפוננט השורש

ב-הקומפוננטה הראשונה שלכם, יצרתם קומפוננטת פרופיל וקומפוננטת גלריה שמרנדרת אותה:

function Profile() {
  return (
    <img
      src="https://i.imgur.com/MK3eW3As.jpg"
      alt="Katherine Johnson"
    />
  );
}

export default function Gallery() {
  return (
    <section>
      <h1>Amazing scientists</h1>
      <Profile />
      <Profile />
      <Profile />
    </section>
  );
}

כרגע שתיהן נמצאות ב-** קובץ קומפוננטת השורש**, שנקרא בדוגמה הזו App.js. בהתאם ל-setup שלכם, קומפוננטת השורש יכולה להיות בקובץ אחר. אם אתם משתמשים ב-framework עם ניתוב מבוסס קבצים, כמו Next.js, קומפוננטת השורש תהיה שונה בכל עמוד.

ייצוא וייבוא ​​של קומפוננטה

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

  1. צרו קובץ JS חדש שיכיל את הקומפוננטות.
  2. ייצאו את קומפוננטת הפונקציה מהקובץ (באמצעות ייצוא ברירת מחדל או שם).
  3. ייבאו אותה בקובץ שבו תשתמשו בה (באמצעות תחביר הייבוא המתאים לייצוא default או שם).

כאן גם פרופיל וגם Gallery הועברו מ-App.js לקובץ חדש בשם Gallery.js. עכשיו אפשר לעדכן את App.js כך שייבא את Gallery מתוך Gallery.js:

import Gallery from './Gallery.js';

export default function App() {
  return (
    <Gallery />
  );
}

שימו לב איך הדוגמה מחולקת עכשיו לשני קובצי קומפוננטות:

  1. Gallery.js:
    • מגדיר את הקומפוננטה פרופיל, שמשמשת רק בתוך אותו קובץ זה לא יוצאת.
    • מייצא את הקומפוננטה גלריה כ-ייצוא ברירת מחדל.
  2. ‘App.js’:
    • מייבא את Gallery לפי ייבוא ​​ברירת מחדל מתוך Gallery.js.
    • מייצא את קומפוננטת השורש App כ-ייצוא ברירת מחדל.

Note

אפשר שתיתקלו בקבצים שמשמיטים את סיומת .js, למשל:

import Gallery from './Gallery';

גם './Gallery.js' וגם './Gallery' יעבדו ב-React, אבל אפשרות ראשונה קרובה יותר לאופן של Native ES Modules.

Deep Dive

ייצוא ברירת מחדל לעומת ייצוא בשם

יש שתי דרכים עיקריות לייצא ערכים ב-JavaScript: ייצוא ברירת מחדל וייצוא בשם. עד עכשיו הדוגמאות השתמשו רק ב-default, אבל אפשר להשתמש באחת מהשיטות אושתיהן בקובץ. ל יכול קובץ להיות לכל היותר ייצוא default אחד, אבל אפשר שיהיו בו כמה ייצואי named שרוצים.

ייצוא ברית מחדל וייצוא בשם

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

תחבירהצהרת ייצואהצהרת ייבוא ​​
ברית מחדליצוא פונקציית ברירת המחדל Button() {}לחצן ייבוא ​​מ'./Button.js';
בשםExport function Button() {}ייבוא{ Button } מ-'./Button.js';

כשכותבים ייבוא ​​_default_, אפשר לבחור כל שם אחרי יבוא. אפשר למשל לכתוב יבוא בננה מ'./Button.js', ועדיין תקבל את אותו ייצוא ברירת המחדל. לעומת זאת, בשם חייב להיות זה בשני הצדדים. לכן קוראים לו ייבוא ​​_named_.

בדרך כלל משתמשים ב-default export כשקובץ מייצא קומפוננטה אחת בלבד, וב-named exports תוך כמה קומפוננטות או ערכים שת. בלי קשר לסגנון בחירתו, חשוב לתת שמות משמעותיים לפונקציות הקומפוננטה ולקבצים שמכילים אותן. קומפוננטות ללא שם, כמו ייצוא ברירת מחדל () => {}, פחות מומלצות כי הן מקשות על דיבוג.

ייצוא וייבוא ​​של כמה קומפוננטות מאותו קובץ

מה אם תרצו להציג רק פרופיל אחד במקום גלריה שלמה? אפשר גם לייצא את פרופיל. אבל ל-Gallery.js כבר יש ייצוא ברירת מחדל, ואי אפשר שיהיו שני ייצואי ברירת מחדל בקובץ. אפשר ליצור קובץ חדש עם ייצוא ברירת מחדל, או להוסיף ייצוא שם עבור פרופיל. ל יכול להיות רק יצוא ברירת מחדל אחד, אבל הוא יכול להכיל הרבה יצוא בשם.

Note

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

קודם ייצאו את פרופיל מתוך Gallery.js באמצעות ייצוא שם (בלי מילת המפתח ברירת מחדל):

export function Profile() {
  // ...
}

לאחר ייבאו את פרופיל מ-Gallery.js אל App.js הוא באמצעות יבוא בשם (עם סוגרים מסולסלים):

import { Profile } from './Gallery.js';

לבסוף, רנדרו את <פרופיל /> מתוך הקומפוננטה אפליקציה:

export default function App() {
  return <Profile />;
}

עכשיו Gallery.js כולל שני ייצואים: ייצוא ברירת מחדל של Gallery, ויצוא בשם פרופיל. הקובץ App.js מייבא את שניהם. נסו להחליף בדוגמה בין <Profile /> ל-<Gallery /> וחזרה:

import Gallery from './Gallery.js';
import { Profile } from './Gallery.js';

export default function App() {
  return (
    <Profile />
  );
}

עכשיו אתם משתמשים בשילוב של יצוא ברירת מחדל ושמו:

  • Gallery.js:
    • מייצא את הקומפוננטה פרופיל כ-** בשם ייצוא בשם פרופיל**.
    • מייצא את הקומפוננטה גלריה כ-ייצוא ברירת מחדל.
  • App.js:
    • מייבא את פרופיל לפי ייבואבשם פרופיל מתוך Gallery.js.
    • מייבא את Gallery לפי ייבוא ​​ברירת מחדל מתוך Gallery.js.
    • מייצא את קומפוננטת השורש App כ-ייצוא ברירת מחדל.

Recap

בעמוד הזה למדתם:

  • מהו קובץ קומפוננטת שורש
  • איך לייבא ולייצא קומפוננטה
  • מתי ואיך להשתמש בייבוא/ייצוא ברירת מחדל ו-named
  • איך לייצא כמה קומפוננטות מאותו קובץ

Try out some challenges

Challenge 1 of 1:
פצלו את הקומפוננטות עוד יותר

כרגע Gallery.js מייצא גם את פרופיל וגם את Gallery, וזה מעט מבלבל.

העבירו את הקומפוננטה פרופיל לקובץ נפרד בשם Profile.js, ואז עדכנו את הקומפוננטה אפליקציה כך שתרנדר גם את <Profile /> וגם את <Gallery /> אחד אחרי השני.

אפשר להשתמש בייצוא ברירת מחדל או בשם עבור פרופיל, אבל ודאו את המשתמשים בתחביר הייבוא ​​המתאים גם ב-App.js וגם ב-Gallery.js. אפשר להיעזר בטבלה מה-Deep Dive למעלה:

תחבירהצהרת ייצואהצהרת ייבוא ​​
ברית מחדליצוא פונקציית ברירת המחדל Button() {}לחצן ייבוא ​​מ'./Button.js';
בשםExport function Button() {}ייבוא{ Button } מ-'./Button.js';
// Move me to Profile.js!
export function Profile() {
  return (
    <img
      src="https://i.imgur.com/QIrZWGIs.jpg"
      alt="Alan L. Hart"
    />
  );
}

export default function Gallery() {
  return (
    <section>
      <h1>Amazing scientists</h1>
      <Profile />
      <Profile />
      <Profile />
    </section>
  );
}

אחרי שזה עובד עם סוג ייצוא אחד, נסו לגרום לזה לעבוד גם עם הסוג השני.

Previousהקומפוננטה הראשונה שלכם
Nextכתיבת Markup עם JSX

How do you like these docs?