Перадача пропсаў у кампанент

Знаёмыя пропсы

Пропсы — гэта інфармацыя, што вы перадаяце ў JSX тэг. Напрыклад: className, src, alt, width, і height — некаторыя пропсы, якія можна перадаць у <img>:

Пропсы, якія можна перадаць у тэг <img> прадвызначаныя (ReactDOM адпавядае стандарту HTML). Але ва ўласныя кампаненты, такія як <Avatar>, вы можаце перадаваць любыя пропсы, каб іх кастамізаваць. Вось як гэта рабіць!

Перадача пропсаў у кампаненты

У гэтым кодзе кампанент Profile не перадае аніводнага пропса свайму дачыннаму кампаненту Avatar:

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

Вы можаце дадаць новыя пропсы для Avatar у два этапы.

Крок 1: Перадаць пропсы дачыннаму кампаненту

Па-першае, перадайце пропсы ў Avatar. Напрыклад, давайце перададзім два пропсы: person (аб’ект) і size (лічба):

export default function Profile() {
  return (
    <Avatar
      person={{ name: 'Лінь Ланьін', imageId: '1bX5QH6' }}
      size={100}
    />
  );
}

Цяпер вы можаце прачытаць гэтыя пропсы знутры кампанента Avatar.

Крок 2: прачытайце пропсы знутры дачыннага кампанента

Вы можаце прачытаць гэтыя пропсы, пералічыўшы іх назвы person, size цераз коску ўнутры ({ і }) адразу пасля function Avatar. Гэта дазволіць вам выкарыстоўваць іх знутры кода Avatar, нібы яны пераменныя.

function Avatar({ person, size }) {
  // person і size цяпер даступныя тут
}

Нарэшце, дадайце некаторую логіку да Avatar, скарыстаўшы пропсы person і size для рэндэрынгу.

Цяпер з дапамогай пропсаў вы можаце змяняць канфігурацыю Avatar, каб рэндэрыць яго па-рознаму. Паспрабуйце пагуляцца са значэннямі!

Пропсы дазваляюць вам успрымаць бацькоўскі і дачынны кампаненты незалежнымі адзін ад аднаго. Напрыклад, вы можаце змяніць пропсы person ці size унутры кампанента Profile нават не задумваючыся ад тым, як кампанент Avatar іх выкарыстоўвае. Аналагічна, вы можаце змяняць тое, як Avatar апрацоўвае гэтыя пропсы, не гледзячы на логіку кампанента Profile.

Вы можаце разглядаць пропсы як «рычажкі», якімі вы можаце рэгуляваць свой кампанент. Яны выконваюць тую ролю, што і аргументы ў функцыі. Да таго ж, пропсы — адзіны аргумент, які перадаецца ў кампанент! Функцыянальны кампанент React прымае толькі адзін кампанент, а іменна аб’ект props:

function Avatar(props) {
  let person = props.person;
  let size = props.size;
  // ...
}

Звычайна вам не будзе патрэбны сам аб’ект props, прасцей будзе разабраць яго на пропсы па адным адразу.

function Avatar({ person, size }) {
  // ...
}

function Avatar(props) {
  let person = props.person;
  let size = props.size;
  // ...
}

Прадвызначаныя значэнні для пропсаў

Калі вы хочаце задаць прадвызначанае значэнне, якое будзе выкарыстоўвацца, калі пропс не вызначаны, вы можаце дадаць = і пасля яго прадвызначанае значэнне:

function Avatar({ person, size = 100 }) {
  // ...
}

Цяпер, калі <Avatar person={...} /> будзе адрэндэрына без пропса size, ягоным значэннем будзе 100.

Прадвызначанае значэнне будзе выкарыстана толькі калі пропс size адсутнічае, ці калі зададзены як size={undefined}. Такія варыянты, як size={null} ці size={0} не будуць замененыя на прадвызначанае значэнне.

Перадача пропсаў з карыстаннем сінтаксіса разгортвання

Часам пропсы пачынаюць шмат паўтарацца:

