We want to hear from you!Take our 2021 Community Survey!
אתר זה אינו מעודכן יותר.עבור אל react.dev

טפסים

These docs are old and won’t be updated. Go to react.dev for the new React docs.

These new documentation pages teach modern React and include live examples:

אלמנטים של טפסיHTML עובדים מעט שונה מאשר אלמנטים אחרים של ה-DOM ב-React, מכיוון שאלמנטים של טפסים באופן טבעי שומרים על state פנימי. למשל, הטופס הבא ב-HTML מקבל שם אחד:

<form>
  <label>
    שם:
    <input type="text" name="name" />
  </label>
  <input type="submit" value="Submit" />
</form>

לטופס זה יש את התנהגות ברירת המחדל של טפסי HTML של מעבר לדף חדש כאשר המשתמש שולח את הטופס. אם אתם רוצים את התנהגות זו ב-React, ככה זה עובד. אבל ברוב המקרים, זה נוח שיש פונקצית JavaScript המטפלת בשליחת הטופס ויש לה גישה לנתונים שהמשתמש הכניס לטופס. הדרך הסטנדרטית להשיג זאת היא באמצעות טכניקה הנקראת “קומפוננטות מבוקרות”.

קומפוננטות מבוקרות

ב-HTML, אלמנטים של טופס כגון <input>, <textarea>, ו-<select>שומרים בדרך כלל על מצבם ומעדכנים אותו על סמך קלט מהמשתמש. ב-React, state בר-שינוי נשמר בדרך כלל במאפייני ה-state של קומפוננטות, ומעודכן רק עם setState().

אנחנו יכולים לשלב את השניים על ידי הפיכת ה-state של React להיות “single source of truth” (מקור אמת יחיד). לאחר מכן קומפוננטת ה-React שמרנדרת טופס גם שולטת במה שקורה באותו טופס על קלט המשתמש הבא. קלט מאלמנט טופס שערכו נשלט על ידי React בדרך זו נקרא “קומפוננטה מבוקרת”.

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

class NameForm extends React.Component {
  constructor(props) {
    super(props);
    this.state = {value: ''};
    this.handleChange = this.handleChange.bind(this);
    this.handleSubmit = this.handleSubmit.bind(this);
  }

  handleChange(event) {    this.setState({value: event.target.value});  }
  handleSubmit(event) {
    alert('שם חדש נשלח: ' + this.state.value);
    event.preventDefault();
  }

  render() {
    return (
      <form onSubmit={this.handleSubmit}>        <label>
          שם:
          <input type="text" value={this.state.value} onChange={this.handleChange} />        </label>
        <input type="submit" value="שלח" />
      </form>
    );
  }
}

נסו זאת ב-CodePen

עם קומפוננטה נשלטת, ערך הקלט תמיד מונע על ידי ה-state. למרות שזה אומר שיש צורך בכתיבת יותר קוד, עכשיו ניתן להעביר את הערך לאלמנטי UI אחרים גם, או לאתחל אותו מ-event handlers אחרים.

תגית ה-textarea

ב-HTML, אלמנט <textarea> מגדיר את הטקסט שלו על ידי הילדים שלו:

<textarea>
  היי, זה מעט טקסט ב-textarea
</textarea>

ב-React, <textarea> משתמש במאפיין value במקום. בדרך זו, טופס המשתמש ב-<textarea> יכול להכתב באופן מאוד דומה לטופס המשתמש ב-input של שורה אחת:

class EssayForm extends React.Component {
  constructor(props) {
    super(props);
    this.state = {      value: 'אנא כתבו מאמר אודות אלמנט ה-DOM האהוב עליכם.'    };
    this.handleChange = this.handleChange.bind(this);
    this.handleSubmit = this.handleSubmit.bind(this);
  }

  handleChange(event) {    this.setState({value: event.target.value});  }
  handleSubmit(event) {
    alert('מאמר נשלח: ' + this.state.value);
    event.preventDefault();
  }

  render() {
    return (
      <form onSubmit={this.handleSubmit}>
        <label>
          Essay:
          <textarea value={this.state.value} onChange={this.handleChange} />        </label>
        <input type="submit" value="שלח" />
      </form>
    );
  }
}

שימו לב ש-this.state.value מאותחל בבנאי, כך שה-text area מאותחל עם קצת טקסט בתוכו.

תגית select

ב-HTML, <select> מייצר רשימה נפתחת. למשל, ה-HTML הבא מייצר רשימה נפתחת של טעמים:

<select>
  <option value="grapefruit">אשכולית</option>
  <option value="lime">ליים</option>
  <option selected value="coconut">קוקוס</option>
  <option value="mango">מנגו</option>
