Releases: withastro/astro
[email protected]
[email protected]
Patch Changes
-
#13703
659904b
Thanks @ascorbic! - Fixes a bug where empty fallbacks could not be provided when using the experimental fonts API -
#13680
18e1b97
Thanks @florian-lefebvre! - Improves theUnsupportedExternalRedirect
error message to include more details such as the concerned destination -
#13703
659904b
Thanks @ascorbic! - Simplifies styles for experimental responsive images⚠️ BREAKING CHANGE FOR EXPERIMENTAL RESPONSIVE IMAGES ONLY⚠️ The generated styles for image layouts are now simpler and easier to override. Previously the responsive image component used CSS to set the size and aspect ratio of the images, but this is no longer needed. Now the styles just include
object-fit
andobject-position
for all images, and setsmax-width: 100%
for constrained images andwidth: 100%
for full-width images.This is an implementation change only, and most users will see no change. However, it may affect any custom styles you have added to your responsive images. Please check your rendered images to determine whether any change to your CSS is needed.
The styles now use the
:where()
pseudo-class, which has a specificity of 0, meaning that it is easy to override with your own styles. You can now be sure that your own classes will always override the applied styles, as will global styles onimg
.An exception is Tailwind 4, which uses cascade layers, meaning the rules are always lower specificity. Astro supports browsers that do not support cascade layers, so we cannot use this. If you need to override the styles using Tailwind 4, you must use
!important
classes. Do check if this is needed though: there may be a layout that is more appropriate for your use case. -
#13703
659904b
Thanks @ascorbic! - Adds warnings about using local font files in thepublicDir
when the experimental fonts API is enabled. -
#13703
659904b
Thanks @ascorbic! - Renames experimental responsive image layout option from "responsive" to "constrained"⚠️ BREAKING CHANGE FOR EXPERIMENTAL RESPONSIVE IMAGES ONLY⚠️ The layout option called
"responsive"
is renamed to"constrained"
to better reflect its behavior.The previous name was causing confusion, because it is also the name of the feature. The
responsive
layout option is specifically for images that are displayed at the requested size, unless they do not fit the width of their container, at which point they would be scaled down to fit. They do not get scaled beyond the intrinsic size of the source image, or thewidth
prop if provided.It became clear from user feedback that many people (understandably) thought that they needed to set
layout
toresponsive
if they wanted to use responsive images. They then struggled with overriding styles to make the image scale up for full-width hero images, for example, when they should have been usingfull-width
layout. Renaming the layout toconstrained
should make it clearer that this layout is for when you want to constrain the maximum size of the image, but allow it to scale-down.Upgrading
If you set a default
image.experimentalLayout
in yourastro.config.mjs
, or set it on a per-image basis using thelayout
prop, you will need to change all occurences toconstrained
:// astro.config.mjs export default { image: { - experimentalLayout: 'responsive', + experimentalLayout: 'constrained', }, }
// src/pages/index.astro --- import { Image } from 'astro:assets'; --- - <Image src="/image.jpg" layout="responsive" /> + <Image src="/image.jpg" layout="constrained" />
Please give feedback on the RFC if you have any questions or comments about the responsive images API.
[email protected]
Patch Changes
- #13591
5dd2d3f
Thanks @florian-lefebvre! - Removes unused code
[email protected]
Patch Changes
-
#13660
620d15d
Thanks @mingjunlu! - Addsserver.allowedHosts
docs comment toAstroUserConfig
-
#13591
5dd2d3f
Thanks @florian-lefebvre! - Removes unused code -
#13669
73f24d4
Thanks @ematipico! - Fixes an issue whereAstro.originPathname
wasn't returning the correct value when using rewrites. -
#13674
42388b2
Thanks @florian-lefebvre! - Fixes a case where an experimental fonts API error would be thrown when using anotherastro:assets
API -
#13654
4931457
Thanks @florian-lefebvre! - FixesfontProviders.google()
so it can forward options to the unifont provider, when using the experimental fonts API -
Updated dependencies [
5dd2d3f
]:- @astrojs/[email protected]
@astrojs/[email protected]
Patch Changes
- #13591
5dd2d3f
Thanks @florian-lefebvre! - Removes unused code
@astrojs/[email protected]
Patch Changes
- #13663
a19a185
Thanks @florian-lefebvre! - Improves type-safety of renderers
@astrojs/[email protected]
Patch Changes
- #13591
5dd2d3f
Thanks @florian-lefebvre! - Removes unused code
@astrojs/[email protected]
Patch Changes
- #13591
5dd2d3f
Thanks @florian-lefebvre! - Removes unused code
@astrojs/[email protected]
Patch Changes
- #13591
5dd2d3f
Thanks @florian-lefebvre! - Removes unused code
@astrojs/[email protected]
Patch Changes
- #13591
5dd2d3f
Thanks @florian-lefebvre! - Removes unused code