function Profile({ person, size, isSepia, thickBorder }) {
  return (
    <div className="card">
      <Avatar
        person={person}
        size={size}
        isSepia={isSepia}
        thickBorder={thickBorder}
      />
    </div>
  );
}

Няма нічога дрэннага ў тым, каб паўтараць імёны пропсаў — такі код будзе больш зразумелым. Але магчыма з часам вам захочацца зрабіць яго лаканічней. Некаторыя кампаненты перадаюць свае пропсы дачынным, напрыклад як кампанент Profile перадае іх кампаненту Avatar. Так як кампанент не выкарыстоўвае ўласныя пропсы сам, ёсць сэнс скарыстаць больш лаканічны сінтаксіс разгортвання:

function Profile(props) {
  return (
    <div className="card">
      <Avatar {...props} />
    </div>
  );
}

Гэта перадасць усе пропсы кампанента Profile кампаненту Avatar без іх пераліку спісам.

Карыстайцеся аператарам разгортвання разумна. Калі вы пачынаеце выкарыстоўваць яго ў кожным кампаненце, вы штосьці робіце не так. Часта гэта прыкмета таго, што варта раздзяліць кампаненты і перадаць дачынныя ў выглядзе JSX. Далей разгледзім як гэта зрабіць!

Перадача JSX у якасці дачынных элементаў

Звычайная практыка — укладаць у стандартны набор тэгаў іншыя тэгі:

<div>
  <img />
</div>

Часам вам можа спатрэбіцца зрабіць тое ж самае і з уласнымі кампанентамі:

<Card>
  <Avatar />
</Card>

Калі вы ўкладаеце штосьці ў JSX тэг, бацькоўскі кампанент атрымае кантэнт у якасці пропса пад назвай children. Напрыклад, кампанент Card з прыкладу ніжэй атрымае пропс children, у якім будзе <Avatar />, і адрэндэрыць яго ўнутры div:

Паспрабуйце замяніць <Avatar> унутры <Card> на які-небудзь тэкст каб паглядзець як кампанент Card можа працаваць з розным укладзеным кантэнтам. Яму не трэба «ведаць», што будзе адрэндэрына ўнутры яго. Падобны гібкі шаблон вы яшчэ шмат дзе пабачыце.

Паспрабуйце разгледзіць кампанент з пропсам children як «дзірку», якую бацькоўскі кампанент можа запоўніць разметкай JSX. Вам часта давядзецца выкарыстоўваць пропс children для візуальных абгортак: панэлей, сетак і г.д.

Як пропсы змяняюцца з часам

Кампанент Clock ніжэй атрымлівае два пропсы ад бацькоўскага кампанента: color і time (бацькоўскі кампанент не разглядаецца, бо ён выкарыстоўвае стан, у падрабязнасці чаго мы яшчэ не паглыналіся).

Паспрабуйце змяніць колер у прыкладзе ніжэй:

Дадзены прыклад адлюстроўвае, што пропсы, якія кампанент атрымлівае, могуць змяняцца з часам. Пропсы не заўсёды статычныя! Тут, напрыклад, пропс time змяняецца кожную секунду, а пропс color змяняецца падчас выбару іншага колеру. Пропсы змяшчаюць даныя кампанента ў канкрэтны момант, а не толькі ў момант першага рэндэру.

Не гледзячы на гэта, пропсы нязменныя — гэты тэрмін азначае аб’ект, які не можа змяняцца пасля стварэння. Калі кампаненту трэба змяніць пропс (напрыклад, у адказ на ўзаемадзеянне з боку карыстальніка ці новыя даныя), яму давядзецца «папрасіць» бацькоўскі кампанент перадаць новы іншы пропс — новаствораны аб’ект! Старыя пропсы будуць адкінутыя, і ў рэшце рэшт рухавік JavaScript выдаліць іх з памяці.

**Не спрабуйце «змяняць пропсы». **Калі вы хочаце адрэагаваць на ўведзеныя карыстальнікам даныя (напрыклад, змену колера), вам спатрэбіцца «задаць стан». Падрабязней пра гэта вы можаце даведацца на старонцы «Стан: Памяць кампанента.»