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

Derinlemesine JSX

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

Temel olarak, JSX React.createElement(component, props, ...children) fonksiyonu için sözdizimsel bir kısayol sağlar. JSX, aşağıdaki kodu:

<MyButton color="blue" shadowSize={2}>
  Click Me
</MyButton>

şuna derler:

React.createElement(
  MyButton,
  {color: 'blue', shadowSize: 2},
  'Click Me'
)

Eğer alt eleman yoksa, etiketin (tag) kendiliğinden kapanan formunu da kullanabilirsiniz. Yani:

<div className="sidebar" />

şuna derlenir:

React.createElement(
  'div',
  {className: 'sidebar'}
)

Belirli bir JSX’in JavaScript’e nasıl dönüştürüldüğünü test etmek istiyorsanız, çevrimiçi Babil derleyicisi‘ni deneyebilirsiniz.

React Elemanı Tipini Belirtme

JSX etiketinin ilk kısmı, React elemanının tipini belirtir.

Büyük harfle başlayan tipler, JSX etiketinin bir React bileşenine başvurduğunu belirtir. Bu etiketler, isimlendirilmiş değişkene doğrudan bir referans olarak derlenir, yani JSX <Foo /> ifadesini kullanırsanız, Foo kapsam dahilinde olmalıdır.

React Kapsam Dahilinde Olmalı

JSX, React.createElement çağrısına derlediğinden, React kütüphanesi her zaman JSX kodunuzun kapsamında olmalıdır.

Örneğin, React ve CustomButton öğeleri doğrudan JavaScript’te kullanılmasa da, her ikisi için de içe aktarma bu kodda gereklidir:

import React from 'react';import CustomButton from './CustomButton';
function WarningButton() {
  // return React.createElement(CustomButton, {color: 'red'}, null);  return <CustomButton color="red" />;
}

Bir JavaScript paketleyici kullanmıyor ve React’ı bir <script> etiketinden yüklüyorsanız, React global olarak zaten kapsam dahilindedir.

JSX Tipi için Nokta Gösterimini Kullanma

JSX içinden nokta gösterimini kullanarak da bir React bileşenine başvurabilirsiniz. Bu, birçok React bileşenini dışa aktaran tek bir modülünüz varsa kullanışlıdır. Örneğin, MyComponents.DatePicker bir bileşense, bunu doğrudan JSX’te aşağıdaki şekilde kullanabilirsiniz:

import React from 'react';

const MyComponents = {
  DatePicker: function DatePicker(props) {
    return <div>Imagine a {props.color} datepicker here.</div>;
  }
}

function BlueDatePicker() {
  return <MyComponents.DatePicker color="blue" />;}

Kullanıcı Tanımlı Bileşenler Büyük Harfle Başlamalıdır

Bir elemanın tipi küçük harfle başladığında, <div> veya <span> gibi dahili bir bileşene atıfta bulunur ve bunun sonucu React.createElement fonksiyonuna 'div' veya 'span' stringlerinin aktarılmasıdır. <Foo /> gibi büyük harfle başlayan tipler React.createElement(Foo) şeklinde derlenir ve JavaScript dosyanızda tanımlanan veya içe aktarılan bir bileşene karşılık gelir.

Bileşenleri, büyük harfle başlayan bir şekilde adlandırmanızı öneririz. Küçük harfle başlayan bir bileşeniniz varsa, bunu JSX’te kullanmadan önce büyük harfle başlayan bir değişkene atayın.

Örneğin, bu kod beklendiği gibi çalışmaz:

import React from 'react';

// Yanlış! Bu bir bileşendir ve ismi büyük bir harfle başlamalıdır:function hello(props) {  // Doğru! div geçerli bir HTML etiketi olduğundan <div> 'in bu kullanımı uygundur:
  return <div>Hello {props.toWhat}</div>;
}

function HelloWorld() {
  // Yanlış! React, büyük bir harfle başlamadığından <hello /> 'nun bir HTML etiketi olduğunu düşünüyor:  return <hello toWhat="World" />;}

Bunu düzeltmek için, hello fonksiyonunu Hello olarak yeniden adlandırıp <Hello /> olarak kullanacağız:

import React from 'react';

// Doğru! Bu bir bileşendir ve adı büyük harfle başlamalıdır:function Hello(props) {  // Doğru! div geçerli bir HTML etiketi olduğundan <div> 'in bu kullanımı uygundur:
  return <div>Hello {props.toWhat}</div>;
}

function HelloWorld() {
  // Doğru! React, <Hello /> büyük bir harfle başladığı için bir bileşen olduğunu biliyor.  return <Hello toWhat="World" />;}

Tipi Çalışma Zamanında Seçme

Genel bir ifadeyi (expression) React elemanı tipi olarak kullanamazsınız. Elemanın tipini belirtmek için genel bir ifade kullanmak istiyorsanız, sadece öncesinde büyük harfle başlayan bir değişkene atayın. Bu genellikle, bir prop’a göre farklı bir bileşen render etmek istediğinizde ortaya çıkar:

import React from 'react';
import { PhotoStory, VideoStory } from './stories';

const components = {
  photo: PhotoStory,
  video: VideoStory
};

function Story(props) {
  // Yanlış! JSX tipi bir ifade olamaz.  return <components[props.storyType] story={props.story} />;}

Bunu düzeltmek için, önce tipi büyük harfle başlayan bir değişkene atayacağız:

import React from 'react';
import { PhotoStory, VideoStory } from './stories';

const components = {
  photo: PhotoStory,
  video: VideoStory
};

function Story(props) {
  // Doğru! JSX tipi büyük harfli bir değişken olabilir.  const SpecificStory = components[props.storyType];  return <SpecificStory story={props.story} />;}

JSX’de Prop’lar

JSX’te prop’ları belirtmenin birkaç farklı yolu vardır.

Prop Olarak JavaScript İfadeleri

Herhangi bir JavaScript ifadesini {} ile çevreleyerek bir prop olarak iletebilirsiniz. Örneğin, bu JSX’te:

<MyComponent foo={1 + 2 + 3 + 4} />

MyComponent için, props.foo değeri 10 olacaktır çünkü 1 + 2 + 3 + 4 ifadesi çalıştırılır.

if deyimleri vefor döngüleri JavaScript’te ifade değildir, bu nedenle doğrudan JSX’te kullanılamazlar. Onun yerine, bunları çevreleyen bir koda koyabilirsiniz. Örneğin:

function NumberDescriber(props) {
  let description;
  if (props.number % 2 == 0) {    description = <strong>even</strong>;  } else {    description = <i>odd</i>;  }  return <div>{props.number} is an {description} number</div>;
}

İlgili bölümlerde koşullu render etme ve döngüler hakkında daha fazla bilgi edinebilirsiniz.

String Değişmezleri

Bir string değişmezini prop olarak geçirebilirsiniz. Bu iki JSX ifadesi eşdeğerdir:

<MyComponent message="hello world" />

<MyComponent message={'hello world'} />

Bir string değişmezini ilettiğinizde, değeri HTML’den kaçmaz. Yani bu iki JSX ifadesi eşdeğerdir:

<MyComponent message="&lt;3" />

<MyComponent message={'<3'} />

Bu davranış genellikle alakasızdır. Burada sadece bütünlük için bahsedilmiştir.

Prop’ların Varsayılan Değeri “True”

Eğer bir prop için herhangi bir değer iletmezseniz, değeri varsayılan olarak true olur. Bu iki JSX ifadesi eşdeğerdir:

<MyTextBox autocomplete />

<MyTextBox autocomplete={true} />

Genel olarak, bir prop için değer iletmemenizi önermiyoruz, çünkü {foo: true} yerine {foo: foo} için ES6 obje kısayolu olan {foo} ile karıştırılabilir. Bu davranış sadece, HTML davranışıyla eşleşmesi için oradadır.

Özelliklerin Yayılması

Zaten nesne olarak bir prop'lar objeniz varsa ve bunu JSX’e aktarmak istiyorsanız, tüm prop’ları geçirmek için “yayma” (spread) operatörü olan ... ‘yı kullanabilirsiniz. Bu iki bileşen eşdeğerdir:

function App1() {
  return <Greeting firstName="Yunus Emre" lastName="Dilber" />;
}

function App2() {
  const props = {firstName: 'Yunus Emre', lastName: 'Dilber'};
  return <Greeting {...props} />;}

Ayrıca, yayılma operatörünü kullanarak diğer tüm prop’ları geçerken, bileşeninizin kullanacağı özel prop’ları de seçebilirsiniz.

const Button = props => {
  const { kind, ...other } = props;  const className = kind === "primary" ? "PrimaryButton" : "SecondaryButton";
  return <button className={className} {...other} />;
};

const App = () => {
  return (
    <div>
      <Button kind="primary" onClick={() => console.log("clicked!")}>
        Hello World!
      </Button>
    </div>
  );
};

Yukarıdaki örnekte, kind prop’u güvenli bir şekilde kullanılır ve DOM’daki <button> elemanına geçirilmez. Diğer tüm prop’lar bu bileşeni esnek yapan ...other nesnesi üzerinden geçirilir. onClick ve children prop’larının geçirildiğini görebilirsiniz.

Özelliklerin yayılması yararlı olabilir ancak bunlar, onları umursamayan bileşenlere gereksiz prop’ların aktarılmasını veya geçersiz HTML özelliklerinin DOM’a aktarılmasını kolaylaştırır. Bu sözdizimini tedbirli kullanmanızı öneririz.

JSX’de Alt Elemanlar

Hem açılış hem de kapanış etiketi içeren JSX ifadelerinde, bu etiketler arasındaki içerik özel bir prop olarak geçirilir: props.children. Alt elemanları geçmenin birkaç farklı yolu vardır:

String Değişmezleri

Açılış ve kapanış etiketleri arasına bir string koyabilirsiniz ve props.children sadece bu string olacaktır. Bu, çoğu dahili HTML elemanı için kullanışlıdır. Örneğin:

<MyComponent>Hello world!</MyComponent>

Bu geçerli bir JSX ve MyComponent içindeki props.children sadece "Hello world!" stringi olacaktır. HTML’den kaçılmadığı için, genellikle tıpkı HTML yazdığınız gibi JSX’i bu şekilde yazabilirsiniz:

<div>Bu geçerli bir HTML &amp; Aynı zamanda JSX.</div>

JSX, bir satırın başındaki ve sonundaki boşlukları kaldırır. Ayrıca boş satırları da kaldırır. Etiketlere bitişik yeni satırlar kaldırılır; string değişmezlerinin ortasında oluşan yeni satırlar tek bir boşluğa dönüştürülür. Yani bunların hepsi aynı şeye render ediliyor:

<div>Hello World</div>

<div>
  Hello World
</div>

<div>
  Hello
  World
</div>

<div>

  Hello World
</div>

JSX Alt Elemanları

Alt eleman olarak daha fazla JSX elemanı sağlayabilirsiniz. Bu, iç içe geçmiş bileşenleri görüntülemek için kullanışlıdır:

<MyContainer>
  <MyFirstComponent />
  <MySecondComponent />
</MyContainer>

Farklı tiplerdeki alt elemanları birlikte kullanabilirsiniz, böylece string değişmezlerini JSX alt elemanlarıyla birlikte kullanabilirsiniz. Bu, JSX’in HTML’e benzemesinin başka bir yoludur; böylece bu, hem geçerli bir JSX hem de geçerli bir HTML’dir:

<div>
  Here is a list:
  <ul>
    <li>Item 1</li>
    <li>Item 2</li>
  </ul>
</div>

React bileşeni ayrıca bir dizi eleman döndürebilir:

render() {
  // Liste öğelerini ekstra bir elemanla sarmanıza gerek yok!
  return [
    // Key'leri unutmayın :)
    <li key="A">First item</li>,
    <li key="B">Second item</li>,
    <li key="C">Third item</li>,
  ];
}

Alt Eleman Olarak JavaScript İfadeleri

Herhangi bir JavaScript ifadesini {} içine koyarak alt eleman olarak iletebilirsiniz. Örneğin, bu ifadeler eşdeğerdir:

<MyComponent>foo</MyComponent>

<MyComponent>{'foo'}</MyComponent>

Bu genellikle, keyfî uzunluktaki JSX ifadelerinin bir listesini render etmek için kullanışlıdır. Örneğin, bu bir HTML listesi render eder:

function Item(props) {
  return <li>{props.message}</li>;}

function TodoList() {
  const todos = ['finish doc', 'submit pr', 'nag dan to review'];
  return (
    <ul>
      {todos.map((message) => <Item key={message} message={message} />)}    </ul>
  );
}

JavaScript ifadeleri diğer alt eleman tipleri ile birlikte kullanılabilir. Bu genellikle string şablonları yerine kullanışlıdır:

function Hello(props) {
  return <div>Hello {props.addressee}!</div>;}

Alt Eleman Olarak Fonksiyonlar

Normalde, JSX’e eklenen JavaScript ifadeleri bir string, bir React elemanı veya bu şeylerin bir listesi olarak değerlendirilir. Bununla birlikte, props.children, sadece React’ın nasıl render edeceğini bildiği türleri değil, her türde veriyi aktarabilmesi için herhangi bir prop gibi çalışır. Örneğin, özel bir bileşeniniz varsa, bunun props.children olarak bir callback almasını sağlayabilirsiniz:

// Tekrarlanan bir bileşen üretmek için alt eleman callback'ini numTimes kez çağırır
function Repeat(props) {
  let items = [];
  for (let i = 0; i < props.numTimes; i++) {    items.push(props.children(i));
  }
  return <div>{items}</div>;
}

function ListOfTenThings() {
  return (
    <Repeat numTimes={10}>
      {(index) => <div key={index}>This is item {index} in the list</div>}    </Repeat>
  );
}

Özel bir bileşene geçirilen alt elemanlar, bu bileşen onları React’ın render etmeden önce anlayabileceği bir şeye dönüştürdüğü sürece herhangi bir şey olabilir. Bu kullanım yaygın değildir, ancak JSX’in neler yapabileceğini açmak istiyorsanız çalışacaktır.

Boolean’lar, Null ve Undefined Görmezden Gelinir

false, null, undefined ve true geçerli alt elemanlardır. Sadece, render edilmezler. Bu JSX ifadelerinin tümü aynı şeye render edilir:

<div />

<div></div>

<div>{false}</div>

<div>{null}</div>

<div>{undefined}</div>

<div>{true}</div>

Bu, React elemanlarının koşullu olarak render etmek için yararlı olabilir. Bu JSX, <Header /> bileşenini yalnızca showHeader true olduğunda render eder:

<div>
  {showHeader && <Header />}  <Content />
</div>

Bir uyarı, 0 sayısı gibi bazı “falsy” değerlerin hala React tarafından görüntülenmesidir. Örneğin, bu kod beklediğiniz gibi davranmayacaktır çünkü props.messages boş bir dizi olduğunda 0 yazdırılacaktır:

<div>
  {props.messages.length &&    <MessageList messages={props.messages} />
  }
</div>

Bunu düzeltmek için, && öncesindeki ifadenin her zaman boolean olduğundan emin olun:

<div>
  {props.messages.length > 0 &&    <MessageList messages={props.messages} />
  }
</div>

Aksine, çıktıda false, true, null veya undefined gibi bir değerin görünmesini istiyorsanız, önce bir stringe dönüştürmeniz gerekir:

<div>
  My JavaScript variable is {String(myVariable)}.</div>
Bu sayfayı yararlı buldun mu?Bu sayfayı düzenle