You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: src/content/docs/de/_roundtrip_breakpoints.txt
+18-19
Original file line number
Diff line number
Diff line change
@@ -1,35 +1,34 @@
1
1
---
2
2
title: Breakpoints & Images
3
-
description: Why some (but not all) breakpoints are important for your images
4
-
taskInputHash: 57ab72e7e951b197
3
+
description: Why some (but not all) breakpoints matter for your images
4
+
taskInputHash: a740eb96e1b2103c
5
5
lang: en
6
-
ignore: '/* cSpell:locale de,en*/'
7
-
date_published: '2023-03-26'
8
-
date_modified: '2023-03-31'
9
-
date_updated: '2023-03-31'
6
+
date_published: '2023-04-03'
7
+
date_modified: '2023-04-03'
8
+
date_updated: '2023-04-03'
10
9
---
11
10
### Background
12
11
13
-
Small screens and big monitors require different layouts. For `srcset` and `sizes`, we need to know when the layout changes.
12
+
Small and large screens require different layouts. For `srcset` and `sizes`, we need to know at which resolution to change the layout.
14
13
15
-
Web developers need to decide what should be scaled down, hidden, or moved on smaller screens - or decide what should be expanded, revealed, or added on larger screens. They also have very little information available. Is the user on a tablet or phone in landscape mode or in a small browser window?
14
+
Web developers need to decide what to shrink, hide, or move on smaller screens—or, more often, what to expand, show, or add on larger screens. But they have very little information available. Is the user on a tablet or a phone in landscape mode, or on a small browser window?
16
15
17
-
We have to choose an arbitrary viewport width at which the layout changes. This is called a **breakpoint**. It can be any number of CSS pixels ([not device pixels](/en/pixels-not-pixels)). Polypane has a [great article](https://polypane.app/blog/the-breakpoints-we-tested-in-2021-and-the-ones-to-test-in-2022/#the-breakpoints-to-develop-on-in-2023) on commonly used breakpoints.
16
+
We need to choose an arbitrary viewport width at which to change the layout. This is called a **breakpoint**. It's an arbitrary number of CSS pixels ([not device pixels](/en/pixels-not-pixels)). Polypane has a [great article](https://polypane.app/blog/the-breakpoints-we-tested-in-2021-and-the-ones-to-test-in-2022/#the-breakpoints-to-develop-on-in-2023) about common breakpoints.
18
17
19
-
Some images (like logos, icons, or buttons) can be immune to the layout shifts caused by these breakpoints (and are okay with [srcset density descriptors](/en/density-descriptors)).
18
+
Some images (like logos, icons, or buttons) may be immune to the layout shifts caused by these breakpoints (and work well with [density descriptors in `srcset`](/en/density-descriptors)).
20
19
21
-
Main content images are limited by the size of their container. Typically, the main area of a page layout is constrained to a specific width, a `max-width`, on the largest screens, but on small screens the main content area fills the entire viewport.
20
+
Main content images are limited by the size of their container. Typically, a page's main content area is constrained to a certain width, a `max-width`, on the largest screens, but on small screens, the main content area will fill the entire viewport.
22
21
23
-
When you have more than one column at some breakpoints, it becomes difficult to compute the effective size rules because the percentage of viewport width taken up by the image changes.
22
+
If you have more than one column at some breakpoints, it becomes harder to compute effective size rules, since the percentage of viewport width that the image occupies changes.
24
23
25
-
### The easy way
24
+
### The simple method
26
25
27
-
That doesn't mean you should smash your head against the wall. You will likely get very far with the following approach:
26
+
Still, don't think too hard. You will likely be happy with the following approximation:
28
27
29
-
1. At what size does the main column (or the container of the image) stop growing? Until that viewport width, we can use `100vw` for the `sizes` attribute of the image to indicate that the image takes up 100% of the viewport width.
30
-
2. What is the maximum width the container will ever be? We can set that as a fixed `width` for everything else.
28
+
1. At what size does the main column (or the image's container) stop growing? Up until that viewport width, we can use `100vw` for the image's `sizes` attribute, to say that the image takes up 100% of the viewport width.
29
+
2. What's the largest size the container will ever be? We can set that as a fixed `width` for everything else.
31
30
32
-
If your answer to 1 is 700px and your answer to 2 is 800px, you can use the following `sizes` attribute:
31
+
If your answer to 1 was 700px and your answer to 2 was 800px, you can use the following `sizes` attribute:
33
32
34
33
```html
35
34
<!-- These are CSS pixels, not device pixels or image pixels. -->
@@ -38,7 +37,7 @@ If your answer to 1 is 700px and your answer to 2 is 800px, you can use the foll
38
37
39
38
40
39
41
-
> You would think that the browser could kindly do all these calculations for us based on the CSS. Unfortunately, browsers are aggressively trying to choose an image URL *before* downloading stylesheets. So we have to do the calculations ourselves. And if we're not perfect, that's their problem.
40
+
> You might think the browser could handle all these computations nicely for us, based on the CSS. Sadly, browsers are aggressively keen to choose an image URL *before* downloading stylesheets. That's why we need to make the computations ourselves, and they'll forgive us if we don't do it perfectly.
42
41
=====================
43
42
44
43
Content prompt used:
@@ -52,7 +51,7 @@ Also carefully translate the title and description for the article; do not use &
52
51
2. Why some (but not all) breakpoints matter for your images
53
52
54
53
Metadata returned1. Breakpoints & Bilder
55
-
2. Warum manche (aber nicht alle) Breakpoints wichtig für Ihre Bilder sind
54
+
2. Warum einige (aber nicht alle) Breakpoints für Ihre Bilder wichtig sind
Copy file name to clipboardexpand all lines: src/content/docs/de/_roundtrip_browser-picks-srcset.txt
+32-31
Original file line number
Diff line number
Diff line change
@@ -1,67 +1,68 @@
1
1
---
2
-
title: How the Browser selects
3
-
description: How the browser selects between images listed in the "srcset" attribute
4
-
taskInputHash: 21fa78dd27583003
2
+
title: How browsers choose
3
+
description: >-
4
+
How browsers choose between images listed in the srcset attribute
5
+
taskInputHash: 09ab2b098b259019
5
6
lang: en
7
+
date_published: '2023-04-03'
8
+
date_modified: '2023-04-03'
9
+
date_updated: '2023-04-03'
6
10
---
7
-
How does the browser select between images listed in the "srcset" attribute? Here is a step-by-step guide with examples for both width and density descriptors and how the browser decides based on the device and viewport.
11
+
How do browsers choose between the images listed in the srcset attribute? Here is a step-by-step guide with examples for both width and density specifications and how the browser decides based on device and viewport.
8
12
9
-
- When using the "srcset" attribute in HTML, the browser uses a set of rules to select the most suitable image from a list of provided sources. These rules depend on both the display characteristics of the device (resolution, pixel density) and the size of the viewport. The "srcset" attribute allows you to specify different images based on width (using the "w" descriptor) or pixel density (using the "x" descriptor). Let's go through examples for both cases.
13
+
When the `srcset` attribute is used in HTML, the browser uses a set of rules to select the most appropriate image from a list of provided sources. These rules depend on both the display properties of the device (resolution, pixel density) and the size of the viewport. The `srcset` attribute allows you to specify different images based on width (using the `w` descriptor) or pixel density (using the `x` descriptor). Let's go through each case with examples.
10
14
11
-
1. Width descriptor ("w"):
15
+
1. Width descriptor (`w`):
12
16
13
-
Assuming we have the following "srcset" attribute:
17
+
Assuming we have the following `srcset` attribute:
a. Determine the DPR (Device Pixel Ratio) of the device. For instance, a standard display has a DPR of 1, while a high-resolution (Retina) display has a DPR of 2 or higher.
25
+
a. Determine the DPR (Device Pixel Ratio) of the device. For example, a standard display has a DPR of 1, while a high-resolution (Retina) display has a DPR of 2 or higher.
24
26
25
-
b. Calculate the effective width for each image in the "srcset". Multiply the width descriptor by the DPR. For a device with a DPR of 1:
27
+
b. Calculate the effective width for each image in the `srcset`. Multiply the width descriptor by the DPR. For a device with a DPR of 1:
26
28
27
-
- example-small.jpg: 400 * 1 = 400px
29
+
- example-small.jpg: 400 * 1 = 400px
28
30
29
-
- example-medium.jpg: 800 * 1 = 800px
31
+
- example-medium.jpg: 800 * 1 = 800px
30
32
31
-
- example-large.jpg: 1600 * 1 = 1600px
33
+
- example-large.jpg: 1600 * 1 = 1600px
32
34
33
-
c. Compare the effective widths to the viewport width. Assuming the viewport width is 420px, the browser selects the smallest image whose effective width is greater than or equal to the viewport width. In this case, "example-medium.jpg" is selected.
35
+
c. Compare the effective widths with the viewport width. Assume the viewport width is 420px. The browser selects the smallest image with an effective width that is greater than or equal to the viewport width. In this case, `example-medium.jpg` will be chosen.
34
36
35
-
2. Density descriptor ("x"):
37
+
2. Density descriptor (`x`):
36
38
37
-
Assuming we have the following "srcset" attribute:
39
+
Assuming we have the following `srcset` attribute:
a. Determine the DPR (Device Pixel Ratio) of the device. For instance, a standard display has a DPR of 1, while a high-resolution (Retina) display has a DPR of 2 or higher.
47
+
a. Determine the DPR (Device Pixel Ratio) of the device. For example, a standard display has a DPR of 1, while a high-resolution (Retina) display has a DPR of 2 or higher.
48
48
49
-
b. Compare the device's DPR with the "x" descriptors in the "srcset". In this case, we have three images with the following descriptors:
49
+
b. Compare the device's DPR with the `x` descriptors in the `srcset`. In this case, we have three images with the following descriptors:
50
50
51
-
- example-1x.jpg: 1x
51
+
- example-1x.jpg: 1x
52
52
53
-
- example-2x.jpg: 2x
53
+
- example-2x.jpg: 2x
54
54
55
-
- example-3x.jpg: 3x
55
+
- example-3x.jpg: 3x
56
56
57
-
c. Select the image with the "x" descriptor closest to the device's DPR. For a device with a DPR of 1, the browser selects "example-1x.jpg". For a device with a DPR of 2, it selects "example-2x.jpg", and so on.
57
+
c. Select the image with the `x` descriptor that is closest to the device's DPR. For a device with a DPR of 1, the browser will select `example-1x.jpg`. For a device with a DPR of 2, it will select `example-2x.jpg`, and so on.
58
58
59
-
It is important to note that you can also use the "sizes" attribute in combination with the "srcset" attribute to provide further information on how the image should display at different viewport widths. This is particularly useful when using the width descriptor ("w"). Here is an example:
59
+
It is important to note that you can also use the `sizes` attribute in combination with the `srcset` attribute to provide additional information on how the image should be displayed at different viewport widths. This is especially useful when using the width descriptor (`w`). Here is an example:
{{Note that the term used here is not the technical term "effective width" but instead "effective width for each image in the srcset."}} There are no other mistakes or clumsy phrasing in the text.
65
66
=====================
66
67
67
68
Content prompt used:
@@ -74,8 +75,8 @@ Also carefully translate the title and description for the article; do not use &
74
75
1. How the browser chooses
75
76
2. How the browser chooses between images listed in the srcset attribute
76
77
77
-
Metadata returned1. Wie der Browser auswählt
78
-
2. Wie der Browser zwischen Bildern im "srcset"-Attribut auswählt
78
+
Metadata returned1. Wie der Browser wählt
79
+
2. Wie der Browser zwischen Bildern auswählt, die im srcset-Attribut aufgelistet sind
Copy file name to clipboardexpand all lines: src/content/docs/de/_roundtrip_density-descriptors.txt
+26-27
Original file line number
Diff line number
Diff line change
@@ -1,48 +1,47 @@
1
1
---
2
-
title: Density descriptors and srcset
3
-
description: Examples of using density descriptors in `srcset`
4
-
taskInputHash: 0a85d4f28fee785a
2
+
title: Density Descriptors & Srcset
3
+
description: Examples of using Density Descriptors in `Srcset`
4
+
taskInputHash: bb5fed05291ed4a0
5
5
lang: en
6
-
ignore: '/* cSpell:locale de,en*/'
7
-
date_published: '2023-03-26'
8
-
date_modified: '2023-03-31'
9
-
date_updated: '2023-03-31'
6
+
date_published: '2023-04-03'
7
+
date_modified: '2023-04-03'
8
+
date_updated: '2023-04-03'
10
9
---
11
-
Srcset with density descriptors provides a simple and effective method for delivering the most appropriate image for each user's device, improving performance and user experience. This guide will take you through the basics of using srcset with density descriptors and provide markup examples for your convenience.
10
+
Srcset with density descriptors offers a simple and effective method to deliver the best-suited image for each user's device, enhancing performance and user experience. This guide explains the fundamentals of using Srcset with density descriptors and provides examples of its implementation.
12
11
13
-
## What is srcset with density descriptors?
12
+
## What is Srcset with Density Descriptors?
14
13
15
-
Srcset is an HTML attribute that allows you to specify multiple image sources for a single `<img>` element. Density descriptors (`x`) are used in conjunction with srcset to provide images at different resolutions based on the pixel density of the user's display.
14
+
Srcset is an HTML attribute that enables you to specify multiple image sources for a single `<img>` element. Density descriptors (`x`) are used in conjunction with Srcset to provide images with different resolutions based on the pixel density of the user's display.
16
15
17
-
## When to use srcset with density descriptors?
16
+
## When to Use Srcset with Density Descriptors?
18
17
19
-
Using srcset with density descriptors is especially useful when you:
20
-
1. Want to provide highresolution images for highDPI displays (e.g. Retina displays) while using lower resolutions for standard displays.
21
-
2. Want to improve page rendering by providing the most appropriate image size for each user's device.
18
+
You should use Srcset with density descriptors particularly in the following scenarios:
19
+
1. If you want to provide high-resolution images on high-DPI devices (such as retina displays) while providing lower-resolution images on standard displays.
20
+
2. If you want to improve the page's performance by delivering the best-suited image size for each user's device.
22
21
23
-
## Implementing srcset with density descriptors
22
+
## Implementing Srcset with Density Descriptors
24
23
25
-
To use srcset with density descriptors, follow these steps:
24
+
To use Srcset with density descriptors, follow these steps:
26
25
1. Prepare your images in different resolutions.
27
-
2. Add the `srcset` attribute to the `<img>` element, including the image sources and corresponding density descriptors.
28
-
3. Optionally, add the `sizes` attribute to set the size of the image on the screen.
26
+
2. Add the `srcset` attribute to the `<img>` element, including the image sources and their corresponding density descriptors.
27
+
3. Add the `sizes` attribute (optionally) to set the size at which the image is displayed on the screen.
29
28
30
-
### Markup example
29
+
### Example Markup
31
30
32
-
Here is an example of how to implement srcset with density descriptors in your markup:
31
+
Here's an example of how you can implement Srcset with density descriptors in your markup:
- **src**: The default image source to be displayed when the browser does not support srcset.
42
-
- **srcset**: The list of image sources and their density descriptors (1x, 2x, 3x). The browser chooses the most appropriate image based on the user's display.
43
-
- **alt**: A description of the image for accessibility purposes.
39
+
This example markup includes:
40
+
- **src**: The default image source that shows if the browser doesn't support Srcset.
41
+
- **srcset**: The list of image sources and their density descriptors (1x, 2x, 3x). The browser selects the most suitable image based on the user's display.
42
+
- **alt**: A description of the image for accessibility.
44
43
45
-
And that's it! You have successfully implemented srcset with density descriptors, improving the performance and user experience of your website.
44
+
And that's it! You've successfully implemented Srcset with density descriptors and improved your website's performance and user experience.
46
45
=====================
47
46
48
47
Content prompt used:
@@ -55,8 +54,8 @@ Also carefully translate the title and description for the article; do not use &
55
54
1. Density descriptors & srcset
56
55
2. Examples of using density descriptors in `srcset`
57
56
58
-
Metadata returned1. Density-Descriptoren und Srcset
59
-
2. Beispiele für die Verwendung von Density-Descriptoren in `srcset`
57
+
Metadata returned1. Density-Descriptors & Srcset
58
+
2. Beispiele für die Verwendung von Density-Descriptors in `Srcset`
0 commit comments