diff --git a/content/docs/code-splitting.md b/content/docs/code-splitting.md index 392108a92..b4b48988e 100644 --- a/content/docs/code-splitting.md +++ b/content/docs/code-splitting.md @@ -1,19 +1,15 @@ --- id: code-splitting -title: Code-Splitting +title: Code-Aufteilung permalink: docs/code-splitting.html --- ## Bundling {#bundling} -Most React apps will have their files "bundled" using tools like -[Webpack](https://webpack.js.org/), [Rollup](https://rollupjs.org/) or -[Browserify](http://browserify.org/). -Bundling is the process of following imported files and merging them into a -single file: a "bundle". This bundle can then be included on a webpage to load -an entire app at once. +Die meisten React Anwendungen werden ihre Dateien durch Tools wie [Webpack](https://webpack.js.org/), [Rollup](https://rollupjs.org/) oder [Browserify](http://browserify.org/) zusammengeführt haben. +Bundling nennt sich der Prozess, in dem importierte Dateien zu einer Datei zusammengefügt werden: ein "Bündel (engl. bundle)". Dieses Bundle kann dann in eine Webseite eingebettet werden um eine komplette Anwendung auf einmal zu laden. -#### Example {#example} +#### Beispiel {#example} **App:** @@ -31,7 +27,7 @@ export function add(a, b) { } ``` -**Bundle:** +**Bündel:** ```js function add(a, b) { @@ -41,44 +37,43 @@ function add(a, b) { console.log(add(16, 26)); // 42 ``` -> Note: +> Hinweis: > -> Your bundles will end up looking a lot different than this. +> Deine Bundles werden am Ende ganz anders aussehen als das hier. -If you're using [Create React App](https://github.com/facebookincubator/create-react-app), [Next.js](https://github.com/zeit/next.js/), [Gatsby](https://www.gatsbyjs.org/), or a similar tool, you will have a Webpack setup out of the box to bundle your -app. +Wenn du [Create React App](https://github.com/facebookincubator/create-react-app), [Next.js](https://github.com/zeit/next.js/), [Gatsby](https://www.gatsbyjs.org/), oder ein ähnliches Tool benutzt, wirdt du ein Webpack-Setup haben welches sofort einsatzbereit ist um deine Anwendung zu +bundlen. -If you aren't, you'll need to setup bundling yourself. For example, see the -[Installation](https://webpack.js.org/guides/installation/) and -[Getting Started](https://webpack.js.org/guides/getting-started/) guides on the -Webpack docs. +Wenn nicht, musst du das Bundling selbst einrichten. Siehe z. B. die Abschnitte +[Installation](https://webpack.js.org/guides/installation/) und +[Erste Schritte](https://webpack.js.org/guides/getting-started/) in der +Webpack-Dokumentation. -## Code Splitting {#code-splitting} +## Code-Splitting {#code-splitting} -Bundling is great, but as your app grows, your bundle will grow too. Especially -if you are including large third-party libraries. You need to keep an eye on -the code you are including in your bundle so that you don't accidentally make -it so large that your app takes a long time to load. +Bundling ist großartig, aber sobald deine Anwendung wächst, wird dein Bundle es auch. +Insbesondere wenn du größere Bibliotheken von Drittanbietern einbeziehst. Du musst +ein Auge auf den Code haben, den du im Bundle hast, damit du ihn nicht versehentlich +so groß machst und deine Anwendung zu lange zum Laden benötigt. -To avoid winding up with a large bundle, it's good to get ahead of the problem -and start "splitting" your bundle. -Code-Splitting is a feature -supported by bundlers like [Webpack](https://webpack.js.org/guides/code-splitting/), [Rollup](https://rollupjs.org/guide/en/#code-splitting) and Browserify (via -[factor-bundle](https://github.com/browserify/factor-bundle)) which can create -multiple bundles that can be dynamically loaded at runtime. +Um zu vermeiden, dass du mit einem großen Bundle endest, ist es gut, dem Problem +voraus zu sein und mit dem "Splitten" (dt. aufteilen) deines Bundles zu beginnen. +Code-Splitting ist eine Funktion, die von Bundlern wie [Webpack](https://webpack.js.org/guides/code-splitting/), [Rollup](https://rollupjs.org/guide/en/#code-splitting) und Browserify unterstützt wird (via +[factor-bundle](https://github.com/browserify/factor-bundle)). Durch sie werden mehrere Bundles erzeugt, +die zur Laufzeit dynamisch geladen werden können. -Code-splitting your app can help you "lazy-load" just the things that are -currently needed by the user, which can dramatically improve the performance of -your app. While you haven't reduced the overall amount of code in your app, -you've avoided loading code that the user may never need, and reduced the amount -of code needed during the initial load. +Code-Splitting deiner Anwendung kann dir helfen genau die Dinge "lazy zu laden", +die der Benutzer gerade benötigt, was die Performance deiner Anwendung drastisch +verbessern kann. Du hast zwar die Gesamtmenge an Code nicht verringert, aber du hast +das Laden von Code vermieden, den der Benutzer möglicherweise nie brauchen wird. Zusätzlich +reduzierst du die Menge an Code beim initialen Laden. ## `import()` {#import} -The best way to introduce code-splitting into your app is through the dynamic -`import()` syntax. +Der beste Weg Code-Splitting in deiner Anwendung einzuführen, ist durch die dynamische +`import()`-Syntax. -**Before:** +**Vorher:** ```js import { add } from './math'; @@ -86,7 +81,7 @@ import { add } from './math'; console.log(add(16, 26)); ``` -**After:** +**Nachher:** ```js import("./math").then(math => { @@ -94,24 +89,24 @@ import("./math").then(math => { }); ``` -When Webpack comes across this syntax, it automatically starts code-splitting -your app. If you're using Create React App, this is already configured for you -and you can [start using it](https://facebook.github.io/create-react-app/docs/code-splitting) immediately. It's also supported -out of the box in [Next.js](https://github.com/zeit/next.js/#dynamic-import). +Wenn Webpack auf diese Syntax stößt, fängt es automatisch mit dem Code-Splitting +deiner Anwendung an. Wenn du Create-React-App verwendest, ist dies alles vorkonfiguriert +und du kannst [direkt loslegen](https://facebook.github.io/create-react-app/docs/code-splitting). +[Next.js](https://github.com/zeit/next.js/#dynamic-import) unterstützt dies auch direkt out of the box. -If you're setting up Webpack yourself, you'll probably want to read Webpack's -[guide on code splitting](https://webpack.js.org/guides/code-splitting/). Your Webpack config should look vaguely [like this](https://gist.github.com/gaearon/ca6e803f5c604d37468b0091d9959269). +Wenn du Webpack selbst einrichtest, wirst du wahrschenlich Webpack's +[Code-Splitting Leitfaden](https://webpack.js.org/guides/code-splitting/) lesen wollen. Deine Webpack-Konfiguration sollte in etwa [so aussehen](https://gist.github.com/gaearon/ca6e803f5c604d37468b0091d9959269). -When using [Babel](https://babeljs.io/), you'll need to make sure that Babel can -parse the dynamic import syntax but is not transforming it. For that you will need [babel-plugin-syntax-dynamic-import](https://yarnpkg.com/en/package/babel-plugin-syntax-dynamic-import). +Wenn du [Babel](https://babeljs.io/) verwendest, müsstest du sicherstellen, dass Babel +die Dynamic-Import-Syntax parsen kann, sie aber nicht transformiert. Für all das benötigst du [babel-plugin-syntax-dynamic-import](https://yarnpkg.com/en/package/babel-plugin-syntax-dynamic-import). ## `React.lazy` {#reactlazy} -> Note: +> Hinweis: > -> `React.lazy` and Suspense are not yet available for server-side rendering. If you want to do code-splitting in a server rendered app, we recommend [Loadable Components](https://github.com/gregberge/loadable-components). It has a nice [guide for bundle splitting with server-side rendering](https://loadable-components.com/docs/server-side-rendering/). +> `React.lazy` und Suspense sind noch nicht für das serverseitige Rendering verfügbar. Wenn du Code-Splitting von deiner serverseitig gerenderten Anwendung durchführen möchtest, empfehlen wir dir [Loadable Components](https://github.com/gregberge/loadable-components). Es gibt einen schönen [Leitfaden für das Bundle-Splitting mit serverseitigem Rendern](https://loadable-components.com/docs/server-side-rendering/). -The `React.lazy` function lets you render a dynamic import as a regular component. +Mit der Funktion `React.lazy` kannst du einen dynamischen Import als reguläre Komponente rendern. **Before:** @@ -125,11 +120,11 @@ import OtherComponent from './OtherComponent'; const OtherComponent = React.lazy(() => import('./OtherComponent')); ``` -This will automatically load the bundle containing the `OtherComponent` when this component is first rendered. +Dadurch wird automatisch das Bundle geladen, dass `OtherComponent` enthält, wenn die Komponente das erste Mal gerendert wird. -`React.lazy` takes a function that must call a dynamic `import()`. This must return a `Promise` which resolves to a module with a `default` export containing a React component. +`React.lazy` nimmt eine Funktion entgegen, die ein dynamisches `import()` aufrufen muss. Dies muss ein `Promise` zurückgeben, welches eine Modul auflöst, dass eine React-Komponenten im `default` Export enthält. -The lazy component should then be rendered inside a `Suspense` component, which allows us to show some fallback content (such as a loading indicator) while we're waiting for the lazy component to load. +Die Lazy-Komponente sollte dann in einer `Suspense`-Komponente gerendert werden, was es uns ermöglicht ein wenig Fallback-Inhalt anzuzeigen (z. B. eine Ladeanzeige), während wir darauf warten, dass die Lazy-Komponente lädt. ```js const OtherComponent = React.lazy(() => import('./OtherComponent')); @@ -145,7 +140,7 @@ function MyComponent() { } ``` -The `fallback` prop accepts any React elements that you want to render while waiting for the component to load. You can place the `Suspense` component anywhere above the lazy component. You can even wrap multiple lazy components with a single `Suspense` component. +Das `fallback`-Prop akzeptiert jedes React-Element, das du rendern möchtest, während du drauf wartest, dass die Komponente geladen wird. Du kannst die `Suspense`-Komponente überall über der Lazy-Komponente platzieren. Du kannst sogar mehrere Lazy-Komponenten mit einer einzigen `Suspense`-Komponente umhüllen. ```js const OtherComponent = React.lazy(() => import('./OtherComponent')); @@ -165,9 +160,9 @@ function MyComponent() { } ``` -### Error boundaries {#error-boundaries} +### Fehlergrenzen {#error-boundaries} -If the other module fails to load (for example, due to network failure), it will trigger an error. You can handle these errors to show a nice user experience and manage recovery with [Error Boundaries](/docs/error-boundaries.html). Once you've created your Error Boundary, you can use it anywhere above your lazy components to display an error state when there's a network error. +Wenn das andere Modul nicht lädt (z. B. aufgrund eines Netzwerkausfalls), löst es einen Fehler aus. Du kannst diese Fehler behandeln, um eine schönere Benutzererfahrung zu bieten und die Wiederherstellung mit [Fehlergrenzen](/docs/error-boundaries.html) zu verwalten. Sobald du deine Fehlergrenze erstellt hast, kannst du sie überall oberhalb deinen Lazy-Komponenten verwenden, um einen Fehlerstatus anzuzeigem, wenn ein Netzwerkfehler vorliegt. ```js import MyErrorBoundary from './MyErrorBoundary'; @@ -188,19 +183,19 @@ const MyComponent = () => ( ); ``` -## Route-based code splitting {#route-based-code-splitting} +## Routen basiertes Code-Splitting {#route-based-code-splitting} -Deciding where in your app to introduce code splitting can be a bit tricky. You -want to make sure you choose places that will split bundles evenly, but won't -disrupt the user experience. +Die Entscheidung wo in deiner Anwendung Code-Splitting einzuführen ist, kann etwas schwierig sein. +Du solltest sicherstellen, dass du Orte wählst, die die Bundles gleichmäßig splitten, aber nicht +die Benutzererfahrung beeinträchtigen. -A good place to start is with routes. Most people on the web are used to -page transitions taking some amount of time to load. You also tend to be -re-rendering the entire page at once so your users are unlikely to be -interacting with other elements on the page at the same time. +Ein guter Ausgangspunkt sind Routen. Die meisten Leute im Web sind es +gewohnt Page-Transitions zu erstellen, die einige Zeit zum Laden benötigen. +Sie neigen auch dazu, die gesamte Seite auf einmal neu zu rendern, so dass die Benutzer +wahrscheinlich nicht gleichzeitig mit anderen Elementen auf der Seite interagieren. -Here's an example of how to setup route-based code splitting into your app using -libraries like [React Router](https://reacttraining.com/react-router/) with `React.lazy`. +Hier ist ein Beispiel wie du ein routenbasiertes Code-Splitting in deiner Anwendung +mit Hilfe von Bibliotheken, wie [React Router](https://reacttraining.com/react-router/) mit `React.lazy` einrichtest. ```js import { BrowserRouter as Router, Route, Switch } from 'react-router-dom'; @@ -211,7 +206,7 @@ const About = lazy(() => import('./routes/About')); const App = () => ( - Loading...}> + Lade...}> @@ -221,9 +216,9 @@ const App = () => ( ); ``` -## Named Exports {#named-exports} +## Benannte Exporte {#named-exports} -`React.lazy` currently only supports default exports. If the module you want to import uses named exports, you can create an intermediate module that reexports it as the default. This ensures that tree shaking keeps working and that you don't pull in unused components. +`React.lazy` unterstützt derzeit nur `default` Exporte. Wenn das Modul, das du importieren möchtest, benannte `exports` enthält, kannst du ein Zwischenmodul erstellen, das es als `default` wieder exportiert. Dies stellt sicher, dass das Tree-Shaking weiter funktioniert und es keine unbenutzten Komponenten mit einbezieht. ```js // ManyComponents.js