We want to hear from you!Take our 2021 Community Survey!
This site is no longer updated.Go to react.dev

التصيير الشرطي (Conditional Rendering)

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:

من خلال React، يمكنك أن تنشئ مكونات (Components) متميزة، والتي تغلف السلوك الذي تريده. ثم يمكنك أن تعرض فقط بعض هذه المكونات، بناءً على الحالة (State) في التطبيق الخاص بك.

العرض الشرطي في React يعمل بنفس طريقة عمل العرض الشرطي في لغة JavaScript. قم باستخدام المعاملات الخاصة بلغة JavaScript، مثل if أو conditional operator لإنشاء العناصر التي تمثل الحالة (State)، وسوف يقوم React بتحديث الواجهه الأماميه (UI) لمطابقتها.

انظر إلى هذين المكوّنين:

function UserGreeting(props) {
  return <h1>Welcome back!</h1>;
}

function GuestGreeting(props) {
  return <h1>Please sign up.</h1>;
}

سوف ننشئ مكونًا (Component) لتحية المستخدم، والذي يعرض أحد هذين المكوّنين بناءً على حالة تسجيل دخول المستخدم:

function Greeting(props) {
  const isLoggedIn = props.isLoggedIn;
  if (isLoggedIn) {    return <UserGreeting />;  }  return <GuestGreeting />;}
const root = ReactDOM.createRoot(document.getElementById('root')); 
// Try changing to isLoggedIn={true}:
root.render(<Greeting isLoggedIn={false} />);

جرّب المثال على موقع CodePen

هذا المثال يعرض تحية مختلفة بناءً على قيمة الخاصيّة isLoggedIn.

متغيرات العناصر (Element Variables)

يمكنك استخدام المتغيرات لحفظ العناصر. هذا يجعلك قادراً على تصيير جزء من المكوّنً شَرطيّا، بينما باقي المخرجات لا تتغير.

انظر إلى هذين المكوّنين الجديدين، والذين يمثلان أزرارًا لتسجيل الدخول والخروج للمستخدم:

function LoginButton(props) {
  return (
    <button onClick={props.onClick}>
      Login
    </button>
  );
}

function LogoutButton(props) {
  return (
    <button onClick={props.onClick}>
      Logout
    </button>
  );
}

في المثال التالي، سوف نقوم بإنشاء مكوّن صنف stateful component يسمى LoginControl.

سوف يقوم بتصيير إما <LoginButton /> أو <LogoutButton />، بناءً على حالة المكوّن. سوف يقوم أيضاً بتصيير مكوّن تحية المستخدم، والذي رأيناه في المثال السابق:

class LoginControl extends React.Component {
  constructor(props) {
    super(props);
    this.handleLoginClick = this.handleLoginClick.bind(this);
    this.handleLogoutClick = this.handleLogoutClick.bind(this);
    this.state = {isLoggedIn: false};
  }

  handleLoginClick() {
    this.setState({isLoggedIn: true});
  }

  handleLogoutClick() {
    this.setState({isLoggedIn: false});
  }

  render() {
    const isLoggedIn = this.state.isLoggedIn;
    let button;
    if (isLoggedIn) {      button = <LogoutButton onClick={this.handleLogoutClick} />;    } else {      button = <LoginButton onClick={this.handleLoginClick} />;    }
    return (
      <div>
        <Greeting isLoggedIn={isLoggedIn} />        {button}      </div>
    );
  }
}

const root = ReactDOM.createRoot(document.getElementById('root')); 
root.render(<LoginControl />);

جرّب المثال على موقع CodePen

يعتبر استخدام المتغيرات والتعبير الشرطي if طريقةً سليمةً للتصيير الشرطيّ للمكوّن، إلا أنّك في بعض الأحيان قد ترغب في استخدام صياغة أقصر. هناك بعض الطرق تُمَكّنك من استخدام التعبير الشرطي المباشر في JSX، سيتم شرح هذه الطرق لاحقا.

التعبير الشرطي المباشر بإستخدام معامل && المنطقي

يمكنك تضمين أيّ تعبيرات في JSX من خلال تغليفهم داخل القوسين المعقوصين {}. يتضمن هذا معامل && المنطقي في JavaScript. قد يصبح هذا سهل الاستخدام لتضمين عنصر بشكل شرطي:

function Mailbox(props) {
  const unreadMessages = props.unreadMessages;
  return (
    <div>
      <h1>Hello!</h1>
      {unreadMessages.length > 0 &&        <h2>          You have {unreadMessages.length} unread messages.        </h2>      }    </div>
  );
}

const messages = ['React', 'Re: React', 'Re:Re: React'];

const root = ReactDOM.createRoot(document.getElementById('root')); 
root.render(<Mailbox unreadMessages={messages} />);

جرّب المثال على موقع CodePen

هذا المثال يعمل بنجاح لأنه في JavaScript، التعبير true && expression دائماً يعطي الناتج expression، و التعبير false && expression دائماً يعطي الناتج false.

ولذلك، إذا كان الشرط يعطي الناتج true، فإن العنصر المحدد بعد && سوف يظهر في المخرجات. وإذا كان الناتج false، فإن React سوف تهمل العنصر وتتخطّاه.

لاحظ أن إرجاع تعبير خاطئ سيؤدي إلى تخطي العنصر بعد && ولكنه سيعيد التعبير الخاطئ. في المثال أدناه ، سيتم إرجاع <div> 0 </div> من خلال طريقة العرض.

render() {
  const count = 0;  return (
    <div>
      {count && <h1>Messages: {count}</h1>}    </div>
  );
}

التعبير الشرطي المباشر (If-Else) باستخدام المعامل الشرطي

طريقه أخرى للتصيير الشرطي المباشر في JSX هي استخدام المعامل الشرطي condition ? true : false.

في المثال التالي، سوف نستخدم هذه الطريقة لتصيير نص قصير بشكل شرطي:

render() {
  const isLoggedIn = this.state.isLoggedIn;
  return (
    <div>
      The user is <b>{isLoggedIn ? 'currently' : 'not'}</b> logged in.    </div>
  );
}

يمكن استخدام هذه الطريقة أيضاً في التعبيرات الأكبر، بالرغم من أن ذلك يجعل الأمر أقل وضوحاً لفهم ما يحدث:

render() {
  const isLoggedIn = this.state.isLoggedIn;
  return (
    <div>
      {isLoggedIn        ? <LogoutButton onClick={this.handleLogoutClick} />
        : <LoginButton onClick={this.handleLoginClick} />      }
    </div>  );
}

كما هو الحال في JavaScript، يمكنك اختيار النمط المناسب بناءً على ما تعتبره أنت وفريقك أكثر سهولة في القراءة. تذكّر أيضاً أنّه عندما يصبح التعبير الشرطي أكثر تعقيداً، قد يكون هذا هو الوقت المناسب لـ استخلاص مكوّن.

منع المكوّن (Component) من التصيير

في بعض الحالات النادرة، قد تفضّل أن تجعل المكوّن يُخفي نفسه، بالرغم من أنّه تم تصييره من خلال مكوّن آخر. يمكنك فعل ذلك من خلال إعطاء الناتج null بدلاً من تصيير مخرجات المكوّن.

في المثال التالي، المكوّن <WarningBanner /> يتم تصييره بناءً على قيمة الخاصيّة warn. إذا كانت قيمة الخاصيّة تساوي false، فإن المكوّن لن يتم تصييره:

function WarningBanner(props) {
  if (!props.warn) {    return null;  }
  return (
    <div className="warning">
      Warning!
    </div>
  );
}

class Page extends React.Component {
  constructor(props) {
    super(props);
    this.state = {showWarning: true};
    this.handleToggleClick = this.handleToggleClick.bind(this);
  }

  handleToggleClick() {
    this.setState(state => ({
      showWarning: !state.showWarning
    }));
  }

  render() {
    return (
      <div>
        <WarningBanner warn={this.state.showWarning} />        <button onClick={this.handleToggleClick}>
          {this.state.showWarning ? 'Hide' : 'Show'}
        </button>
      </div>
    );
  }
}

const root = ReactDOM.createRoot(document.getElementById('root')); 
root.render(<Page />);

جرّب المثال على موقع CodePen

إعطاء الناتج null في التابع render الخاص بالمكوّن لا يؤثر على حدوث التوابع الخاصة بدورة حياة المكوّن (Lifecycle Methods). فمثلاً التابع componentDidUpdate سوف يتم استدعاءه كالمعتاد.

Is this page useful?تحرير هذه الصفحة