Skip to content

Update addons-create-fragment.md #212

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Aug 16, 2020

Conversation

mbiesiad
Copy link
Contributor

Translated into Polish.

Best wishes,

@mbiesiad mbiesiad requested a review from a team August 15, 2020 16:47
@netlify
Copy link

netlify bot commented Aug 15, 2020

Deploy preview for pl-reactjs ready!

Built with commit 2117d46

https://deploy-preview-212--pl-reactjs.netlify.app

Copy link
Member

@jakubdrozdek jakubdrozdek left a comment

Choose a reason for hiding this comment

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

Dzięki za tłumaczenie. Dodałem parę sugestii, głównie kosmetycznych. Niektóre zdania brzmiały trochę koślawo, ale myślę, że kolejne tłumaczenia będą lepsze :-)

@@ -1,27 +1,27 @@
---
id: create-fragment
title: Keyed Fragments
title: Kluczowane fragmenty
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
title: Kluczowane fragmenty
title: Fragmenty z kluczami

>
> `React.addons` entry point is deprecated as of React v15.5. We now have first class support for fragments which you can read about [here](/docs/fragments.html).
> Punkt wejścia `React.addons` jest przestarzały od wersji React 15.5. Mamy teraz wsparcie pierwszej klasy dla fragmentów, o których możesz przeczytać [tutaj](/docs/fragments.html).
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
> Punkt wejścia `React.addons` jest przestarzały od wersji React 15.5. Mamy teraz wsparcie pierwszej klasy dla fragmentów, o których możesz przeczytać [tutaj](/docs/fragments.html).
> Punkt wejścia `React.addons` jest przestarzały od wersji Reacta 15.5. Mamy teraz natywne wsparcie dla fragmentów, o których możesz przeczytać [tutaj](/docs/fragments.html).

```

## Overview {#overview}
## Przegląd {#overview}
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
## Przegląd {#overview}
## Informacje ogólne {#overview}


In most cases, you can use the `key` prop to specify keys on the elements you're returning from `render`. However, this breaks down in one situation: if you have two sets of children that you need to reorder, there's no way to put a key on each set without adding a wrapper element.
W większości przypadków, możesz użyć prop `key` aby określić klucze w elementach, które zwracasz z `render`. Jednakże, załamuje się to w jednej sytuacji: jeśli masz dwa zestawy dzieci, które musisz zmienić, nie ma sposobu, aby umieścić klucz na każdym zestawie bez dodania elementu wrappera.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
W większości przypadków, możesz użyć prop `key` aby określić klucze w elementach, które zwracasz z `render`. Jednakże, załamuje się to w jednej sytuacji: jeśli masz dwa zestawy dzieci, które musisz zmienić, nie ma sposobu, aby umieścić klucz na każdym zestawie bez dodania elementu wrappera.
W większości przypadków możesz użyć właściwości `key`, aby określić klucze w elementach zwracanych z metody `render`. Problem pojawia się jednak w sytuacji, gdy masz dwa zestawy komponentów potomnych, które musisz zamienić miejscami. Nie ma sposobu, aby umieścić klucz na każdym zestawie bez dodania elementu opakowującego.


That is, if you have a component such as:
To znaczy, jeśli masz komponent taki jak:
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
To znaczy, jeśli masz komponent taki jak:
Przykładowo, masz następujący komponent:

@@ -35,13 +35,13 @@ function Swapper(props) {
}
```

The children will unmount and remount as you change the `swapped` prop because there aren't any keys marked on the two sets of children.
Dzieci odmontują się i ponownie zamontują, gdy zmienisz prop `swapped`, ponieważ nie ma żadnych kluczy zaznaczonych na dwóch zestawach dzieci.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Dzieci odmontują się i ponownie zamontują, gdy zmienisz prop `swapped`, ponieważ nie ma żadnych kluczy zaznaczonych na dwóch zestawach dzieci.
Gdy zmienisz wartość właściwości `swapped` na inną, komponenty potomne odmontują się i ponownie zamontują, ponieważ żadna z grup potomków nie ma ustawionego klucza.


