From 5f3b6103eeb32cbf3264b598ea724888e322a8d4 Mon Sep 17 00:00:00 2001 From: Arkadiusz Mazurkiewicz Date: Wed, 6 Mar 2019 11:51:14 +0100 Subject: [PATCH 01/41] Translate introduction and `Function and Class Components` section --- content/docs/components-and-props.md | 20 ++++++++++---------- 1 file changed, 10 insertions(+), 10 deletions(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 4b3bbb6e6..8587ecbf5 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -16,35 +16,35 @@ prev: rendering-elements.html next: state-and-lifecycle.html --- -Components let you split the UI into independent, reusable pieces, and think about each piece in isolation. This page provides an introduction to the idea of components. You can find a [detailed component API reference here](/docs/react-component.html). +Komponenty pozwalają ci podzielić interfejs użytkownika na niezależne, pozwalające na ponowne użycie części i myśleć o każdej z nich osobno. Ta strona dostarcza wprowadzenie do pojęcia komponentów. Możesz znaleźć [szczegółowe odniesienie do API komponentów tutaj](/docs/react-component.html). -Conceptually, components are like JavaScript functions. They accept arbitrary inputs (called "props") and return React elements describing what should appear on the screen. +Koncepcyjnie, komponenty są jak javascriptowe funkcje. Przyjmują one arbirtalne wkłady (nazywane "właściwościami") i zwracają reactowe elementy opisujące co powinno się pojawić na ekranie. -## Function and Class Components {#function-and-class-components} +## Komponenty funkcyjne i klasowe {#function-and-class-components} -The simplest way to define a component is to write a JavaScript function: +Najprostszym sposobem na zdefiniowanie komponentu jest napisanie javascriptowej funkcji: ```js function Welcome(props) { - return

Hello, {props.name}

; + return

Cześć, {props.name}

; } ``` -This function is a valid React component because it accepts a single "props" (which stands for properties) object argument with data and returns a React element. We call such components "function components" because they are literally JavaScript functions. +Ta funkcja jest uzasadnionym reactowym komponentem, bo przyjmuje pojedynczy argument "props" (który oznacza "właściwości" (ang. *properties*)) będący obiektem z danymi i zwraca reactowy element. Nazywamy takie komponenty "komponentami funkcyjnymi", bo są one dosłownie javascriptowymi funkcjami. -You can also use an [ES6 class](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Classes) to define a component: +Możesz również używać [klasy ES6](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Classes) aby zdefiniować komponent: ```js class Welcome extends React.Component { render() { - return

Hello, {this.props.name}

; + return

Cześć, {this.props.name}

; } } ``` -The above two components are equivalent from React's point of view. +Dwa powyższe komponenty są równoważne z punktu widzenia Reacta. -Classes have some additional features that we will discuss in the [next sections](/docs/state-and-lifecycle.html). Until then, we will use function components for their conciseness. +Klasy mają kilka dodatkowych cech, które przedyskutujemy w [kolejnych rozdziałach](/docs/state-and-lifecycle.html). Na ten czas bedziemy używać komponentów funkcyjnych dla ich zwięzłości. ## Rendering a Component {#rendering-a-component} From 08b79bdff8d18cd226b9c7b1b524a86a04afa65c Mon Sep 17 00:00:00 2001 From: Arkadiusz Mazurkiewicz Date: Wed, 6 Mar 2019 12:02:30 +0100 Subject: [PATCH 02/41] Translate the title --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 8587ecbf5..34f144fc5 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -1,6 +1,6 @@ --- id: components-and-props -title: Components and Props +title: Komponenty i właściwości permalink: docs/components-and-props.html redirect_from: - "docs/reusable-components.html" From 0fcf2284964821c33fc1f2092989b8c9afe9c2f0 Mon Sep 17 00:00:00 2001 From: Arkadiusz Mazurkiewicz Date: Wed, 6 Mar 2019 12:32:49 +0100 Subject: [PATCH 03/41] Translate `Rendering a Component` and `Composing Components` sections --- content/docs/components-and-props.md | 38 ++++++++++++++-------------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 34f144fc5..33e055c61 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -46,27 +46,27 @@ Dwa powyższe komponenty są równoważne z punktu widzenia Reacta. Klasy mają kilka dodatkowych cech, które przedyskutujemy w [kolejnych rozdziałach](/docs/state-and-lifecycle.html). Na ten czas bedziemy używać komponentów funkcyjnych dla ich zwięzłości. -## Rendering a Component {#rendering-a-component} +## Renderowanie komponentu {#rendering-a-component} -Previously, we only encountered React elements that represent DOM tags: +Poprzednio, napotykaliśmy reactowe elementy, które reprezentowały tagi drzewa DOM: ```js const element =
; ``` -However, elements can also represent user-defined components: +Natomiast elementy mogą również reprezentować komponenty zdefiniowane przez użytkownika: ```js const element = ; ``` -When React sees an element representing a user-defined component, it passes JSX attributes to this component as a single object. We call this object "props". +Kiedy React widzi element reprezentujący komponent zdefiniowany przez użytkownika, przekazuje on do niego JSX'owe atrybuty jako jeden obiekt. Nazywamy ten obiekt "właściwościami". -For example, this code renders "Hello, Sara" on the page: +Na przykład, ten kod renderuje "Cześć, Sara" na stronie: ```js{1,5} function Welcome(props) { - return

Hello, {props.name}

; + return

Cześć, {props.name}

; } const element = ; @@ -78,28 +78,28 @@ ReactDOM.render( [](codepen://components-and-props/rendering-a-component) -Let's recap what happens in this example: +Podsumujmy, co dzieje się w tym przykładzie: -1. We call `ReactDOM.render()` with the `` element. -2. React calls the `Welcome` component with `{name: 'Sara'}` as the props. -3. Our `Welcome` component returns a `

Hello, Sara

` element as the result. -4. React DOM efficiently updates the DOM to match `

Hello, Sara

`. +1. Wywołujemy `ReactDOM.render()` z elementem ``. +2. React wywołuje komponent `Welcome` z `{name: 'Sara'}` jako właściwości. +3. Nasz komponent `Welcome` zwraca jako wynik element `

Hello, Sara

`. +4. React DOM wydajnie uaktualinia drzewo DOM, aby równało się `

Hello, Sara

`. ->**Note:** Always start component names with a capital letter. +>**Wskazówka:** Zawsze zaczynaj nazwy komponentów od dużej litery. > ->React treats components starting with lowercase letters as DOM tags. For example, `
` represents an HTML div tag, but `` represents a component and requires `Welcome` to be in scope. +>React traktuje komponenty zaczynające się od małej litery jako tagi drzewa DOM. Na przykład, `
` reprezentuje HTML'owy tag div, ale `` reprezentuje komponent i wymaga, aby `Welcome` było w zasięgu. > ->To learn more about the reasoning behind this convention, please read [JSX In Depth](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). +>Aby dowiedzieć się więcej o uzasadnieniu tej konwencji, przeczytaj [JSX dogłębnie](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). -## Composing Components {#composing-components} +## Komponowanie Komponentów {#composing-components} -Components can refer to other components in their output. This lets us use the same component abstraction for any level of detail. A button, a form, a dialog, a screen: in React apps, all those are commonly expressed as components. +Komponenty mogą odwoływać się do innych komponentów i ich wyników. To pozwala nam na używanie tej samej abstrakcji komponentu na dowolnym poziomie szczegółowości. -For example, we can create an `App` component that renders `Welcome` many times: +Na przykład możemy stworzyć komponent `App`, który renderuje `Welcome` wiele razy: ```js{8-10} function Welcome(props) { - return

Hello, {props.name}

; + return

Cześć, {props.name}

; } function App() { @@ -120,7 +120,7 @@ ReactDOM.render( [](codepen://components-and-props/composing-components) -Typically, new React apps have a single `App` component at the very top. However, if you integrate React into an existing app, you might start bottom-up with a small component like `Button` and gradually work your way to the top of the view hierarchy. +Zazwyczaj, nowe reactowe aplikacje mają pojedynczy komponent `App` u samej góry. Natomiast, jeśli będziesz integrował Reacta z istniejącą aplikacją, możesz zacząć od dołu z małymi komponentami jak na przykład `Button` i stopniowo wypracować sobie drogę na szczyt hierarchii widoku. ## Extracting Components {#extracting-components} From abaa91a406c5105c4f4cef0453306a25cc938ba7 Mon Sep 17 00:00:00 2001 From: Arkadiusz Mazurkiewicz Date: Wed, 6 Mar 2019 13:08:18 +0100 Subject: [PATCH 04/41] Translate `Extracting Components` section --- content/docs/components-and-props.md | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 33e055c61..d6f25e057 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -91,7 +91,7 @@ Podsumujmy, co dzieje się w tym przykładzie: > >Aby dowiedzieć się więcej o uzasadnieniu tej konwencji, przeczytaj [JSX dogłębnie](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). -## Komponowanie Komponentów {#composing-components} +## Kompozycja komponentów {#composing-components} Komponenty mogą odwoływać się do innych komponentów i ich wyników. To pozwala nam na używanie tej samej abstrakcji komponentu na dowolnym poziomie szczegółowości. @@ -122,11 +122,11 @@ ReactDOM.render( Zazwyczaj, nowe reactowe aplikacje mają pojedynczy komponent `App` u samej góry. Natomiast, jeśli będziesz integrował Reacta z istniejącą aplikacją, możesz zacząć od dołu z małymi komponentami jak na przykład `Button` i stopniowo wypracować sobie drogę na szczyt hierarchii widoku. -## Extracting Components {#extracting-components} +## Wyciąganie komponentów {#extracting-components} -Don't be afraid to split components into smaller components. +Nie bój się dzielenia komponentów na mniejsce komponenty. -For example, consider this `Comment` component: +Na przykład rozważ ten komponent `Commment`: ```js function Comment(props) { @@ -154,11 +154,11 @@ function Comment(props) { [](codepen://components-and-props/extracting-components) -It accepts `author` (an object), `text` (a string), and `date` (a date) as props, and describes a comment on a social media website. +Przyjmuje on `autora` (ang. *author*) - obiekt, `text` - string i `datę` (ang. *date*) jako właściwości, oraz opisuje komentarz na stronie mediów społecznościowych. -This component can be tricky to change because of all the nesting, and it is also hard to reuse individual parts of it. Let's extract a few components from it. +Zmiana tego komponentu może być zawiła z powodu całego tego zagnieżdżenia, a ponowne użycie jego indywidulnych części jest trudne. Wyciągnijmy z niego kilka komponentów. -First, we will extract `Avatar`: +Najpierw, wyciągniemy `Avatar`: ```js{3-6} function Avatar(props) { @@ -171,11 +171,11 @@ function Avatar(props) { } ``` -The `Avatar` doesn't need to know that it is being rendered inside a `Comment`. This is why we have given its prop a more generic name: `user` rather than `author`. +`Avatar` nie musi wiedzieć, że jest renderowany w środku komponentu `Comment`. Dlatego też daliśmy jego właściwości bardziej ogólną nazwę: `użytkownik` (ang. *user*) zamiast `autor`. -We recommend naming props from the component's own point of view rather than the context in which it is being used. +Polecamy nazywać właściwości z własnego punktu widzenia komponentu zamiast kontekstu, w którym jest używany. -We can now simplify `Comment` a tiny bit: +Możemy teraz dodać do komponentu `Comment` drobne uproszczenie: ```js{5} function Comment(props) { @@ -198,7 +198,7 @@ function Comment(props) { } ``` -Next, we will extract a `UserInfo` component that renders an `Avatar` next to the user's name: +Następnie wyciągniemy komponent `UserInfo`, który renderuje `Avatar` obok nazwy użytkownika: ```js{3-8} function UserInfo(props) { @@ -213,7 +213,7 @@ function UserInfo(props) { } ``` -This lets us simplify `Comment` even further: +To pozwala nam uprościć `Comment` jeszcze bardziej: ```js{4} function Comment(props) { @@ -233,7 +233,7 @@ function Comment(props) { [](codepen://components-and-props/extracting-components-continued) -Extracting components might seem like grunt work at first, but having a palette of reusable components pays off in larger apps. A good rule of thumb is that if a part of your UI is used several times (`Button`, `Panel`, `Avatar`), or is complex enough on its own (`App`, `FeedStory`, `Comment`), it is a good candidate to be a reusable component. +Wyciąganie komponentów może z początku wydawać się żmudnym zajęciem, ale posiadanie palety pozwalających na ponowne użycie komponentów jest opłacalne w większych aplikacjach. Dobrą praktyczną zasadą jest, że jeśli część twojego interfejsu użytkownika jest używana wiele razy (`Button`, `Panel`, `Avatar`) lub jest jest ona dostatecznie skomplikowana sama w sobie (`App`, `FeedStory`, `Comment`), jest ona dobrym kandydatem do stania się komponentem wielokrotnego użytku. ## Props are Read-Only {#props-are-read-only} From cd78f7c579467efb53aab09814ba7bcbe7c87ab7 Mon Sep 17 00:00:00 2001 From: Arkadiusz Mazurkiewicz Date: Wed, 6 Mar 2019 13:22:51 +0100 Subject: [PATCH 05/41] Translate `Props are Read-Only` section --- content/docs/components-and-props.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index d6f25e057..984867a3d 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -235,9 +235,9 @@ function Comment(props) { Wyciąganie komponentów może z początku wydawać się żmudnym zajęciem, ale posiadanie palety pozwalających na ponowne użycie komponentów jest opłacalne w większych aplikacjach. Dobrą praktyczną zasadą jest, że jeśli część twojego interfejsu użytkownika jest używana wiele razy (`Button`, `Panel`, `Avatar`) lub jest jest ona dostatecznie skomplikowana sama w sobie (`App`, `FeedStory`, `Comment`), jest ona dobrym kandydatem do stania się komponentem wielokrotnego użytku. -## Props are Read-Only {#props-are-read-only} +## Właściwości są tylko do odczytu {#props-are-read-only} -Whether you declare a component [as a function or a class](#function-and-class-components), it must never modify its own props. Consider this `sum` function: +Jeśli zadeklarujesz komponent [jako funkcja lub klasa](#function-and-class-components), nie może on nigdy modyfikować swoich właściwości. Rozważ tą funkcję `sum`: ```js function sum(a, b) { @@ -245,9 +245,9 @@ function sum(a, b) { } ``` -Such functions are called ["pure"](https://en.wikipedia.org/wiki/Pure_function) because they do not attempt to change their inputs, and always return the same result for the same inputs. +Funkcje tego typu nazywane są ["czystymi"](https://en.wikipedia.org/wiki/Pure_function), dlatego że nie próbują one zmieniać swoich wartości wejściowych i zawsze zwracają ten sam wynik dla tych samych wartości wejściowych. -In contrast, this function is impure because it changes its own input: +W przeciwieństwie do poprzedniej, ta funkcja nie jest czysta, bo zmienia swoją wartość wejściową. ```js function withdraw(account, amount) { @@ -255,8 +255,8 @@ function withdraw(account, amount) { } ``` -React is pretty flexible but it has a single strict rule: +React jest bardzo elastyczny, ale ma jedną ścisłą zasadę: -**All React components must act like pure functions with respect to their props.** +**Wszytkie komponenty muszą zachowywać się jak czyste funkcje w odniesieniu do ich własności.** -Of course, application UIs are dynamic and change over time. In the [next section](/docs/state-and-lifecycle.html), we will introduce a new concept of "state". State allows React components to change their output over time in response to user actions, network responses, and anything else, without violating this rule. +Oczywiście, interfejsy użytkownika aplikacji są dynamiczne i zmieniają się w czasie. W [kolejnym rozdziale](/docs/state-and-lifecycle.html), wprowadzimy nowe pojęcie "stanu". Stan pozwala reactowym komponentom na zmianę swojego wyniku w czasie w odpowiedzi na akcje użytkownika, żądania sieciowe i wszystko inne, bez naruszania tej zasady. \ No newline at end of file From 06d755e1c6d053004f35076972e74201f460c36c Mon Sep 17 00:00:00 2001 From: Arkadiusz Mazurkiewicz Date: Wed, 6 Mar 2019 13:38:42 +0100 Subject: [PATCH 06/41] Small translation details changes --- content/docs/components-and-props.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 984867a3d..b11d50aac 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -16,9 +16,9 @@ prev: rendering-elements.html next: state-and-lifecycle.html --- -Komponenty pozwalają ci podzielić interfejs użytkownika na niezależne, pozwalające na ponowne użycie części i myśleć o każdej z nich osobno. Ta strona dostarcza wprowadzenie do pojęcia komponentów. Możesz znaleźć [szczegółowe odniesienie do API komponentów tutaj](/docs/react-component.html). +Komponenty pozwalają ci podzielić interfejs użytkownika na niezależne, pozwalające na ponowne użycie części i myśleć o każdej z nich osobno. Ta strona wprowadza do pojęcia komponentów. Możesz znaleźć [szczegółowe odniesienie do API komponentów tutaj](/docs/react-component.html). -Koncepcyjnie, komponenty są jak javascriptowe funkcje. Przyjmują one arbirtalne wkłady (nazywane "właściwościami") i zwracają reactowe elementy opisujące co powinno się pojawić na ekranie. +Koncepcyjnie, komponenty są jak javascriptowe funkcje. Przyjmują one arbirtalne wartości wkładowe (nazywane "właściwościami") i zwracają reactowe elementy opisujące co powinno się pojawić na ekranie. ## Komponenty funkcyjne i klasowe {#function-and-class-components} @@ -32,7 +32,7 @@ function Welcome(props) { Ta funkcja jest uzasadnionym reactowym komponentem, bo przyjmuje pojedynczy argument "props" (który oznacza "właściwości" (ang. *properties*)) będący obiektem z danymi i zwraca reactowy element. Nazywamy takie komponenty "komponentami funkcyjnymi", bo są one dosłownie javascriptowymi funkcjami. -Możesz również używać [klasy ES6](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Classes) aby zdefiniować komponent: +Możesz również użyć [klasy ES6](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Classes) aby zdefiniować komponent: ```js class Welcome extends React.Component { @@ -44,7 +44,7 @@ class Welcome extends React.Component { Dwa powyższe komponenty są równoważne z punktu widzenia Reacta. -Klasy mają kilka dodatkowych cech, które przedyskutujemy w [kolejnych rozdziałach](/docs/state-and-lifecycle.html). Na ten czas bedziemy używać komponentów funkcyjnych dla ich zwięzłości. +Klasy mają kilka dodatkowych cech, które omówimy w [kolejnych rozdziałach](/docs/state-and-lifecycle.html). Na ten czas bedziemy używać komponentów funkcyjnych dla ich zwięzłości. ## Renderowanie komponentu {#rendering-a-component} @@ -89,7 +89,7 @@ Podsumujmy, co dzieje się w tym przykładzie: > >React traktuje komponenty zaczynające się od małej litery jako tagi drzewa DOM. Na przykład, `
` reprezentuje HTML'owy tag div, ale `` reprezentuje komponent i wymaga, aby `Welcome` było w zasięgu. > ->Aby dowiedzieć się więcej o uzasadnieniu tej konwencji, przeczytaj [JSX dogłębnie](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). +>Aby dowiedzieć się więcej o uzasadnieniu tej konwencji, przeczytaj [dogłębną analizę JSX](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). ## Kompozycja komponentów {#composing-components} @@ -173,7 +173,7 @@ function Avatar(props) { `Avatar` nie musi wiedzieć, że jest renderowany w środku komponentu `Comment`. Dlatego też daliśmy jego właściwości bardziej ogólną nazwę: `użytkownik` (ang. *user*) zamiast `autor`. -Polecamy nazywać właściwości z własnego punktu widzenia komponentu zamiast kontekstu, w którym jest używany. +Polecamy nazywać właściwości z punktu widzenia komponentu, a nie kontekstu, w którym jest używany. Możemy teraz dodać do komponentu `Comment` drobne uproszczenie: @@ -237,7 +237,7 @@ Wyciąganie komponentów może z początku wydawać się żmudnym zajęciem, ale ## Właściwości są tylko do odczytu {#props-are-read-only} -Jeśli zadeklarujesz komponent [jako funkcja lub klasa](#function-and-class-components), nie może on nigdy modyfikować swoich właściwości. Rozważ tą funkcję `sum`: +Bez względu na to, czy zadeklarujesz komponent [jako funkcja czy klasa](#function-and-class-components), nie może on nigdy modyfikować swoich właściwości. Rozważ tą funkcję `sum`: ```js function sum(a, b) { @@ -257,6 +257,6 @@ function withdraw(account, amount) { React jest bardzo elastyczny, ale ma jedną ścisłą zasadę: -**Wszytkie komponenty muszą zachowywać się jak czyste funkcje w odniesieniu do ich własności.** +**Wszytkie komponenty muszą zachowywać się jak czyste funkcje w odniesieniu do ich właściwości.** Oczywiście, interfejsy użytkownika aplikacji są dynamiczne i zmieniają się w czasie. W [kolejnym rozdziale](/docs/state-and-lifecycle.html), wprowadzimy nowe pojęcie "stanu". Stan pozwala reactowym komponentom na zmianę swojego wyniku w czasie w odpowiedzi na akcje użytkownika, żądania sieciowe i wszystko inne, bez naruszania tej zasady. \ No newline at end of file From 879859f37b72f57d63e916ae5935223685835401 Mon Sep 17 00:00:00 2001 From: Arkadiusz Mazurkiewicz Date: Wed, 6 Mar 2019 13:44:58 +0100 Subject: [PATCH 07/41] Change MDN docs link to polish version --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index b11d50aac..6fce76cf9 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -32,7 +32,7 @@ function Welcome(props) { Ta funkcja jest uzasadnionym reactowym komponentem, bo przyjmuje pojedynczy argument "props" (który oznacza "właściwości" (ang. *properties*)) będący obiektem z danymi i zwraca reactowy element. Nazywamy takie komponenty "komponentami funkcyjnymi", bo są one dosłownie javascriptowymi funkcjami. -Możesz również użyć [klasy ES6](https://developer.mozilla.org/en/docs/Web/JavaScript/Reference/Classes) aby zdefiniować komponent: +Możesz również użyć [klasy ES6](https://developer.mozilla.org/pl/docs/Web/JavaScript/Reference/Classes) aby zdefiniować komponent: ```js class Welcome extends React.Component { From e198ef61925bc33d3444c111b40914ea54be05b5 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:17:24 +0100 Subject: [PATCH 08/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 6fce76cf9..8055e54b1 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -16,7 +16,7 @@ prev: rendering-elements.html next: state-and-lifecycle.html --- -Komponenty pozwalają ci podzielić interfejs użytkownika na niezależne, pozwalające na ponowne użycie części i myśleć o każdej z nich osobno. Ta strona wprowadza do pojęcia komponentów. Możesz znaleźć [szczegółowe odniesienie do API komponentów tutaj](/docs/react-component.html). +Komponenty pozwalają podzielić interfejs użytkownika na niezależne, pozwalające na ponowne użycie części i myśleć o każdej z nich osobno. Ta strona wprowadza do pojęcia komponentów. W osobnym rozdziale opisaliśmy [szczegółową dokumentację API komponentów](/docs/react-component.html). Koncepcyjnie, komponenty są jak javascriptowe funkcje. Przyjmują one arbirtalne wartości wkładowe (nazywane "właściwościami") i zwracają reactowe elementy opisujące co powinno się pojawić na ekranie. @@ -259,4 +259,4 @@ React jest bardzo elastyczny, ale ma jedną ścisłą zasadę: **Wszytkie komponenty muszą zachowywać się jak czyste funkcje w odniesieniu do ich właściwości.** -Oczywiście, interfejsy użytkownika aplikacji są dynamiczne i zmieniają się w czasie. W [kolejnym rozdziale](/docs/state-and-lifecycle.html), wprowadzimy nowe pojęcie "stanu". Stan pozwala reactowym komponentom na zmianę swojego wyniku w czasie w odpowiedzi na akcje użytkownika, żądania sieciowe i wszystko inne, bez naruszania tej zasady. \ No newline at end of file +Oczywiście, interfejsy użytkownika aplikacji są dynamiczne i zmieniają się w czasie. W [kolejnym rozdziale](/docs/state-and-lifecycle.html), wprowadzimy nowe pojęcie "stanu". Stan pozwala reactowym komponentom na zmianę swojego wyniku w czasie w odpowiedzi na akcje użytkownika, żądania sieciowe i wszystko inne, bez naruszania tej zasady. From 8300056d9564ca4d01b5f8ea096ea47e1b8ed62b Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:21:04 +0100 Subject: [PATCH 09/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 8055e54b1..9ea3532de 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -18,7 +18,7 @@ next: state-and-lifecycle.html Komponenty pozwalają podzielić interfejs użytkownika na niezależne, pozwalające na ponowne użycie części i myśleć o każdej z nich osobno. Ta strona wprowadza do pojęcia komponentów. W osobnym rozdziale opisaliśmy [szczegółową dokumentację API komponentów](/docs/react-component.html). -Koncepcyjnie, komponenty są jak javascriptowe funkcje. Przyjmują one arbirtalne wartości wkładowe (nazywane "właściwościami") i zwracają reactowe elementy opisujące co powinno się pojawić na ekranie. +Koncepcyjnie, komponenty są jak javascriptowe funkcje. Przyjmują one arbitralne wartości na wejściu (nazywane "właściwościami" (ang. *props*)) i zwracają reactowe elementy opisujące, co powinno się pojawić na ekranie. ## Komponenty funkcyjne i klasowe {#function-and-class-components} From 7f9b37a18ce3691ee5d5879f3124fc92c62a0d85 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:21:57 +0100 Subject: [PATCH 10/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 9ea3532de..056db4a36 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -30,7 +30,7 @@ function Welcome(props) { } ``` -Ta funkcja jest uzasadnionym reactowym komponentem, bo przyjmuje pojedynczy argument "props" (który oznacza "właściwości" (ang. *properties*)) będący obiektem z danymi i zwraca reactowy element. Nazywamy takie komponenty "komponentami funkcyjnymi", bo są one dosłownie javascriptowymi funkcjami. +Ta funkcja jest poprawnym reactowym komponentem, ponieważ przyjmuje pojedynczy argument "props" (który oznacza "właściwości" (z ang. *properties*)), będący obiektem z danymi, i zwraca reactowy element. Takie komponenty nazywamy "komponentami funkcyjnymi", gdyż są one dosłownie javascriptowymi funkcjami. Możesz również użyć [klasy ES6](https://developer.mozilla.org/pl/docs/Web/JavaScript/Reference/Classes) aby zdefiniować komponent: From ee5862c1a374afae2a773b7bf85ee367c4f7b63a Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:23:15 +0100 Subject: [PATCH 11/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 056db4a36..1b66d26b5 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -32,7 +32,7 @@ function Welcome(props) { Ta funkcja jest poprawnym reactowym komponentem, ponieważ przyjmuje pojedynczy argument "props" (który oznacza "właściwości" (z ang. *properties*)), będący obiektem z danymi, i zwraca reactowy element. Takie komponenty nazywamy "komponentami funkcyjnymi", gdyż są one dosłownie javascriptowymi funkcjami. -Możesz również użyć [klasy ES6](https://developer.mozilla.org/pl/docs/Web/JavaScript/Reference/Classes) aby zdefiniować komponent: +Do zdefiniowania komponentu możesz również użyć [klasy ze standardu ES6](https://developer.mozilla.org/pl/docs/Web/JavaScript/Reference/Classes): ```js class Welcome extends React.Component { From fcce1bc2700564a533cbe7c1fea5bdd2e98026c0 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:23:50 +0100 Subject: [PATCH 12/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 1b66d26b5..f3e3c2fe2 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -42,7 +42,7 @@ class Welcome extends React.Component { } ``` -Dwa powyższe komponenty są równoważne z punktu widzenia Reacta. +Obydwa powyższe komponenty są równoważne z punktu widzenia Reacta. Klasy mają kilka dodatkowych cech, które omówimy w [kolejnych rozdziałach](/docs/state-and-lifecycle.html). Na ten czas bedziemy używać komponentów funkcyjnych dla ich zwięzłości. From 2d35d16045de806b18120d316a470f61a11a5a49 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:25:20 +0100 Subject: [PATCH 13/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index f3e3c2fe2..78f3cdc00 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -48,7 +48,7 @@ Klasy mają kilka dodatkowych cech, które omówimy w [kolejnych rozdziałach](/ ## Renderowanie komponentu {#rendering-a-component} -Poprzednio, napotykaliśmy reactowe elementy, które reprezentowały tagi drzewa DOM: +Poprzednio napotykaliśmy reactowe elementy, które reprezentowały znaczniki DOM: ```js const element =
; From 939d755de6913cfdc7a3e10457e6a9be7b736025 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:25:50 +0100 Subject: [PATCH 14/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 78f3cdc00..820826161 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -54,7 +54,7 @@ Poprzednio napotykaliśmy reactowe elementy, które reprezentowały znaczniki DO const element =
; ``` -Natomiast elementy mogą również reprezentować komponenty zdefiniowane przez użytkownika: +Elementy mogą również reprezentować komponenty zdefiniowane przez użytkownika: ```js const element = ; From 37154df78ec42e0178229f0b67d5bf40aab6e3be Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:26:37 +0100 Subject: [PATCH 15/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 820826161..65764b153 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -60,7 +60,7 @@ Elementy mogą również reprezentować komponenty zdefiniowane przez użytkowni const element = ; ``` -Kiedy React widzi element reprezentujący komponent zdefiniowany przez użytkownika, przekazuje on do niego JSX'owe atrybuty jako jeden obiekt. Nazywamy ten obiekt "właściwościami". +Kiedy React widzi element reprezentujący komponent zdefiniowany przez użytkownika, przekazuje do niego JSX-owe atrybuty jako jeden obiekt. Obiekt ten nazywamy "właściwościami" komponentu. Na przykład, ten kod renderuje "Cześć, Sara" na stronie: From 279d6b85fadd4a33410446344ec185d01e6cf7a0 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:26:54 +0100 Subject: [PATCH 16/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 65764b153..af95d397f 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -62,7 +62,7 @@ const element = ; Kiedy React widzi element reprezentujący komponent zdefiniowany przez użytkownika, przekazuje do niego JSX-owe atrybuty jako jeden obiekt. Obiekt ten nazywamy "właściwościami" komponentu. -Na przykład, ten kod renderuje "Cześć, Sara" na stronie: +Dla przykładu, poniższy kod renderuje na stronie napis "Cześć, Sara": ```js{1,5} function Welcome(props) { From b6badbdbddc0441964d111331d28bc6e48984190 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:28:18 +0100 Subject: [PATCH 17/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index af95d397f..dbc46134c 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -81,7 +81,7 @@ ReactDOM.render( Podsumujmy, co dzieje się w tym przykładzie: 1. Wywołujemy `ReactDOM.render()` z elementem ``. -2. React wywołuje komponent `Welcome` z `{name: 'Sara'}` jako właściwości. +2. React wywołuje komponent `Welcome` z właściwościami `{name: 'Sara'}`. 3. Nasz komponent `Welcome` zwraca jako wynik element `

Hello, Sara

`. 4. React DOM wydajnie uaktualinia drzewo DOM, aby równało się `

Hello, Sara

`. From 30f64233186b490ecead7a5ceaa6361f99f5ab6a Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:28:36 +0100 Subject: [PATCH 18/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index dbc46134c..a9301a84d 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -82,7 +82,7 @@ Podsumujmy, co dzieje się w tym przykładzie: 1. Wywołujemy `ReactDOM.render()` z elementem ``. 2. React wywołuje komponent `Welcome` z właściwościami `{name: 'Sara'}`. -3. Nasz komponent `Welcome` zwraca jako wynik element `

Hello, Sara

`. +3. Nasz komponent `Welcome` jako wynik zwraca element `

Cześć, Sara

`. 4. React DOM wydajnie uaktualinia drzewo DOM, aby równało się `

Hello, Sara

`. >**Wskazówka:** Zawsze zaczynaj nazwy komponentów od dużej litery. From 281ad739e5abc40d8926d627492a58e1e8e734cb Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:28:59 +0100 Subject: [PATCH 19/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index a9301a84d..de2cc57d9 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -83,7 +83,7 @@ Podsumujmy, co dzieje się w tym przykładzie: 1. Wywołujemy `ReactDOM.render()` z elementem ``. 2. React wywołuje komponent `Welcome` z właściwościami `{name: 'Sara'}`. 3. Nasz komponent `Welcome` jako wynik zwraca element `

Cześć, Sara

`. -4. React DOM wydajnie uaktualinia drzewo DOM, aby równało się `

Hello, Sara

`. +4. React DOM w optymalny sposób aktualizuje drzewo DOM, aby odpowiadało elementowi `

Cześć, Sara

`. >**Wskazówka:** Zawsze zaczynaj nazwy komponentów od dużej litery. > From 922378fb4c4e94409b384ace9f5401ef81cc2e61 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:30:06 +0100 Subject: [PATCH 20/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index de2cc57d9..bf86fa154 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -87,7 +87,7 @@ Podsumujmy, co dzieje się w tym przykładzie: >**Wskazówka:** Zawsze zaczynaj nazwy komponentów od dużej litery. > ->React traktuje komponenty zaczynające się od małej litery jako tagi drzewa DOM. Na przykład, `
` reprezentuje HTML'owy tag div, ale `` reprezentuje komponent i wymaga, aby `Welcome` było w zasięgu. +>React traktuje komponenty zaczynające się od małej litery jako tagi drzewa DOM. Na przykład, `
` reprezentuje HTML-owy znacznik 'div', ale już `` reprezentuje komponent i wymaga, aby `Welcome` było w zasięgu (ang. *scope*). > >Aby dowiedzieć się więcej o uzasadnieniu tej konwencji, przeczytaj [dogłębną analizę JSX](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). From 10db43ff35683c10b7dd6a9d96cb2848d478f7b3 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:30:33 +0100 Subject: [PATCH 21/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index bf86fa154..0a5c67111 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -89,7 +89,7 @@ Podsumujmy, co dzieje się w tym przykładzie: > >React traktuje komponenty zaczynające się od małej litery jako tagi drzewa DOM. Na przykład, `
` reprezentuje HTML-owy znacznik 'div', ale już `` reprezentuje komponent i wymaga, aby `Welcome` było w zasięgu (ang. *scope*). > ->Aby dowiedzieć się więcej o uzasadnieniu tej konwencji, przeczytaj [dogłębną analizę JSX](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). +>Aby dowiedzieć się więcej o uzasadnieniu tej konwencji, przeczytaj [dogłębną analizę składni JSX](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized). ## Kompozycja komponentów {#composing-components} From 309ec5ae6d6b08eeccdd5c7d279104c968e74898 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:31:27 +0100 Subject: [PATCH 22/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 0a5c67111..602b745fe 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -93,7 +93,7 @@ Podsumujmy, co dzieje się w tym przykładzie: ## Kompozycja komponentów {#composing-components} -Komponenty mogą odwoływać się do innych komponentów i ich wyników. To pozwala nam na używanie tej samej abstrakcji komponentu na dowolnym poziomie szczegółowości. +Komponenty przy zwracaniu wyniku mogą mogą odwoływać się do innych komponentów. Pozwala to używać tej samej abstrakcji komponentu na dowolnym poziomie szczegółowości. Przycisk, formularz, okno dialogowe, ekran - w aplikacjach reactowych tego typu składniki są zwykle reprezentowane przez dedykowane komponenty. Na przykład możemy stworzyć komponent `App`, który renderuje `Welcome` wiele razy: From a626d5aacca5a12718b866b4366a9178bdddb7e2 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:31:46 +0100 Subject: [PATCH 23/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 602b745fe..49a6d2644 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -95,7 +95,7 @@ Podsumujmy, co dzieje się w tym przykładzie: Komponenty przy zwracaniu wyniku mogą mogą odwoływać się do innych komponentów. Pozwala to używać tej samej abstrakcji komponentu na dowolnym poziomie szczegółowości. Przycisk, formularz, okno dialogowe, ekran - w aplikacjach reactowych tego typu składniki są zwykle reprezentowane przez dedykowane komponenty. -Na przykład możemy stworzyć komponent `App`, który renderuje `Welcome` wiele razy: +Możemy dla przykładu stworzyć komponent `App`, który wielokrotnie renderuje komponent `Welcome`: ```js{8-10} function Welcome(props) { From 234aafb5da4d38562c37ccc22ce9d8381922d717 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:33:07 +0100 Subject: [PATCH 24/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 49a6d2644..e5f41f37a 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -120,7 +120,7 @@ ReactDOM.render( [](codepen://components-and-props/composing-components) -Zazwyczaj, nowe reactowe aplikacje mają pojedynczy komponent `App` u samej góry. Natomiast, jeśli będziesz integrował Reacta z istniejącą aplikacją, możesz zacząć od dołu z małymi komponentami jak na przykład `Button` i stopniowo wypracować sobie drogę na szczyt hierarchii widoku. +Nowe aplikacje reactowe na samej górze drzewa zazwyczaj renderują pojedynczy komponent `App`. Jeśli jednak musisz zintegrować Reacta z istniejącą aplikacją, możesz zacząć od samego dołu, dodając niewielkie komponenty (np. `Button`) i stopniowo przepisywać całą strukturę aż do samej góry. ## Wyciąganie komponentów {#extracting-components} From cccc7d1542db4bdf0aa21042b0f52323f2bdb2db Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:33:24 +0100 Subject: [PATCH 25/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index e5f41f37a..dd87a64fd 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -124,7 +124,7 @@ Nowe aplikacje reactowe na samej górze drzewa zazwyczaj renderują pojedynczy k ## Wyciąganie komponentów {#extracting-components} -Nie bój się dzielenia komponentów na mniejsce komponenty. +Nie bój się dzielenia komponentów na mniejsze części. Na przykład rozważ ten komponent `Commment`: From 9e489eb1a5329f5f92c30478064a91804a5143a4 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:33:39 +0100 Subject: [PATCH 26/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index dd87a64fd..2f7f6ec30 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -126,7 +126,7 @@ Nowe aplikacje reactowe na samej górze drzewa zazwyczaj renderują pojedynczy k Nie bój się dzielenia komponentów na mniejsze części. -Na przykład rozważ ten komponent `Commment`: +Rozważ poniższy komponent `Commment`: ```js function Comment(props) { From 1300296fe02b1bd5700c435343bc0405b5b3871f Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:34:24 +0100 Subject: [PATCH 27/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 2f7f6ec30..8ed08ea54 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -154,7 +154,7 @@ function Comment(props) { [](codepen://components-and-props/extracting-components) -Przyjmuje on `autora` (ang. *author*) - obiekt, `text` - string i `datę` (ang. *date*) jako właściwości, oraz opisuje komentarz na stronie mediów społecznościowych. +Przyjmuje on obiekt `author`, napis `text` i datę `date` jako właściwości i zwraca strukturę opisującą komentarz na portalu mediów społecznościowych. Zmiana tego komponentu może być zawiła z powodu całego tego zagnieżdżenia, a ponowne użycie jego indywidulnych części jest trudne. Wyciągnijmy z niego kilka komponentów. From 17d16a9e34ec9f74bc769b4243669ed8aca88dce Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:34:48 +0100 Subject: [PATCH 28/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 8ed08ea54..a7a0a8a57 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -156,7 +156,7 @@ function Comment(props) { Przyjmuje on obiekt `author`, napis `text` i datę `date` jako właściwości i zwraca strukturę opisującą komentarz na portalu mediów społecznościowych. -Zmiana tego komponentu może być zawiła z powodu całego tego zagnieżdżenia, a ponowne użycie jego indywidulnych części jest trudne. Wyciągnijmy z niego kilka komponentów. +Zmiana tego komponentu czy ponowne użycie jego poszczególnych części może okazać się skomplikowane z powodu całego tego zagnieżdżenia. Rozbijmy go zatem na kilka mniejszych komponentów. Najpierw, wyciągniemy `Avatar`: From 1a2998b952294402a2aaddcce5b9b5321ab63bf3 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:35:04 +0100 Subject: [PATCH 29/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index a7a0a8a57..b70357125 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -158,7 +158,7 @@ Przyjmuje on obiekt `author`, napis `text` i datę `date` jako właściwości i Zmiana tego komponentu czy ponowne użycie jego poszczególnych części może okazać się skomplikowane z powodu całego tego zagnieżdżenia. Rozbijmy go zatem na kilka mniejszych komponentów. -Najpierw, wyciągniemy `Avatar`: +Najpierw wydzielmy komponent `Avatar`: ```js{3-6} function Avatar(props) { From 8bc0be5919d9dfb826f8131d65869e057fd38248 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:35:47 +0100 Subject: [PATCH 30/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index b70357125..05a6e1ea4 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -171,7 +171,7 @@ function Avatar(props) { } ``` -`Avatar` nie musi wiedzieć, że jest renderowany w środku komponentu `Comment`. Dlatego też daliśmy jego właściwości bardziej ogólną nazwę: `użytkownik` (ang. *user*) zamiast `autor`. +`Avatar` nie musi wiedzieć, że jest renderowany wewnątrz komponentu `Comment`. Dlatego też daliśmy jego właściwości bardziej ogólną nazwę `user` zamiast `author`. Polecamy nazywać właściwości z punktu widzenia komponentu, a nie kontekstu, w którym jest używany. From 753cc6643d5b360c8260f9c0e8f89445dc66e835 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:37:19 +0100 Subject: [PATCH 31/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 05a6e1ea4..b6bf1f289 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -173,7 +173,7 @@ function Avatar(props) { `Avatar` nie musi wiedzieć, że jest renderowany wewnątrz komponentu `Comment`. Dlatego też daliśmy jego właściwości bardziej ogólną nazwę `user` zamiast `author`. -Polecamy nazywać właściwości z punktu widzenia komponentu, a nie kontekstu, w którym jest używany. +Zalecamy nadawanie nazw właściwościom z punktu widzenia komponentu, a nie kontekstu, w którym jest używany. Możemy teraz dodać do komponentu `Comment` drobne uproszczenie: From e65dedd72f625050599179b15df72897f7144e6c Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:37:38 +0100 Subject: [PATCH 32/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index b6bf1f289..fa9a7b806 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -175,7 +175,7 @@ function Avatar(props) { Zalecamy nadawanie nazw właściwościom z punktu widzenia komponentu, a nie kontekstu, w którym jest używany. -Możemy teraz dodać do komponentu `Comment` drobne uproszczenie: +Możemy teraz uprościć nieco komponent `Comment`: ```js{5} function Comment(props) { From 45b354b9904b683738a2cfbe25f51d6ec09b13cf Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:38:07 +0100 Subject: [PATCH 33/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index fa9a7b806..f95012c1b 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -198,7 +198,7 @@ function Comment(props) { } ``` -Następnie wyciągniemy komponent `UserInfo`, który renderuje `Avatar` obok nazwy użytkownika: +Następnie wydzielmy komponent `UserInfo`, który wyrenderuje `Avatar` obok nazwy użytkownika: ```js{3-8} function UserInfo(props) { From 0040e766154f04cc33b29331dfd90fa57f589784 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:40:02 +0100 Subject: [PATCH 34/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index f95012c1b..e3842cec4 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -233,7 +233,7 @@ function Comment(props) { [](codepen://components-and-props/extracting-components-continued) -Wyciąganie komponentów może z początku wydawać się żmudnym zajęciem, ale posiadanie palety pozwalających na ponowne użycie komponentów jest opłacalne w większych aplikacjach. Dobrą praktyczną zasadą jest, że jeśli część twojego interfejsu użytkownika jest używana wiele razy (`Button`, `Panel`, `Avatar`) lub jest jest ona dostatecznie skomplikowana sama w sobie (`App`, `FeedStory`, `Comment`), jest ona dobrym kandydatem do stania się komponentem wielokrotnego użytku. +Wyciąganie komponentów może z początku wydawać się żmudnym zajęciem, ale posiadanie palety pozwalających na ponowne użycie komponentów jest opłacalne w większych aplikacjach. Dobrą praktyczną zasadą jest, że jeśli część twojego interfejsu użytkownika jest używana wielokrotnie (np. `Button`, `Panel`, `Avatar`) lub jest ona dostatecznie skomplikowana sama w sobie (np. `App`, `FeedStory`, `Comment`), jest ona dobrym kandydatem do stania się komponentem wielokrotnego użytku. ## Właściwości są tylko do odczytu {#props-are-read-only} From f7fa8549dc2bf5b374bd131deebf2ac9c68f637b Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:40:36 +0100 Subject: [PATCH 35/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index e3842cec4..330e76a47 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -237,7 +237,7 @@ Wyciąganie komponentów może z początku wydawać się żmudnym zajęciem, ale ## Właściwości są tylko do odczytu {#props-are-read-only} -Bez względu na to, czy zadeklarujesz komponent [jako funkcja czy klasa](#function-and-class-components), nie może on nigdy modyfikować swoich właściwości. Rozważ tą funkcję `sum`: +Bez względu na to, czy zadeklarujesz komponent [jako funkcję czy klasę](#function-and-class-components), nie może on nigdy modyfikować swoich właściwości. Rozważ następującą funkcję `sum`: ```js function sum(a, b) { From 5e8bdbdfd644d045250b1eaff9bf220598d74b65 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:41:44 +0100 Subject: [PATCH 36/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 330e76a47..a4a64c66d 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -245,7 +245,7 @@ function sum(a, b) { } ``` -Funkcje tego typu nazywane są ["czystymi"](https://en.wikipedia.org/wiki/Pure_function), dlatego że nie próbują one zmieniać swoich wartości wejściowych i zawsze zwracają ten sam wynik dla tych samych wartości wejściowych. +Funkcje tego typu nazywane są ["czystymi"](https://en.wikipedia.org/wiki/Pure_function) (ang. *pure function*), dlatego że nie próbują one zmieniać swoich argumentów i zawsze zwracają ten sam wynik dla tych samych argumentów. W przeciwieństwie do poprzedniej, ta funkcja nie jest czysta, bo zmienia swoją wartość wejściową. From c76cf15f5639461dce8b4b84b4dd78b868774876 Mon Sep 17 00:00:00 2001 From: jakubdrozdek <30927218+jakubdrozdek@users.noreply.github.com> Date: Mon, 11 Mar 2019 20:42:20 +0100 Subject: [PATCH 37/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index a4a64c66d..e277c9fb6 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -247,7 +247,7 @@ function sum(a, b) { Funkcje tego typu nazywane są ["czystymi"](https://en.wikipedia.org/wiki/Pure_function) (ang. *pure function*), dlatego że nie próbują one zmieniać swoich argumentów i zawsze zwracają ten sam wynik dla tych samych argumentów. -W przeciwieństwie do poprzedniej, ta funkcja nie jest czysta, bo zmienia swoją wartość wejściową. +W przeciwieństwie do poprzedniej funkcji, ta poniżej nie jest "czysta", ponieważ zmienia swój argument. ```js function withdraw(account, amount) { From 36a975f3b4d5c69ab926942f930ed0862d228b2b Mon Sep 17 00:00:00 2001 From: Arkadiusz Mazurkiewicz Date: Mon, 11 Mar 2019 21:04:32 +0100 Subject: [PATCH 38/41] Add small suggested translation changes --- content/docs/components-and-props.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index e277c9fb6..3d00e5faf 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -44,7 +44,7 @@ class Welcome extends React.Component { Obydwa powyższe komponenty są równoważne z punktu widzenia Reacta. -Klasy mają kilka dodatkowych cech, które omówimy w [kolejnych rozdziałach](/docs/state-and-lifecycle.html). Na ten czas bedziemy używać komponentów funkcyjnych dla ich zwięzłości. +Klasy mają kilka dodatkowych cech, które omówimy w [kolejnych rozdziałach](/docs/state-and-lifecycle.html). Do tego czasu będziemy używać komponentów funkcyjnych ze względu na ich zwięzły zapis. ## Renderowanie komponentu {#rendering-a-component} @@ -259,4 +259,4 @@ React jest bardzo elastyczny, ale ma jedną ścisłą zasadę: **Wszytkie komponenty muszą zachowywać się jak czyste funkcje w odniesieniu do ich właściwości.** -Oczywiście, interfejsy użytkownika aplikacji są dynamiczne i zmieniają się w czasie. W [kolejnym rozdziale](/docs/state-and-lifecycle.html), wprowadzimy nowe pojęcie "stanu". Stan pozwala reactowym komponentom na zmianę swojego wyniku w czasie w odpowiedzi na akcje użytkownika, żądania sieciowe i wszystko inne, bez naruszania tej zasady. +Rzecz jasna, interfejsy użytkownika w aplikacjach są zwykle dynamiczne, zmieniają się w czasie. W [kolejnym rozdziale](/docs/state-and-lifecycle.html) wprowadzimy nowe pojęcie "stanu". Stan pozwala reactowym komponentom na zmianę swojego wyniku w czasie, w odpowiedzi na akcje użytkownika, żądania sieciowe itp. bez naruszania powyższej zasady. From 0a69b1eabcc3c435be5e48f8464a6c0e08f9ce8d Mon Sep 17 00:00:00 2001 From: Jakub Frej Date: Tue, 12 Mar 2019 08:42:31 +0100 Subject: [PATCH 39/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 3d00e5faf..428439aa7 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -30,7 +30,7 @@ function Welcome(props) { } ``` -Ta funkcja jest poprawnym reactowym komponentem, ponieważ przyjmuje pojedynczy argument "props" (który oznacza "właściwości" (z ang. *properties*)), będący obiektem z danymi, i zwraca reactowy element. Takie komponenty nazywamy "komponentami funkcyjnymi", gdyż są one dosłownie javascriptowymi funkcjami. +Ta funkcja jest poprawnym reactowym komponentem, ponieważ przyjmuje pojedynczy argument "props" (który oznacza "właściwości", z ang. *properties*), będący obiektem z danymi, i zwraca reactowy element. Takie komponenty nazywamy "komponentami funkcyjnymi", gdyż są one dosłownie javascriptowymi funkcjami. Do zdefiniowania komponentu możesz również użyć [klasy ze standardu ES6](https://developer.mozilla.org/pl/docs/Web/JavaScript/Reference/Classes): From fb3393a5eb4e2bd9623281c1e8f4f3d46cc70e42 Mon Sep 17 00:00:00 2001 From: Jakub Frej Date: Tue, 12 Mar 2019 08:42:48 +0100 Subject: [PATCH 40/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 428439aa7..44357821f 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -126,7 +126,7 @@ Nowe aplikacje reactowe na samej górze drzewa zazwyczaj renderują pojedynczy k Nie bój się dzielenia komponentów na mniejsze części. -Rozważ poniższy komponent `Commment`: +Rozważ poniższy komponent `Comment`: ```js function Comment(props) { From 163f195c09bd050516e7c95be11f954a79786711 Mon Sep 17 00:00:00 2001 From: Jakub Frej Date: Tue, 12 Mar 2019 08:43:05 +0100 Subject: [PATCH 41/41] Update content/docs/components-and-props.md Co-Authored-By: arekmaz --- content/docs/components-and-props.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/docs/components-and-props.md b/content/docs/components-and-props.md index 44357821f..1fdfce906 100644 --- a/content/docs/components-and-props.md +++ b/content/docs/components-and-props.md @@ -259,4 +259,4 @@ React jest bardzo elastyczny, ale ma jedną ścisłą zasadę: **Wszytkie komponenty muszą zachowywać się jak czyste funkcje w odniesieniu do ich właściwości.** -Rzecz jasna, interfejsy użytkownika w aplikacjach są zwykle dynamiczne, zmieniają się w czasie. W [kolejnym rozdziale](/docs/state-and-lifecycle.html) wprowadzimy nowe pojęcie "stanu". Stan pozwala reactowym komponentom na zmianę swojego wyniku w czasie, w odpowiedzi na akcje użytkownika, żądania sieciowe itp. bez naruszania powyższej zasady. +Rzecz jasna, interfejsy użytkownika w aplikacjach są zwykle dynamiczne, zmieniają się w czasie. W [kolejnym rozdziale](/docs/state-and-lifecycle.html) wprowadzimy nowe pojęcie "stanu". Stan pozwala komponentom reactowym na zmianę swojego wyniku w czasie, w odpowiedzi na akcje użytkownika, żądania sieciowe itp. bez naruszania powyższej zasady.