Skip to content

Commit 6dbe405

Browse files
committed
resolve @jakubdrozdek suggestions
1 parent dba7f0a commit 6dbe405

File tree

1 file changed

+42
-42
lines changed

1 file changed

+42
-42
lines changed

content/docs/code-splitting.md

Lines changed: 42 additions & 42 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ permalink: docs/code-splitting.html
66

77
## Pakowanie {#bundling}
88

9-
Większość Reactowych aplikacji będzie "dołączała" swoje pliki przez narzędzia takie jak
9+
Większość reactowych aplikacji będzie "dołączała" swoje pliki poprzez narzędzia takie jak
1010
[Webpack](https://webpack.js.org/) czy [Browserify](http://browserify.org/).
11-
Pakowanie to proces śledzenia zaimportowanych plików i łączenia je w pojedynczy plik "bundle".
12-
Tak zbudowany pakiet jest gotowy do umieszczenia na stronie aby załadować całą aplikację.
11+
Pakowanie to proces śledzenia zaimportowanych plików i łączenia ich w pojedynczy plik "bundle" (pol. *paczka*).
12+
Tak zbudowany pakiet jest gotowy do umieszczenia na stronie w celu załadowania całej aplikacji naraz.
1313

1414
#### Przykład {#example}
1515

16-
**App:**
16+
**Kod aplikacji:**
1717

1818
```js
1919
// app.js
@@ -29,7 +29,7 @@ export function add(a, b) {
2929
}
3030
```
3131

32-
**Bundle:**
32+
**Paczka:**
3333

3434
```js
3535
function add(a, b) {
@@ -39,23 +39,23 @@ function add(a, b) {
3939
console.log(add(16, 26)); // 42
4040
```
4141

42-
> Notatka:
42+
> Uwaga:
4343
>
44-
> Twoje pakiety prawdopodobnie będą wyglądać znacznie inaczej
44+
> Twoje paczki prawdopodobnie będą się znacząco różnić.
4545
4646
Jeśli używasz [Create React App](https://github.com/facebookincubator/create-react-app),
47-
[Next.js](https://github.com/zeit/next.js/), [Gatsby](https://www.gatsbyjs.org/),
48-
lub innego podobnego narzędzia, będziesz miał gotową do pakowania konfigurację Webpacka.
47+
[Next.js](https://github.com/zeit/next.js/), [Gatsby](https://www.gatsbyjs.org/)
48+
lub innego podobnego narzędzia, Webpack powinien być już skonfigurowany i gotowy do użytku.
4949

50-
Jeśli nie, będziesz potrzebował samodzielnie skonfigurować webpacka.
51-
Dla przykładu zerknij na przewodnik po
52-
[Instalacji](https://webpack.js.org/guides/installation/) oraz
53-
[Podstawowe informacje](https://webpack.js.org/guides/getting-started/) zawarte w dokumentacji
50+
Jeśli nie, musisz skonfigurować Webpacka samodzielnie.
51+
Przykłady znajdziesz w
52+
[przewodniku po instalacji](https://webpack.js.org/guides/installation/) oraz
53+
w sekcji pt. ["Podstawowe informacje"](https://webpack.js.org/guides/getting-started/) zawartych w dokumentacji
5454
Webpacka.
5555

5656
## Dzielenie kodu {#code-splitting}
5757

58-
Pakowanie jest świetne, ale wraz ze wzrostem twojej aplikacji, rośnie również paczka.
58+
Tworzenie paczek jest świetne, ale wraz ze wzrostem objętości kodu twojej aplikacji, rośnie również objętość paczek.
5959
Zwłaszcza gdy dołączasz do projektu duże, zewnętrzne biblioteki.
6060
Musisz pilnować, aby twój pakiet nie był zbyt duży, ponieważ wtedy aplikacja
6161
będzie się długo ładowała.
@@ -64,17 +64,17 @@ Aby uniknąć problemu zbyt dużego pakietu, warto już na początku o tym pomy
6464
i rozpocząć "dzielenie" swojej paczki.
6565
[Dzielenie kodu](https://webpack.js.org/guides/code-splitting/) to funkcja
6666
wspierana przez narzędzia takie jak Webpack oraz Browserify (przez
67-
[factor-bundle](https://github.com/browserify/factor-bundle)) które mogą tworzyć
68-
wiele dynamicznie ładujących się pakietów w czasie wykonania.
67+
[factor-bundle](https://github.com/browserify/factor-bundle)), które mogą tworzyć
68+
wiele pakietów doładowywanych dynamicznie w czasie wykonania kodu aplikacji.
6969

7070
Dzielenie kodu ułatwi ci "leniwe ładowanie" tylko aktualnie wymaganych przez
7171
użytkownika zasobów, co może znacznie poprawić wydajność twojej aplikacji.
72-
Mimo, że sumarycznie nie zmniejszasz ilości kodu, unikasz ładowania
73-
w danym momencie zbędnych dla użytkownika funkcji, co przekłada się na mniejszą ilość kodu do pobrania.
72+
Mimo że nie zmniejszysz w ten sposób sumarycznej ilości kodu, unikniesz ładowania
73+
funkcjonalności zbędnych dla użytkownika w danym momencie, co przełoży się na mniejszą ilość kodu do pobrania na starcie aplikacji.
7474

7575
## `import()` {#import}
7676

77-
Najlepszym sposobem na wprowadzenie podziału kodu do twojej aplikacji jest dynamiczna składnia
77+
Najlepszym sposobem na wprowadzenie podziału kodu do twojej aplikacji jest użycie dynamicznego wariantu funkcji
7878
`import()`.
7979

8080
**Przed:**
@@ -93,34 +93,34 @@ import("./math").then(math => {
9393
});
9494
```
9595

96-
> Notatka:
96+
> Uwaga:
9797
>
98-
> Dynamiczna składnia `import()` to [propozycja](https://github.com/tc39/proposal-dynamic-import)
99-
> ECMAScript (JavaScript), która aktualnie nie jest częścią standardu językowego. Oczekuje się natomiast,
100-
> że wkrótce zostanie zaakceptowana jako powszechny standard.
98+
> Dynamiczny `import()` to [propozycja](https://github.com/tc39/proposal-dynamic-import)
99+
> dla ECMAScript (JavaScript), która aktualnie nie jest częścią standardu językowego. Oczekuje się jednak,
100+
> że wkrótce zostanie zaakceptowana.
101101
102-
Gdy Webpack natknie się na taką składnie, automatycznie zacznie dzielić kod w twojej aplikacji.
102+
Gdy Webpack natknie się na taką składnię, automatycznie zacznie dzielić kod w twojej aplikacji.
103103
Jeśli używasz Create React App, posiadasz już gotową konfigurację i możesz natychmiast
104-
[zacząć z niego korzystać](https://facebook.github.io/create-react-app/docs/code-splitting).
105-
Również gotowo obsługuje to [Next.js](https://github.com/zeit/next.js/#dynamic-import).
104+
[zacząć z niej korzystać](https://facebook.github.io/create-react-app/docs/code-splitting).
105+
Jest ona również obsługiwana domyślnie przez [Next.js](https://github.com/zeit/next.js/#dynamic-import).
106106

107-
Jeśli konfigurujesz Webpacka samodzielnie, prawdopodobnie chcesz przeczytać
108-
[przewodnik po dzieleniu kodu Webpack](https://webpack.js.org/guides/code-splitting/).
109-
Twoja konfiguracja Webpacka powinna wyglądać podobnie [do tego](https://gist.github.com/gaearon/ca6e803f5c604d37468b0091d9959269).
107+
Jeśli konfigurujesz Webpacka samodzielnie, zalecamy przeczytać
108+
[przewodnik po dzieleniu kodu](https://webpack.js.org/guides/code-splitting/).
109+
Twoja konfiguracja Webpacka powinna wyglądać podobnie [do tej](https://gist.github.com/gaearon/ca6e803f5c604d37468b0091d9959269).
110110

111-
Kiedy używasz [Babel](https://babeljs.io/), musisz się upewnić, że Babel może analizować dynamiczną
112-
składnie importu, ale jej nie przekształca. Do tego będziesz potrzebować [babel-plugin-syntax-dynamic-import](https://yarnpkg.com/en/package/babel-plugin-syntax-dynamic-import).
111+
Kiedy używasz [Babela](https://babeljs.io/), musisz się upewnić, że jest on w stanie sparsować
112+
składnię dynamicznego importu, ale jej nie przekształca w żaden sposób. W tym celu skorzystaj z pluginu [babel-plugin-syntax-dynamic-import](https://yarnpkg.com/en/package/babel-plugin-syntax-dynamic-import).
113113

114114
## `React.lazy` {#reactlazy}
115115

116-
> Notatka:
116+
> Uwaga:
117117
>
118-
> `React.lazy` i Suspense nie jest jeszcze dostępne dla renderowania po stronie serwera
119-
> Jeśli chcesz dzielić kod dla aplikacji renderowanej na serwerze zalecamy [Komponenty Ładowalne
120-
> (Loadable Components)](https://github.com/smooth-code/loadable-components).
121-
> Mają przyjemny [przewodnik do dzielenia pakietów przy renderowaniu po stronie serwera](https://github.com/smooth-code/loadable-components/blob/master/packages/server/README.md).
118+
> `React.lazy` i Suspense jest jeszcze dostępne dla renderowania po stronie serwera.
119+
> Jeśli chcesz dzielić kod dla aplikacji renderowanej na serwerze, sugerujemy skorzystać
120+
> z pakietu [Loadable Components](https://github.com/smooth-code/loadable-components).
121+
> Ma on przystępną [instrukcję dzielenia pakietów przy renderowaniu po stronie serwera](https://github.com/smooth-code/loadable-components/blob/master/packages/server/README.md).
122122
123-
Funkcja `React.lazy` pozwala ci dynamicznie renderować importy jako regularne komponenty.
123+
Funkcja `React.lazy` pozwala renderować dynamicznie importowane komponenty jak zwykłe komponenty.
124124

125125
**Przed:**
126126

@@ -150,11 +150,11 @@ function MyComponent() {
150150
}
151151
```
152152

153-
To automatycznie załaduje paczke zawierającą `OtherComponent` kiedy komponent będzie renderowany.
153+
Powyższy kod automatycznie załaduje paczkę zawierającą `OtherComponent` podczas renderowania komponentu.
154154

155-
`React.lazy` przyjmuje funkcję, która dynamicznie woła `import()`.
156-
Musi zwrócić obietnicę (`Promise`) który rozstrzyga moduł z domyślnym (`default`) eksportem zawierający
157-
komponent Reactowy.
155+
`React.lazy` jako argument przyjmuje funkcję, która wywołuje dynamiczny `import()`.
156+
Musi ona zwrócić obiekt (`Promise`) (pol. *obietnicę*), która rozwiązuje się do modułu z eksportem domyślnym (`default`) zawierającym
157+
komponent reactowy.
158158

159159
### Zawieszenie {#suspense}
160160

@@ -176,7 +176,7 @@ function MyComponent() {
176176
}
177177
```
178178

179-
Props `fallback` akceptuje wszystkie elementy Reactowe, które chcesz wyświetlić
179+
Props `fallback` akceptuje wszystkie elementy reactowe, które chcesz wyświetlić
180180
w trakcie oczekiwania na załadowanie komponentu. Możesz umieścić komponent `Suspense`
181181
w dowolnym miejscu nad "leniwym" komponentem. Możesz nawet zawijać wiele "leniwych komponentów"
182182
za pomocą jednego komponentu `Suspense`.

0 commit comments

Comments
 (0)