New features, bug fixes, performances and security improvements.
2.26.1
Hey UX'ers!
Just a small release to fix a Live Component composer conflict.
Full Changelog: v2.26.0 -> v2.26.1
2.26.0
Hey UX'ers!
This release deprecates 3 packages: symfony/ux-typed, symfony/ux-lazy-image
and symfony/ux-swup. These will be removed in 3.0. Their respective README files
have migration guides to help you move to alternatives.
Also included are many bug fixes and improvements, including multipolygon support
in symfony/ux-map!
DefaultActionTrait in a LiveComponent code example by @welcoMattic in #2758
LiveProp: Pass the property name as second parameter of the modifier callback by @jannes-io in #2744
PropertyTypeExtractorInterface::getTypes() deprecation, use TypeInfo ^7.2 Type by @mtarld in #2607
__toString() by @dannyvw in #2772
spatie/phpunit-snapshot-assertions to require-dev by @dannyvw in #2773
ux:icons:lock by @ameotoko in #2723
symfony/ux-twig-component by @ThomasLandauer in #2789
.ts controller if .js version is available by @phasdev in #2702
chart examples by hello to avoid confusion with the ChartJS component by @welcoMattic in #2707
FileType by @Kocal in #2800
FileType references by @Kocal in #2802
Kit::$uxIcon, make icons internal to the website by @Kocal in #2807
tests-php job matrix, better covers different PHP/SF versions, test all components in a single job by @Kocal in #2734
symfony/symfony, and run it by @Kocal in #2768
ramsey/composer-install by composer install in app-tests workflow by @Kocal in #2780
Full Changelog: v2.25.2 -> v2.26.0
2.25.2
Hey UX'ers!
Just a small bug fix release to fix using StimulusAttributes with Twig Components.
ComponentAttributes rendering when using StimulusAttributes as default attributes by @Kocal in #2757
Full Changelog: v2.25.1 -> v2.25.2
2.25.1
Hey UX'ers!
[!IMPORTANT]
This release addresses CVE-2025-47946. See the blog post for more details.
Full Changelog: v2.25.0 -> v2.25.1
2.25.0
Hey UX'ers!
This release fixes Twig deprecations, improves the DX of Icons, adds UID support and fixes hydration issues in Live Components. This also includes an initial preview of the new UX Toolkit. This package isn't yet installable via Composer as it's still in heavy development, but you can check it out in the src/Toolkit.
querySelector dynamic selector with CSS.escape() by @Bartheyrman22 in #2663
LiveComponentHydrator::hydrateValue() cannot hydrate null values by @nikophil in #2730
turbo_stream_listen topics to mercure if not defined by @Fan2Shrek in #2694
.editorconfig, enforce LF line-ending style by @Kocal in #2691
v2.*.* for NPM auto-releases by @Kocal in #2685
package.json synchronization while upgrading PHP package by @Kocal in #2698
workspace:* dependencies before publishing on npm by @Kocal in #2739
Full Changelog: v2.24.0 -> v2.25.0
2.24.0
Hey UX'ers!
UX packages that require JS have their JS published on NPM. This installation method is reserved for advanced users who want to decouple their JavaScript dependencies from their PHP dependencies. Symfony Flex is still the method recommended for most users.
BadRequestHttpException in case of malformed extra_options by @norkunas in #2600
EnumType precision by @Huluti in #2640
README/LICENSE files for Map Bridges JS packages by @Kocal in #2616
OptionResolver namespace in doc example by @ThibaultPelloquin in #2634
symfony/property-info to the require section by @mtarld in #2608
<twig:Turbo:Stream:*> by @seb-jean in #2481
index.rst by @DennisdeBest in #2603
meta tags by @seb-jean in #2618
turbo_stream_listen by @Fan2Shrek in #2447
symfony/stimulus-bridge 4 by @bobvandevijver in #2609
}, reformat so it's visible by @tacman in #2599
options to Notification by @ernie76 in #1853
package.json files, to prepare publication on NPM by @Kocal in #2595
src/**/assets/README.md files about direct installation and recommended alternatives. by @Kocal in #2612
vendor/ or npm versions) can be installed/used inside an Encore App by @Kocal in #2613
Full Changelog: v2.23.0 -> v2.24.0
2.23.0
Hey UXer's!
Not a ground-breaking release, but some nice minor improvements and fixes.
ExtraLazyChoiceLoader in favor of LazyChoiceLoader by @norkunas in #2458
ExposeInTemplate and computed methods by @Kocal in #2456
TemplateNameParser by @sneakyvv in #2506
[SensitiveParameter] by @smnandre in #2461
container.build_hash instead of kernel.secret in CacheWarmer by @dkarlovi in #2451
make:twig-component by @seb-jean in #2480
submitForm() by @yalit in #2510
ComponentWithFormTrait::extractFormValues() with edge cases by @smnandre in #2491
__component property to be serialized when called JSON.stringify() by @Kocal in #2537
LiveCollectionType by @yalit in #2517
RedirectResponse by @zefyx in #2530
ComponentWithFormTrait not working in batch actions by @smnandre in #2553
disconnect event to destroy the chart by @Shadow-Devil in #1944
lazy:loading and lazy:loaded by @smnandre in #2463
CONTRIBUTING.md by @smnandre in #2472
Full Changelog: v2.22.1 -> v2.23.0
2.22.1
Hey UX'ers!
Just a small, but important bug fix release.
LockIconsCommand definition when Iconify is disabled by @smnandre in #2416
PostHydrate, PreDehydrate & PreReRender by @nehalgajjar in #2431
make:twig-component command by @DennisdeBest in #2384
Full Changelog: v2.22.0 -> v2.22.1
2.22.0
Hey UX'ers!
Here's a shiny new release for you! 🎉
Live components now rely on same-origin/CORS instead of CSRF tokens for protection. They're now stateless and the session is no longer required! In Turbo, <Turbo:Stream> and <Turbo:Frame> Twig components were added plus support for multiple Mercure topics in turbo_stream_listen. The Map component now supports polylines and have come alive with Live Components. Across the board, we've improved performance, fixed bugs, and updated documentation.
labelField by @MatTheCat in #2382
AutocompleteBundle.tr.php by @xDeSwa in #2294
index.rst format by @smnandre in #2297
preload can be set to false by @MatTheCat in #2348
elementBelongsToThisComponent by @smnandre in #2399
BlockStack performance by @smnandre in #2343
ComponentFactory performance by @smnandre in #2344
removeComments will no longer be necessary by @MatTheCat in #2347
<Turbo:Stream> component by @seb-jean in #2302
<Turbo:Frame> component by @seb-jean in #2303
TurboStreamResponse actions by @DRaichev in #2298
turbo_stream_listen by @norkunas in #2407
<twig:Turbo:Stream:*> components by @seb-jean in #2300
index.rst by @LesRouxDominerontLeMonde in #2339
ux_map.google_maps.default_map_id configuration by @Kocal in #2350
ux_map.google_maps.default_map_id by @Kocal in #2358
bin/link-locally by @smnandre in #2310
CONTRIBUTING.md by @Kocal in #2408
Full Changelog: v2.21.0 -> v2.22.0
2.21.0
Hey UX-er's!
In addition to many minor bug fixes and improvements across all packages, this release adds new
<twig:Turbo:Stream:*> Twig components to Turbo. Also in Turbo, a newTurboStreamResponse and
TurboStream helpers we added.
index.rst by @ebedy in #2229
ux:icon & ux:map renders by @smnandre in #2210
ComponentRuntime by @kbond in #2231
permanent option to react_component function by @smnandre in #2283
phpunit.xml.dist by @smnandre in #2286
symfony/string dependency by @smnandre in #2267
symfony/security-csrf dev dependency by @smnandre in #2264
AutocompleteBundle.de.php by @simonsolutions in #2285
icons:lock command verbosity by @smnandre in #2287
Helper/TurboStream::append() et al. methods by @nicolas-grekas in #2196
<twig:Turbo:Stream:*> components by @nicolas-grekas in #2227
UPGRADE.md by @smnandre in #2242
.gitignore/.gitattributes by @smnandre in #2243
Full Changelog: v2.20.0 -> v2.21.0
2.20.0
Hey UX-ers!
This release is packed full of bug fixes and new features. You can now add Polygons in Map and configure icon sets and aliases in Icons. There are also some great performance optimizations, especially in Twig/Live components and StimulusBundle.
render_map Twig function ux_map by @smnandre in #2073
.gitattributes by @smnandre in #2080
leaflet to L in event's payloads by @Kocal in #2113
render_map deprecated version by @Kocal in #2138
ux_map() and <twig:ux:map /> by @smnandre in #2117
Throwable get lost during component render by @cuchac in #2030
$tag parameter from *Node, as it is now deprecated by twig/twig 3.12 by @Kocal in #2114
phpdocumentor/reflection-docblock by @dejagersh in #2102
cva twig function by @Kocal in #2144
index.rst by @LaurentMarquet in #2170
RuntimeExtension by @smnandre in #2168
ComponentLoggerListener by @smnandre in #2167
ComponentFactory by @smnandre in #2201
setRouteLocale in TestLiveComponent by @smnandre in #2124
DeferLiveComponentSubscriber service definition by @smnandre in #2200
ux_icon function by @Kocal in #2149
StimulusAttributes rendering performances by switching to html escaping strategy by @Kocal in #2180
ISSUE_TEMPLATE by @smnandre in #2084
Full Changelog: v2.19.3 -> v2.20.0
2.19.3
Full Changelog: v2.19.2 -> v2.19.3
2.19.2
Another follow up to 2.19.0 that fixes UX Map plus enables a convention for providing anonymous Twig Components in 3rd-party bundles!
package.json resolving by @Kocal in #2052
Full Changelog: v2.19.1 -> v2.19.2
2.19.1
Just a small follow up to 2.19.0 that adds some missing UX Map features!
libraries for Google Bridge, inject provider's SDK (L or google) to dispatched events by @Kocal in #2044
Full Changelog: v2.19.0 -> v2.19.1
2.19.0
Hey UX-ers!
This is a big new release with a lot of bug fixes, quality of live improvements, and a
new UX Map package. A new live_action() Twig function was added to dramatically reduce
the boilerplate for Live Component actions.
@ by @kbond in #1960
loading="lazy" for LiveComponent only by @smnandre in #1976
extra_options in the Ajax-powered autocomplete by @jakubtobiasz in #1702
ignore_not_found config option by @smnandre in #2023
Full Changelog: v2.18.1 -> v2.19.0
2.18.1
👋🏻 This is a small release that fixes some issues we had in 2.18.0.
twig_component.controllers_json by @smnandre in #1908
Full Changelog: v2.18.0 -> v2.18.1
2.18.0
Hey UX'ers!
This is mostly a maintenance release with a lot of small fixes and improvements across all components. The most notable changes are the addition of Slovak translations for the Autocomplete component the abstraction of image content fetching in the Lazy Image component.
twig.runtime by @Kocal in #1771
ExtraLazyChoiceLoader if the parent $loader is null by @vesselind in #1775
TurboExtension for PhpStan by @smnandre in #1854
render:finished event by @smnandre in #1779
--dir option in debug:twig-component command by @javiereguiluz in #1790
EscaperExtension deprecation by @smnandre in #1835
<twig:ux:icon /> in documentation by @smnandre in #1798
EscaperRuntime by @smnandre in #1824
chart.js/auto import with Chart.register calls by @smnandre in #1263
robots.txt & sitemap.xml by @smnandre in #1814
highlight.js to tempest/highlight by @kbond in #1808
Full Changelog: v2.17.0 -> v2.18.0
2.17.0
Hey UX-ers!
This is a big release - lots of new features to Twig/Live Components and the first release of UX Icons! With UX Icons, comes a beautiful icon search on ux.symfony.com!
LiveProp by @squrious in #1507
attributes.has() method by @barbieswimcrew in #1571
aria-* attribute boolean values by @smnandre in #1709
make:autocomplete-field output a doc compliant class by @lucbu in #1699
choice_value in the WrappedEntityTypeAutocompleter in EntityAutocompleteField by @jakubtobiasz in #1723
Full Changelog: v2.16.0 -> v2.17.0
2.16.0
Hi UX'ers!
This release is the first that declares Live Components as stable 🎆! This means that it is now protected by our backwards compatibility promise. However, there are some BC breaks in LiveComponents that will affect most projects. See https://github.com/symfony/ux/blob/2.x/src/LiveComponent/CHANGELOG.md#2160
In addition, this release has a number of fun features & fixes.
LiveComponents is now stable and no longer experimental 🥳
[BC BREAK] The data-action-name attribute behavior was removed in favor of using Stimulus "action parameters" and data-live-action-param. This is a breaking change if you were using the data-action-name attribute directly in your templates. #1418
To upgrade your application, follow these changes:
<button
data-action="live#action"
- data-action-name="debounce(300)|save"
+ data-live-action-param="debounce(300)|save"
>Save</button>
To pass arguments to an action, also use the Stimulus "action parameters" syntax:
<button
data-action="live#action"
- data-action-name="addItem(id={{ item.id }}, itemName=CustomItem)"
+ data-live-action-param="addItem"
+ data-live-id-param="{{ item.id }}"
+ data-live-item-name-param="CustomItem"
>Add Item</button>
Additionally, the prevent modifier (e.g. prevent|save) was removed. Replace this with the standard Stimulus :prevent action option:
<button - data-action="live#action + data-action="live#action:prevent" - data-action-name="prevent|save" + data-live-action-param="save" >Save</button>
[BC BREAK] The data-event attribute was removed in favor of using Stimulus "action parameters": rename data-event to data-live-event-param. Additionally, if you were passing arguments to the event name, use action parameter attributes for those as well - e.g. data-live-foo-param="bar". #1418
Reverted setting ignoreActiveValue: true in Idiomorph #1548
New placeholder macro to generate defer/lazy skeleton #1532
improve TestLiveComponent::actingAs() #1461
Drop Twig 2 support #1436
Add better error message when hydrating dates #1431
Store TemplateMap in build_dir #1525
intl-messageformat to ^10.5.11, in order to see a faster implementation of ICU messages parsing. #1443
Full Changelog: v2.15.0 -> v2.16.0
Have fun!
2.15.0
Hi UX'ers!
This release contains a mixture of new features and important bug fixes, especially LiveComponents & Autocomplete, which were discovered after the morphing library change in 2.14.0.
Add doctrine/orm 3 support #1468
data-live-id attribute was changed to id #1484
attributes variable #1442
Full Changelog: v2.14.2 -> v2.15.0
Have fun!