Skip to content
This repository has been archived by the owner on Apr 21, 2023. It is now read-only.

translates: lists-and-keys #26

Open
wants to merge 11 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 6 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
78 changes: 39 additions & 39 deletions content/docs/lists-and-keys.md
Original file line number Diff line number Diff line change
@@ -1,30 +1,30 @@
---
id: lists-and-keys
title: Lists and Keys
title: Lijsten En Keys
Jacco marked this conversation as resolved.
Show resolved Hide resolved
Jacco marked this conversation as resolved.
Show resolved Hide resolved
permalink: docs/lists-and-keys.html
prev: conditional-rendering.html
next: forms.html
---

First, let's review how you transform lists in JavaScript.
Laten we allereerst bekijken hoe je lijsten transformeert in JavaScript.

Given the code below, we use the [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) function to take an array of `numbers` and double their values. We assign the new array returned by `map()` to the variable `doubled` and log it:
In de code hieronder gebruiken we de [`map()` (Engels)](https://developer.mozilla.org/nl/docs/Web/JavaScript/Reference/Global_Objects/Array/map) functie op een array van `numbers` waarmee hun waarde wordt verdubbeld. De nieuwe array die door `map()` wordt teruggegeven wijzen we toe aan de variabele `doubled` waarna deze wordt gelogd:

```javascript{2}
const numbers = [1, 2, 3, 4, 5];
const doubled = numbers.map((number) => number * 2);
console.log(doubled);
```

This code logs `[2, 4, 6, 8, 10]` to the console.
Deze code logt `[2, 4, 6, 8, 10]` naar de console.

In React, transforming arrays into lists of [elements](/docs/rendering-elements.html) is nearly identical.
In React is het transformeren van arrays naar lijsten van [elementen](/docs/rendering-elements.html) bijna identiek aan het voorgaande.

### Rendering Multiple Components {#rendering-multiple-components}
### Meerdere Componenten Renderen {#rendering-multiple-components}

You can build collections of elements and [include them in JSX](/docs/introducing-jsx.html#embedding-expressions-in-jsx) using curly braces `{}`.
Je kunt collecties van elementen opbouwen en [in JSX gebruiken](/docs/introducing-jsx.html#embedding-expressions-in-jsx) met behulp van accolades `{}`.
Jacco marked this conversation as resolved.
Show resolved Hide resolved
Jacco marked this conversation as resolved.
Show resolved Hide resolved

Below, we loop through the `numbers` array using the JavaScript [`map()`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array/map) function. We return a `<li>` element for each item. Finally, we assign the resulting array of elements to `listItems`:
Hieronder doorlopen we de array van `numbers` gebruik makende van de JavaScript [`map()` (Engels)](https://developer.mozilla.org/nl/docs/Web/JavaScript/Reference/Global_Objects/Array/map) functie. Voor ieder item geven we een `<li>` element terug. Ten slotte wijzen we de array van elementen toe aan `listItems`:

```javascript{2-4}
const numbers = [1, 2, 3, 4, 5];
Expand All @@ -33,7 +33,7 @@ const listItems = numbers.map((number) =>
);
```

We include the entire `listItems` array inside a `<ul>` element, and [render it to the DOM](/docs/rendering-elements.html#rendering-an-element-into-the-dom):
We gebruiken de hele `listItems` array in een `<ul>` element en [renderen het naar het DOM](/docs/rendering-elements.html#rendering-an-element-into-the-dom):
Jacco marked this conversation as resolved.
Show resolved Hide resolved

```javascript{2}
ReactDOM.render(
Expand All @@ -42,15 +42,15 @@ ReactDOM.render(
);
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/GjPyQr?editors=0011)
[**Probeer het op CodePen**](https://codepen.io/gaearon/pen/GjPyQr?editors=0011)

This code displays a bullet list of numbers between 1 and 5.
Deze code toont een lijst met opsommingstekens met nummers van 1 tot en met 5.

### Basic List Component {#basic-list-component}
### Eenvoudige Lijst Component {#basic-list-component}

Usually you would render lists inside a [component](/docs/components-and-props.html).
Het is gebruikelijk om je lijsten in een [component](/docs/components-and-props.html) te renderen.

We can refactor the previous example into a component that accepts an array of `numbers` and outputs a list of elements.
We kunnen het vorige voorbeeld omschrijven naar een component die een array van `numbers` aanneemt en een lijst van elementen teruggeeft.

```javascript{3-5,7,13}
function NumberList(props) {
Expand All @@ -70,9 +70,9 @@ ReactDOM.render(
);
```

When you run this code, you'll be given a warning that a key should be provided for list items. A "key" is a special string attribute you need to include when creating lists of elements. We'll discuss why it's important in the next section.
Als je deze code uitvoert, krijg je een waarschuwing dat een "key" nodig is voor lijst elementen. Een "key" is een speciaal text attribuut dat je moet toevoegen als je lijsten van elementen maakt. In de volgende sectie zullen we uitleggen waarom dat belangrijk is.

Let's assign a `key` to our list items inside `numbers.map()` and fix the missing key issue.
Laten we een `key` toevoegen aan onze lijst items in `numbers.map()` en daarmee het probleem van de missende keys oplossen.
Jacco marked this conversation as resolved.
Show resolved Hide resolved
Jacco marked this conversation as resolved.
Show resolved Hide resolved

```javascript{4}
function NumberList(props) {
Expand All @@ -94,11 +94,11 @@ ReactDOM.render(
);
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/jrXYRR?editors=0011)
[**Probeer het op CodePen**](https://codepen.io/gaearon/pen/jrXYRR?editors=0011)

## Keys {#keys}

Keys help React identify which items have changed, are added, or are removed. Keys should be given to the elements inside the array to give the elements a stable identity:
Keys helpen React om te identificeren welke elementen zijn veranderd, zijn toegevoegd of zijn verwijderd. De elementen in een array zullen keys moeten krijgen om ze een stabiele identiteit te geven:

```js{3}
const numbers = [1, 2, 3, 4, 5];
Expand All @@ -109,7 +109,7 @@ const listItems = numbers.map((number) =>
);
```

The best way to pick a key is to use a string that uniquely identifies a list item among its siblings. Most often you would use IDs from your data as keys:
De beste keuze voor een key is een string die het item op unieke wijze identificeert in de lijst. Meestal zul je hier IDs uit je data voor gebruiken:

```js{2}
const todoItems = todos.map((todo) =>
Expand All @@ -119,7 +119,7 @@ const todoItems = todos.map((todo) =>
);
```

When you don't have stable IDs for rendered items, you may use the item index as a key as a last resort:
Als je geen stabiele IDs hebt voor gerenderde items, kun je als laatste redmiddel ook de index van het element in de lijst als key gebruiken:

```js{2,3}
const todoItems = todos.map((todo, index) =>
Expand All @@ -130,17 +130,17 @@ const todoItems = todos.map((todo, index) =>
);
```

We don't recommend using indexes for keys if the order of items may change. This can negatively impact performance and may cause issues with component state. Check out Robin Pokorny's article for an [in-depth explanation on the negative impacts of using an index as a key](https://medium.com/@robinpokorny/index-as-a-key-is-an-anti-pattern-e0349aece318). If you choose not to assign an explicit key to list items then React will default to using indexes as keys.
We raden het af om indices als keys te gebruiken als de volgorde van elementen kan veranderen, omdat dit een negatieve invloed heeft op de performance en problemen met de component state kan veroorzaken. Lees Robin Pokornys artikel voor een [diepgaande uitleg van de negatieve effecten van het gebruik van een index als key (Engels)](https://medium.com/@robinpokorny/index-as-a-key-is-an-anti-pattern-e0349aece318). Als je er voor kiest om geen expliciete key aan lijst elementen te geven gebruikt React standaard de indices als keys.

Here is an [in-depth explanation about why keys are necessary](/docs/reconciliation.html#recursing-on-children) if you're interested in learning more.
Als je er meer over wilt leren, vind je hier een [diepgaande uitleg waarom keys nodig zijn](/docs/reconciliation.html#recursing-on-children).

### Extracting Components with Keys {#extracting-components-with-keys}
### Componenten Met Keys Opsplitsen {#extracting-components-with-keys}
Jacco marked this conversation as resolved.
Show resolved Hide resolved

Keys only make sense in the context of the surrounding array.
Keys zijn alleen logisch in de context van de omliggende array.

For example, if you [extract](/docs/components-and-props.html#extracting-components) a `ListItem` component, you should keep the key on the `<ListItem />` elements in the array rather than on the `<li>` element in the `ListItem` itself.
Als je bijvoorbeeld een `ListItem` component wilt [extraheren](/docs/components-and-props.html#extracting-components), moet je de key op de `<ListItem />` elementen in de array houden en niet op het `<li>` element in het `ListItem` zelf.

**Example: Incorrect Key Usage**
**Voorbeeld: Foutief Gebruik Van Keys**
Jacco marked this conversation as resolved.
Show resolved Hide resolved

```javascript{4,5,14,15}
function ListItem(props) {
Expand Down Expand Up @@ -173,7 +173,7 @@ ReactDOM.render(
);
```

**Example: Correct Key Usage**
**Voorbeeld: Correct Gebruik Van Keys**
Jacco marked this conversation as resolved.
Show resolved Hide resolved

```javascript{2,3,9,10}
function ListItem(props) {
Expand Down Expand Up @@ -202,13 +202,13 @@ ReactDOM.render(
);
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/ZXeOGM?editors=0010)
[**Probeer het op CodePen**](https://codepen.io/gaearon/pen/ZXeOGM?editors=0010)

A good rule of thumb is that elements inside the `map()` call need keys.
Een goede vuistregel is dat de elementen binnen een `map()` aanroep keys nodig hebben.

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Als ik een suggestie mag doen:
Een vuistregel is dat de elementen binnen de map() functie keys vereisen.
functie is nog niet helemaal goed vind ik zelf, maar operator is dan weer Engels.


### Keys Must Only Be Unique Among Siblings {#keys-must-only-be-unique-among-siblings}
### Keys Moeten Alleen Uniek Zijn Ten Opzichte Van Siblings {#keys-must-only-be-unique-among-siblings}

Keys used within arrays should be unique among their siblings. However they don't need to be globally unique. We can use the same keys when we produce two different arrays:
Keys die in arrays gebruikt worden moeten uniek zijn ten op zichte van hun siblings. Ze hoeven echter niet uniek te zijn in de hele applicatie. We kunnen dezelfde keys gebruiken als we twee verschillende arrays maken:

```js{2,5,11,12,19,21}
function Blog(props) {
Expand Down Expand Up @@ -246,9 +246,9 @@ ReactDOM.render(
);
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)
[**Probeer het op CodePen**](https://codepen.io/gaearon/pen/NRZYGN?editors=0010)

Keys serve as a hint to React but they don't get passed to your components. If you need the same value in your component, pass it explicitly as a prop with a different name:
Keys dienen als hint aan React maar ze worden niet doorgegeven aan je componenten. Als je dezelfde waarde nodig hebt in je component, moet je deze expliciet als een prop met een andere naam doorgeven.

```js{3,4}
const content = posts.map((post) =>
Expand All @@ -259,11 +259,11 @@ const content = posts.map((post) =>
);
```

With the example above, the `Post` component can read `props.id`, but not `props.key`.
In het voorbeeld hierboven kan de `Post` component `props.id` lezen, maar `props.key` niet.

### Embedding map() in JSX {#embedding-map-in-jsx}
### Map() Gebruiken in JSX {#embedding-map-in-jsx}

In the examples above we declared a separate `listItems` variable and included it in JSX:
In de eerdere voorbeelden maakten we een aparte `listItems` variabele die we in JSX gebruikten:

```js{3-6}
function NumberList(props) {
Expand All @@ -280,7 +280,7 @@ function NumberList(props) {
}
```

JSX allows [embedding any expression](/docs/introducing-jsx.html#embedding-expressions-in-jsx) in curly braces so we could inline the `map()` result:
JSX staat [elke expressie](/docs/introducing-jsx.html#embedding-expressions-in-jsx) toe tussen accolades, dus we zouden het `map()` resultaat ook direct kunnen gebruiken:

```js{5-8}
function NumberList(props) {
Expand All @@ -296,6 +296,6 @@ function NumberList(props) {
}
```

[**Try it on CodePen**](https://codepen.io/gaearon/pen/BLvYrB?editors=0010)
[**Probeer het op CodePen**](https://codepen.io/gaearon/pen/BLvYrB?editors=0010)

Sometimes this results in clearer code, but this style can also be abused. Like in JavaScript, it is up to you to decide whether it is worth extracting a variable for readability. Keep in mind that if the `map()` body is too nested, it might be a good time to [extract a component](/docs/components-and-props.html#extracting-components).
Soms levert dit beter leesbare code op, maar deze stijl kan ook misbruikt worden. Net als in JavaScript is het aan jou om te bepalen of het loont om een variabele te gebruiken voor de leesbaarheid. Het kan een goed idee zijn om [een component te extraheren](/docs/components-and-props.html#extracting-components) als de expressie in `map()` te diep genest is.
2 changes: 1 addition & 1 deletion content/docs/nav.yml
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@
- id: conditional-rendering
title: Conditional Rendering
- id: lists-and-keys
title: Lists and Keys
title: Lijsten En Keys
Jacco marked this conversation as resolved.
Show resolved Hide resolved
- id: forms
title: Forms
- id: lifting-state-up
Expand Down