To solve this problem, you can use the `createFragment` add-on to give keys to the sets of children.
Aby rozwiązać ten problem, możesz użyć dodatku `createFragment`, aby przekazać klucze do zestawów dzieci.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Aby rozwiązać ten problem, możesz użyć dodatku `createFragment`, aby przekazać klucze do zestawów dzieci.
Aby rozwiązać ten problem, możesz użyć dodatku `createFragment`, dzięki któremu możesz przekazać klucze do zestawów komponentów potomnych.

@@ -63,6 +63,6 @@ function Swapper(props) {
}
```

The keys of the passed object (that is, `left` and `right`) are used as keys for the entire set of children, and the order of the object's keys is used to determine the order of the rendered children. With this change, the two sets of children will be properly reordered in the DOM without unmounting.
Klucze przekazanego obiektu (czyli `left` i `right`) są używane jako klucze dla całego zestawu dzieci, a kolejność kluczy obiektu jest używana do określenia kolejności renderowanych elementów podrzędnych. Dzięki tej zmianie dwa zestawy elementów podrzędnych zostaną odpowiednio uporządkowane w DOM bez odmontowywania.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Klucze przekazanego obiektu (czyli `left` i `right`) są używane jako klucze dla całego zestawu dzieci, a kolejność kluczy obiektu jest używana do określenia kolejności renderowanych elementów podrzędnych. Dzięki tej zmianie dwa zestawy elementów podrzędnych zostaną odpowiednio uporządkowane w DOM bez odmontowywania.
Klucze przekazanego obiektu (czyli `left` i `right`) są używane jako klucze dla całej grupy potomków, a kolejność kluczy obiektu jest używana do określenia kolejności renderowanych grup. Dzięki tej zmianie, obydwa zestawy elementów zostaną odpowiednio uporządkowane w DOM bez odmontowywania.


The return value of `createFragment` should be treated as an opaque object; you can use the [`React.Children`](/docs/react-api.html#react.children) helpers to loop through a fragment but should not access it directly. Note also that we're relying on the JavaScript engine preserving object enumeration order here, which is not guaranteed by the spec but is implemented by all major browsers and VMs for objects with non-numeric keys.
Wartość zwracaną `createFragment` należy traktować jako obiekt nieprzezroczysty; możesz użyć helperów [`React.Children`](/docs/react-api.html#react.children) aby zapętlić fragment, ale nie powinien mieć do niego bezpośredniego dostępu. Zauważ również, że polegamy na silniku JavaScript zachowującym tutaj kolejność wyliczania obiektów, która nie jest gwarantowana przez specyfikację, ale jest implementowana przez wszystkie główne przeglądarki i maszyny wirtualne dla obiektów z kluczami nienumerycznymi.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
Wartość zwracaną `createFragment` należy traktować jako obiekt nieprzezroczysty; możesz użyć helperów [`React.Children`](/docs/react-api.html#react.children) aby zapętlić fragment, ale nie powinien mieć do niego bezpośredniego dostępu. Zauważ również, że polegamy na silniku JavaScript zachowującym tutaj kolejność wyliczania obiektów, która nie jest gwarantowana przez specyfikację, ale jest implementowana przez wszystkie główne przeglądarki i maszyny wirtualne dla obiektów z kluczami nienumerycznymi.
Wartość zwracaną funkcji `createFragment` należy traktować jako obiekt nieprzezroczysty; możesz użyć funkcji [`React.Children`](/docs/react-api.html#react.children) do iterowania fragmentu, ale nie zaglądaj bezpośrednio do niego. Zauważ również, że polegamy tu na silniku JavaScript zachowującym kolejność wyliczania obiektów, która nie jest gwarantowana przez specyfikację, ale jest implementowana przez wszystkie główne przeglądarki i maszyny wirtualne dla obiektów z kluczami nienumerycznymi.

Fixed according to CR.
@mbiesiad
Copy link
Contributor Author

Cała przyjemność po mojej stronie! Dzięki, celne i cenne spostrzeżenia, uwagi. Poprawione.

@jakubdrozdek jakubdrozdek merged commit ac798f0 into reactjs:master Aug 16, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants