diff --git a/apps/svelte.dev/content/docs/svelte/01-introduction/03-reactivity-fundamentals.md b/apps/svelte.dev/content/docs/svelte/01-introduction/03-reactivity-fundamentals.md index 0f1c8e0799..f5ec471cb5 100644 --- a/apps/svelte.dev/content/docs/svelte/01-introduction/03-reactivity-fundamentals.md +++ b/apps/svelte.dev/content/docs/svelte/01-introduction/03-reactivity-fundamentals.md @@ -40,6 +40,19 @@ class Todo { } ``` +> !LEGACY +> In Svelte 4, state was implicitly reactive if the variable was declared at the top level +> +> ```svelte +> +> +> +> ``` + ## `$derived` Derived state is declared with the `$derived` rune: @@ -61,6 +74,24 @@ The expression inside `$derived(...)` should be free of side-effects. Svelte wil As with `$state`, you can mark class fields as `$derived`. +> !LEGACY +> In Svelte 4, you could use reactive statements for this. +> +> ```svelte +> +> +> +> +>
{count} doubled is {doubled}
+> ``` +> +> This only worked at the top level of a component. + ## `$effect` To run _side-effects_ when the component is mounted to the DOM, and when values change, we can use the `$effect` rune ([demo](/#H4sIAAAAAAAAE31T24rbMBD9lUG7kAQ2sbdlX7xOYNk_aB_rQhRpbAsU2UiTW0P-vbrYubSlYGzmzMzROTPymdVKo2PFjzMzfIusYB99z14YnfoQuD1qQh-7bmdFQEonrOppVZmKNBI49QthCc-OOOH0LZ-9jxnR6c7eUpOnuv6KeT5JFdcqbvbcBcgDz1jXKGg6ncFyBedYR6IzLrAZwiN5vtSxaJA-EzadfJEjKw11C6GR22-BLH8B_wxdByWpvUYtqqal2XB6RVkG1CoHB6U1WJzbnYFDiwb3aGEdDa3Bm1oH12sQLTcNPp7r56m_00mHocSG97_zd7ICUXonA5fwKbPbkE2ZtMJGGVkEdctzQi4QzSwr9prnFYNk5hpmqVuqPQjNnfOJoMF22lUsrq_UfIN6lfSVyvQ7grB3X2mjMZYO3XO9w-U5iLx42qg29md3BP_ni5P4gy9ikTBlHxjLzAtPDlyYZmRdjAbGq7HprEQ7p64v4LU_guu0kvAkhBim3nMplWl8FreQD-CW20aZR0wq12t-KqDWeBywhvexKC3memmDwlHAv9q4Vo2ZK8KtK0CgX7u9J8wXbzdKv-nRnfF_2baTqlYoWUF2h5efl9-n0O6koAMAAA==)): @@ -86,3 +117,28 @@ To run _side-effects_ when the component is mounted to the DOM, and when values ``` The function passed to `$effect` will run when the component mounts, and will re-run after any changes to the values it reads that were declared with `$state` or `$derived` (including those passed in with `$props`). Re-runs are batched (i.e. changing `color` and `size` in the same moment won't cause two separate runs), and happen after any DOM updates have been applied. + +> !LEGACY +> In Svelte 4, you could use reactive statements for this. +> +> ```svelte +> +> +> +> ``` +> +> This only worked at the top level of a component. diff --git a/apps/svelte.dev/src/app.html b/apps/svelte.dev/src/app.html index 14594cf757..140f9b79a6 100644 --- a/apps/svelte.dev/src/app.html +++ b/apps/svelte.dev/src/app.html @@ -20,16 +20,16 @@ diff --git a/apps/svelte.dev/src/routes/docs/[...path]/+layout.svelte b/apps/svelte.dev/src/routes/docs/[...path]/+layout.svelte index ea6ef38404..9e71cddc16 100644 --- a/apps/svelte.dev/src/routes/docs/[...path]/+layout.svelte +++ b/apps/svelte.dev/src/routes/docs/[...path]/+layout.svelte @@ -30,7 +30,7 @@ .container { --sidebar-menu-width: 28rem; --sidebar-width: var(--sidebar-menu-width); - --ts-toggle-height: 4.2rem; + --legacy-toggle-height: 4.2rem; display: flex; flex-direction: column; diff --git a/packages/site-kit/src/lib/docs/DocsContents.svelte b/packages/site-kit/src/lib/docs/DocsContents.svelte index c6e789492f..f5b05b622f 100644 --- a/packages/site-kit/src/lib/docs/DocsContents.svelte +++ b/packages/site-kit/src/lib/docs/DocsContents.svelte @@ -1,6 +1,6 @@ -{#if show_ts_toggle} -!LEGACY')) { + quote = quote.replace('
!LEGACY', '
'); + return '
\n' + quote + '\n'; + } + return '
\n' + quote + '\n'; }, diff --git a/packages/site-kit/src/lib/styles/text.css b/packages/site-kit/src/lib/styles/text.css index 8756bd5609..a4d675b30f 100644 --- a/packages/site-kit/src/lib/styles/text.css +++ b/packages/site-kit/src/lib/styles/text.css @@ -324,7 +324,7 @@ margin-bottom: 0; } -.text :where(blockquote.deprecated) { +.text :where(blockquote.deprecated, blockquote.legacy) { --primary-hsl: var(--sk-text-warning-hsl); --color: var(--primary-hsl); } @@ -333,10 +333,15 @@ content: 'Deprecated'; } -.text :where(blockquote.deprecated a) { +.text :where(blockquote.deprecated a), +.text :where(blockquote.legacy a) { --color: var(--primary-hsl); } +.text :where(blockquote.legacy)::before { + content: 'In Svelte 4 / Legacy mode'; +} + .text :where(section a code) { color: inherit; }