</select>

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

class FlavorForm extends React.Component {
  constructor(props) {
    super(props);
    this.state = {value: 'coconut'};
    this.handleChange = this.handleChange.bind(this);
    this.handleSubmit = this.handleSubmit.bind(this);
  }

  handleChange(event) {    this.setState({value: event.target.value});  }
  handleSubmit(event) {
    alert('הטעם האהוב עליך: ' + this.state.value);
    event.preventDefault();
  }

  render() {
    return (
      <form onSubmit={this.handleSubmit}>
        <label>
          Pick your favorite flavor:
          <select value={this.state.value} onChange={this.handleChange}>            <option value="grapefruit">אשכולית</option>
            <option value="lime">ליים</option>
            <option value="coconut">קוקוס</option>
            <option value="mango">מנגו</option>
          </select>
        </label>
        <input type="submit" value="שלח" />
      </form>
    );
  }
}

נסו זאת ב-CodePen

באופן כללי, זה גורם לכך ש-<input type="text">, <textarea>, ו-<select> כולם עובדים באופן מאוד דומה - כולם מקבלים מאפיין value שבו ניתן להשתמש כדי לממש קומפוננטה מבוקרת.

הערה

ניתן להעביר למאפיין value מערך, המאפשר לכם לבחור אפשרויות מרובות בתגית select:

<select multiple={true} value={['B', 'C']}>

תגית ה-file input

ב-HTML, תגית <input type="file"> מאפשרת למשתמש לבחור קובץ אחד או יותר מזכרון המכשיר שלהם להעלאה לשרת או לביצוע מניפולציות על ידי JavaScript דרך ה-File API.

<input type="file" />

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

טיפול בקלטים מרובים

כאשר אתם צריכים להתמודד עם מספר אלמנטי input מבוקרים, אתם יכולים להוסיף מאפיין name לכל אלמנט ולתת לפונקציה המטפלת לבחור מה לעשות על סמך הערך של event.target.name.

לדוגמה:

class Reservation extends React.Component {
  constructor(props) {
    super(props);
    this.state = {
      isGoing: true,
      numberOfGuests: 2
    };

    this.handleInputChange = this.handleInputChange.bind(this);
  }

  handleInputChange(event) {
    const target = event.target;
    const value = target.type === 'checkbox' ? target.checked : target.value;
    const name = target.name;
    this.setState({
      [name]: value    });
  }

  render() {
    return (
      <form>
        <label>
          מגיעים:
          <input
            name="isGoing"            type="checkbox"
            checked={this.state.isGoing}
            onChange={this.handleInputChange} />
        </label>
        <br />
        <label>
          מספר אורחים:
          <input
            name="numberOfGuests"            type="number"
            value={this.state.numberOfGuests}
            onChange={this.handleInputChange} />
        </label>
      </form>
    );
  }
}

נסו זאת ב-CodePen

שימו לב כיצד אנו משתמשים בתחביר שם מאפיין מחושב של ES6 כדי לעדכן את מפתח ה-state בהתאמה לשם הקלט שהתקבל:

this.setState({
  [name]: value});

זה שווה ערך לקוד ה-ES5 הזה:

var partialState = {};
partialState[name] = value;this.setState(partialState);

בנוסף, מאחר ש-setState() ממזגת state חלקי ל-state הנוכחי אוטומטית, אנחנו רק צריכים לקרוא לה עם החלקים השתנו.

ערך ריק בקלט מבוקר

ציון ערך ה-prop על קומפוננטה מבוקרת מונעת מהמשתמש לשנות את הקלט אלא אם כן אתם חפצים בכך. אם ציינתם ערך value אבל ה-input עדיין ניתן לעריכה, יכול להיות שבטעות הגדרתם את value ל-undefined או null.

הקוד הבא מדגים זאת. (ה-input נעול בהתחלה, אך הופך לניתן לעריכה לאחר עיכוב קצר).

ReactDOM.render(<input value="היי" />, mountNode);
setTimeout(function() {
  ReactDOM.createRoot(mountNode).render(<input value={null} />);
}, 1000);

אלטרנטיבות לקומפוננטות מבוקרות

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

פתרונות כוללים

אם אתם מחפשים פתרון מלא הכולל אימות, מעקב אחר שדות שבוקרו, וטיפול בשליחת טופס, Formik היא אחת האפשרויות הפופולריות. עם זאת, הוא בנוי על אותם עקרונות של קומפוננטות מבוקרות וניהול state — אז אל תזניחו לימוד שלהם.

האם התוכן בעמוד זה היה שימושי?לעריכת העמוד הנוכחי