svelte
import {
class SvelteComponent<Props extends Record<string, any> = Record<string, any>, Events extends Record<string, any> = any, Slots extends Record<string, any> = any>
This was the base class for Svelte components in Svelte 4. Svelte 5+ components
are completely different under the hood. For typing, use Component
instead.
To instantiate components, use mount
instead`.
See migration guide for more info.
SvelteComponent,
class SvelteComponentTyped<Props extends Record<string, any> = Record<string, any>, Events extends Record<string, any> = any, Slots extends Record<string, any> = any>
SvelteComponentTyped,
function afterUpdate(fn: () => void): void
Schedules a callback to run immediately after the component has been updated.
The first time the callback runs will be after the initial onMount
.
In runes mode use $effect
instead.
afterUpdate,
function beforeUpdate(fn: () => void): void
Schedules a callback to run immediately before the component is updated after any state change.
The first time the callback runs will be before the initial onMount
.
In runes mode use $effect.pre
instead.
beforeUpdate,
function createEventDispatcher<EventMap extends Record<string, any> = any>(): EventDispatcher<EventMap>
Creates an event dispatcher that can be used to dispatch component events.
Event dispatchers are functions that can take two arguments: name
and detail
.
Component events created with createEventDispatcher
create a
CustomEvent.
These events do not bubble.
The detail
argument corresponds to the CustomEvent.detail
property and can contain any type of data.
The event dispatcher can be typed to narrow the allowed event names and the type of the detail
argument:
const dispatch = createEventDispatcher<{
loaded: never; // does not take a detail argument
change: string; // takes a detail argument of type string, which is required
optional: number | null; // takes an optional detail argument of type number
}>();
createEventDispatcher,
function createRawSnippet<Params extends unknown[]>(fn: (...params: Getters<Params>) => {
render: () => string;
setup?: (element: Element) => void | (() => void);
}): Snippet<Params>
Create a snippet programmatically
createRawSnippet,
function flushSync(fn?: (() => void) | undefined): void
Synchronously flushes any pending state changes and those that result from it.
flushSync,
function getAllContexts<T extends Map<any, any> = Map<any, any>>(): T
Retrieves the whole context map that belongs to the closest parent component.
Must be called during component initialisation. Useful, for example, if you
programmatically create a component and want to pass the existing context to it.
getAllContexts,
function getContext<T>(key: any): T
Retrieves the context that belongs to the closest parent component with the specified key
.
Must be called during component initialisation.
getContext,
function hasContext(key: any): boolean
Checks whether a given key
has been set in the context of a parent component.
Must be called during component initialisation.
hasContext,
function hydrate<Props extends Record<string, any>, Exports extends Record<string, any>>(component: ComponentType<SvelteComponent<Props>> | Component<Props, Exports, any>, options: {} extends Props ? {
target: Document | Element | ShadowRoot;
props?: Props;
events?: Record<string, (e: any) => any>;
context?: Map<any, any>;
intro?: boolean;
recover?: boolean;
} : {
target: Document | Element | ShadowRoot;
props: Props;
events?: Record<string, (e: any) => any>;
context?: Map<any, any>;
intro?: boolean;
recover?: boolean;
}): Exports
Hydrates a component on the given target and returns the exports and potentially the props (if compiled with accessors: true
) of the component
hydrate,
function mount<Props extends Record<string, any>, Exports extends Record<string, any>>(component: ComponentType<SvelteComponent<Props>> | Component<Props, Exports, any>, options: MountOptions<Props>): Exports
Mounts a component to the given target and returns the exports and potentially the props (if compiled with accessors: true
) of the component.
Transitions will play during the initial render unless the intro
option is set to false
.
mount,
function onDestroy(fn: () => any): void
Schedules a callback to run immediately before the component is unmounted.
Out of onMount
, beforeUpdate
, afterUpdate
and onDestroy
, this is the
only one that runs inside a server-side component.
onDestroy,
function onMount<T>(fn: () => NotFunction<T> | Promise<NotFunction<T>> | (() => any)): void
The onMount
function schedules a callback to run as soon as the component has been mounted to the DOM.
It must be called during the component’s initialisation (but doesn’t need to live inside the component;
it can be called from an external module).
If a function is returned synchronously from onMount
, it will be called when the component is unmounted.
onMount
does not run inside server-side components.
onMount,
function setContext<T>(key: any, context: T): T
Associates an arbitrary context
object with the current component and the specified key
and returns that object. The context is then available to children of the component
(including slotted content) with getContext
.
Like lifecycle functions, this must be called during component initialisation.
setContext,
function tick(): Promise<void>
Returns a promise that resolves once any pending state changes have been applied.
tick,
function unmount(component: Record<string, any>): void
Unmounts a component that was previously mounted using mount
or hydrate
.
unmount,
function untrack<T>(fn: () => T): T
untrack
} from 'svelte';
SvelteComponent
这是 Svelte 4 中 Svelte 组件的基础类。Svelte 5 及更高版本的组件在底层完全不同。对于类型化,请改用 Component
。要实例化组件,请改用 mount
。有关更多信息,请参阅 迁移指南。
class SvelteComponent<
Props extends Record<string, any> = Record<string, any>,
Events extends Record<string, any> = any,
Slots extends Record<string, any> = any
> {…}
static element?: typeof HTMLElement;
组件的自定义元素版本。仅在使用 customElement
编译器选项编译时存在
[prop: string]: any;
constructor(options: ComponentConstructorOptions<Properties<Props, Slots>>);
- 已弃用 此构造函数仅在使用
asClassComponent
兼容性帮助程序时存在,这是一种权宜之计。请改用mount
进行迁移。有关更多信息,请参阅 https://svelte.js.cn/docs/svelte/v5-migration-guide#Components-are-no-longer-classes。
$destroy(): void;
- 已弃用 此方法仅在使用其中一个旧版兼容性帮助程序时存在,这是一种权宜之计。有关更多信息,请参阅 https://svelte.js.cn/docs/svelte/v5-migration-guide#Components-are-no-longer-classes。
$on<K extends Extract<keyof Events, string>>(
type: K,
callback: (e: Events[K]) => void
): () => void;
- 已弃用 此方法仅在使用其中一个旧版兼容性帮助程序时存在,这是一种权宜之计。有关更多信息,请参阅 https://svelte.js.cn/docs/svelte/v5-migration-guide#Components-are-no-longer-classes。
$set(props: Partial<Props>): void;
- 已弃用 此方法仅在使用其中一个旧版兼容性帮助程序时存在,这是一种权宜之计。有关更多信息,请参阅 https://svelte.js.cn/docs/svelte/v5-migration-guide#Components-are-no-longer-classes。
SvelteComponentTyped
请改用
Component
。有关更多信息,请参阅 迁移指南。
class SvelteComponentTyped<
Props extends Record<string, any> = Record<string, any>,
Events extends Record<string, any> = any,
Slots extends Record<string, any> = any
> extends SvelteComponent<Props, Events, Slots> {}
afterUpdate
请改用
$effect
— 请参阅 https://svelte.js.cn/docs/svelte/$effect
安排一个回调,在组件更新后立即运行。
回调第一次运行将在初始 onMount
之后。
在符文模式下,请改用 $effect
。
function afterUpdate(fn: () => void): void;
beforeUpdate
请改用
$effect.pre
— 请参阅 https://svelte.js.cn/docs/svelte/$effect#$effect.pre
安排一个回调,在任何状态更改后更新组件之前立即运行。
回调第一次运行将在初始 onMount
之前。
在符文模式下,请改用 $effect.pre
。
function beforeUpdate(fn: () => void): void;
createEventDispatcher
请改用回调 props 和/或
$host()
符文 — 请参阅 https://svelte.js.cn/docs/svelte/v5-migration-guide#Event-changes-Component-events
创建一个事件分派器,可用于分派 组件事件。事件分派器是可接受两个参数的函数:name
和 detail
。
使用 createEventDispatcher
创建的组件事件会创建一个 CustomEvent。这些事件不会 冒泡。detail
参数对应于 CustomEvent.detail 属性,并且可以包含任何类型的数据。
事件分派器可以进行类型化以缩小允许的事件名称和 detail
参数的类型
const const dispatch: any
dispatch = createEventDispatcher<{
loaded: never
loaded: never; // does not take a detail argument
change: string
change: string; // takes a detail argument of type string, which is required
optional: number | null
optional: number | null; // takes an optional detail argument of type number
}>();
function createEventDispatcher<
EventMap extends Record<string, any> = any
>(): EventDispatcher<EventMap>;
createRawSnippet
以编程方式创建代码片段
function createRawSnippet<Params extends unknown[]>(
fn: (...params: Getters<Params>) => {
render: () => string;
setup?: (element: Element) => void | (() => void);
}
): Snippet<Params>;
flushSync
同步刷新任何挂起的状态更改以及由此产生的状态更改。
function flushSync(fn?: (() => void) | undefined): void;
getAllContexts
检索属于最近父组件的整个上下文映射。必须在组件初始化期间调用。例如,如果您以编程方式创建组件并希望将其传递给现有上下文,则此方法很有用。
function getAllContexts<
T extends Map<any, any> = Map<any, any>
>(): T;
getContext
检索属于具有指定 key
的最近父组件的上下文。必须在组件初始化期间调用。
function getContext<T>(key: any): T;
hasContext
检查父组件的上下文中是否已设置给定的 key
。必须在组件初始化期间调用。
function hasContext(key: any): boolean;
hydrate
在给定目标上水化组件并返回组件的导出以及可能存在的 props(如果使用 accessors: true
编译)
function hydrate<
Props extends Record<string, any>,
Exports extends Record<string, any>
>(
component:
| ComponentType<SvelteComponent<Props>>
| Component<Props, Exports, any>,
options: {} extends Props
? {
target: Document | Element | ShadowRoot;
props?: Props;
events?: Record<string, (e: any) => any>;
context?: Map<any, any>;
intro?: boolean;
recover?: boolean;
}
: {
target: Document | Element | ShadowRoot;
props: Props;
events?: Record<string, (e: any) => any>;
context?: Map<any, any>;
intro?: boolean;
recover?: boolean;
}
): Exports;
mount
将组件安装到给定目标并返回组件的导出以及可能存在的 props(如果使用 accessors: true
编译)。除非将 intro
选项设置为 false
,否则转换将在初始渲染期间播放。
function mount<
Props extends Record<string, any>,
Exports extends Record<string, any>
>(
component:
| ComponentType<SvelteComponent<Props>>
| Component<Props, Exports, any>,
options: MountOptions<Props>
): Exports;
onDestroy
安排一个回调,在组件卸载之前立即运行。
在 onMount
、beforeUpdate
、afterUpdate
和 onDestroy
中,这是唯一一个在服务器端组件内部运行的回调。
function onDestroy(fn: () => any): void;
onMount
onMount
函数安排一个回调,只要组件已安装到 DOM 中就立即运行。它必须在组件的初始化期间调用(但不需要位于组件内部;它可以从外部模块调用)。
如果从 onMount
以同步方式返回一个函数,则将在组件卸载时调用该函数。
onMount
不会在 服务器端组件 内部运行。
function onMount<T>(
fn: () =>
| NotFunction<T>
| Promise<NotFunction<T>>
| (() => any)
): void;
setContext
将任意 context
对象与当前组件和指定的 key
关联并返回该对象。然后,子组件(包括插槽内容)可以使用 getContext
获取该上下文。
与生命周期函数一样,此函数必须在组件初始化期间调用。
function setContext<T>(key: any, context: T): T;
tick
返回一个 promise,该 promise 在应用任何挂起的状态更改后解析。
function tick(): Promise<void>;
unmount
卸载之前使用 mount
或 hydrate
安装的组件。
function unmount(component: Record<string, any>): void;
untrack
在 $derived
或 $effect
内部使用时,fn
内部读取的任何状态都不会被视为依赖项。
function $effect(fn: () => void | (() => void)): void
namespace $effect
Runs code when a component is mounted to the DOM, and then whenever its dependencies change, i.e. $state
or $derived
values.
The timing of the execution is after the DOM has been updated.
Example:
$effect(() => console.log('The count is now ' + count));
If you return a function from the effect, it will be called right before the effect is run again, or when the component is unmounted.
Does not run during server side rendering.
$effect(() => {
// this will run when `data` changes, but not when `time` changes
save(data, {
timestamp: any
timestamp: untrack(() => time)
});
});
function untrack<T>(fn: () => T): T;
Component
可用于创建强类型化的 Svelte 组件。
示例:
您在 npm 上有一个名为 component-library
的组件库,从中导出一个名为 MyComponent
的组件。对于 Svelte+TypeScript 用户,您希望提供类型。因此,您创建了一个 index.d.ts
import type { interface Component<Props extends Record<string, any> = {}, Exports extends Record<string, any> = {}, Bindings extends keyof Props | "" = string>
Can be used to create strongly typed Svelte components.
Example:
You have component library on npm called component-library
, from which
you export a component called MyComponent
. For Svelte+TypeScript users,
you want to provide typings. Therefore you create a index.d.ts
:
import type { Component } from 'svelte';
export declare const MyComponent: Component<{ foo: string }> {}
Typing this makes it possible for IDEs like VS Code with the Svelte extension
to provide intellisense and to use the component like this in a Svelte file
with TypeScript:
<script lang="ts">
import { MyComponent } from "component-library";
</script>
<MyComponent foo={'bar'} />
Component } from 'svelte';
export declare const const MyComponent: Component<{
foo: string;
}, {}, string>
MyComponent: interface Component<Props extends Record<string, any> = {}, Exports extends Record<string, any> = {}, Bindings extends keyof Props | "" = string>
Can be used to create strongly typed Svelte components.
Example:
You have component library on npm called component-library
, from which
you export a component called MyComponent
. For Svelte+TypeScript users,
you want to provide typings. Therefore you create a index.d.ts
:
import type { Component } from 'svelte';
export declare const MyComponent: Component<{ foo: string }> {}
Typing this makes it possible for IDEs like VS Code with the Svelte extension
to provide intellisense and to use the component like this in a Svelte file
with TypeScript:
<script lang="ts">
import { MyComponent } from "component-library";
</script>
<MyComponent foo={'bar'} />
Component<{ foo: string
foo: string }> {}
通过这种类型化,IDE(如带有 Svelte 扩展的 VS Code)可以提供智能感知,并在带有 TypeScript 的 Svelte 文件中像这样使用该组件
<script lang="ts">
import { MyComponent } from "component-library";
</script>
<MyComponent foo={'bar'} />
interface Component<
Props extends Record<string, any> = {},
Exports extends Record<string, any> = {},
Bindings extends keyof Props | '' = string
> {…}
(
this: void,
internals: ComponentInternals,
props: Props
): {
/**
* @deprecated This method only exists when using one of the legacy compatibility helpers, which
* is a stop-gap solution. See https://svelte.js.cn/docs/svelte/v5-migration-guide#Components-are-no-longer-classes
* for more info.
*/
$on?(type: string, callback: (e: any) => void): () => void;
/**
* @deprecated This method only exists when using one of the legacy compatibility helpers, which
* is a stop-gap solution. See https://svelte.js.cn/docs/svelte/v5-migration-guide#Components-are-no-longer-classes
* for more info.
*/
$set?(props: Partial<Props>): void;
} & Exports;
internal
Svelte 使用的内部对象。请勿使用或修改。props
传递给组件的 props。
element?: typeof HTMLElement;
组件的自定义元素版本。仅在使用 customElement
编译器选项编译时存在
ComponentConstructorOptions
在 Svelte 4 中,组件是类。在 Svelte 5 中,它们是函数。请改用
mount
来实例化组件。有关更多信息,请参阅 迁移指南。
interface ComponentConstructorOptions<
Props extends Record<string, any> = Record<string, any>
> {…}
target: Element | Document | ShadowRoot;
anchor?: Element;
props?: Props;
context?: Map<any, any>;
hydrate?: boolean;
intro?: boolean;
recover?: boolean;
sync?: boolean;
$$inline?: boolean;
ComponentEvents
新的
Component
类型没有专门的 Events 类型。请改用ComponentProps
。
type ComponentEvents<Comp extends SvelteComponent> =
Comp extends SvelteComponent<any, infer Events>
? Events
: never;
ComponentInternals
在不同环境之间变化的内部实现细节
type ComponentInternals = Branded<{}, 'ComponentInternals'>;
ComponentProps
方便获取给定组件期望的 props 的类型。
示例:确保一个变量包含 MyComponent
期望的 props
import type { type ComponentProps<Comp extends SvelteComponent | Component<any, any>> = Comp extends SvelteComponent<infer Props extends Record<string, any>, any, any> ? Props : Comp extends Component<infer Props extends Record<...>, any, string> ? Props : never
Convenience type to get the props the given component expects.
Example: Ensure a variable contains the props expected by MyComponent
:
import type { ComponentProps } from 'svelte';
import MyComponent from './MyComponent.svelte';
// Errors if these aren't the correct props expected by MyComponent.
const props: ComponentProps<typeof MyComponent> = { foo: 'bar' };
In Svelte 4, you would do ComponentProps<MyComponent>
because MyComponent
was a class.
Example: A generic function that accepts some component and infers the type of its props:
import type { Component, ComponentProps } from 'svelte';
import MyComponent from './MyComponent.svelte';
function withProps<TComponent extends Component<any>>(
component: TComponent,
props: ComponentProps<TComponent>
) {};
// Errors if the second argument is not the correct props expected by the component in the first argument.
withProps(MyComponent, { foo: 'bar' });
ComponentProps } from 'svelte';
import type MyComponent = SvelteComponent<Record<string, any>, any, any>
const MyComponent: LegacyComponentType
MyComponent from './MyComponent.svelte';
// Errors if these aren't the correct props expected by MyComponent.
const const props: Record<string, any>
props: type ComponentProps<Comp extends SvelteComponent | Component<any, any>> = Comp extends SvelteComponent<infer Props extends Record<string, any>, any, any> ? Props : Comp extends Component<infer Props extends Record<...>, any, string> ? Props : never
Convenience type to get the props the given component expects.
Example: Ensure a variable contains the props expected by MyComponent
:
import type { ComponentProps } from 'svelte';
import MyComponent from './MyComponent.svelte';
// Errors if these aren't the correct props expected by MyComponent.
const props: ComponentProps<typeof MyComponent> = { foo: 'bar' };
In Svelte 4, you would do ComponentProps<MyComponent>
because MyComponent
was a class.
Example: A generic function that accepts some component and infers the type of its props:
import type { Component, ComponentProps } from 'svelte';
import MyComponent from './MyComponent.svelte';
function withProps<TComponent extends Component<any>>(
component: TComponent,
props: ComponentProps<TComponent>
) {};
// Errors if the second argument is not the correct props expected by the component in the first argument.
withProps(MyComponent, { foo: 'bar' });
ComponentProps<typeof const MyComponent: LegacyComponentType
MyComponent> = { foo: string
foo: 'bar' };
在 Svelte 4 中,你会使用
ComponentProps<MyComponent>
,因为MyComponent
是一个类。
示例:一个泛型函数,它接受一些组件并推断其 props 的类型
import type { interface Component<Props extends Record<string, any> = {}, Exports extends Record<string, any> = {}, Bindings extends keyof Props | "" = string>
Can be used to create strongly typed Svelte components.
Example:
You have component library on npm called component-library
, from which
you export a component called MyComponent
. For Svelte+TypeScript users,
you want to provide typings. Therefore you create a index.d.ts
:
import type { Component } from 'svelte';
export declare const MyComponent: Component<{ foo: string }> {}
Typing this makes it possible for IDEs like VS Code with the Svelte extension
to provide intellisense and to use the component like this in a Svelte file
with TypeScript:
<script lang="ts">
import { MyComponent } from "component-library";
</script>
<MyComponent foo={'bar'} />
Component, type ComponentProps<Comp extends SvelteComponent | Component<any, any>> = Comp extends SvelteComponent<infer Props extends Record<string, any>, any, any> ? Props : Comp extends Component<infer Props extends Record<...>, any, string> ? Props : never
Convenience type to get the props the given component expects.
Example: Ensure a variable contains the props expected by MyComponent
:
import type { ComponentProps } from 'svelte';
import MyComponent from './MyComponent.svelte';
// Errors if these aren't the correct props expected by MyComponent.
const props: ComponentProps<typeof MyComponent> = { foo: 'bar' };
In Svelte 4, you would do ComponentProps<MyComponent>
because MyComponent
was a class.
Example: A generic function that accepts some component and infers the type of its props:
import type { Component, ComponentProps } from 'svelte';
import MyComponent from './MyComponent.svelte';
function withProps<TComponent extends Component<any>>(
component: TComponent,
props: ComponentProps<TComponent>
) {};
// Errors if the second argument is not the correct props expected by the component in the first argument.
withProps(MyComponent, { foo: 'bar' });
ComponentProps } from 'svelte';
import type MyComponent = SvelteComponent<Record<string, any>, any, any>
const MyComponent: LegacyComponentType
MyComponent from './MyComponent.svelte';
function function withProps<TComponent extends Component<any>>(component: TComponent, props: ComponentProps<TComponent>): void
withProps<function (type parameter) TComponent in withProps<TComponent extends Component<any>>(component: TComponent, props: ComponentProps<TComponent>): void
TComponent extends interface Component<Props extends Record<string, any> = {}, Exports extends Record<string, any> = {}, Bindings extends keyof Props | "" = string>
Can be used to create strongly typed Svelte components.
Example:
You have component library on npm called component-library
, from which
you export a component called MyComponent
. For Svelte+TypeScript users,
you want to provide typings. Therefore you create a index.d.ts
:
import type { Component } from 'svelte';
export declare const MyComponent: Component<{ foo: string }> {}
Typing this makes it possible for IDEs like VS Code with the Svelte extension
to provide intellisense and to use the component like this in a Svelte file
with TypeScript:
<script lang="ts">
import { MyComponent } from "component-library";
</script>
<MyComponent foo={'bar'} />
Component<any>>(
component: TComponent extends Component<any>
component: function (type parameter) TComponent in withProps<TComponent extends Component<any>>(component: TComponent, props: ComponentProps<TComponent>): void
TComponent,
props: ComponentProps<TComponent>
props: type ComponentProps<Comp extends SvelteComponent | Component<any, any>> = Comp extends SvelteComponent<infer Props extends Record<string, any>, any, any> ? Props : Comp extends Component<infer Props extends Record<...>, any, string> ? Props : never
Convenience type to get the props the given component expects.
Example: Ensure a variable contains the props expected by MyComponent
:
import type { ComponentProps } from 'svelte';
import MyComponent from './MyComponent.svelte';
// Errors if these aren't the correct props expected by MyComponent.
const props: ComponentProps<typeof MyComponent> = { foo: 'bar' };
In Svelte 4, you would do ComponentProps<MyComponent>
because MyComponent
was a class.
Example: A generic function that accepts some component and infers the type of its props:
import type { Component, ComponentProps } from 'svelte';
import MyComponent from './MyComponent.svelte';
function withProps<TComponent extends Component<any>>(
component: TComponent,
props: ComponentProps<TComponent>
) {};
// Errors if the second argument is not the correct props expected by the component in the first argument.
withProps(MyComponent, { foo: 'bar' });
ComponentProps<function (type parameter) TComponent in withProps<TComponent extends Component<any>>(component: TComponent, props: ComponentProps<TComponent>): void
TComponent>
) {};
// Errors if the second argument is not the correct props expected by the component in the first argument.
function withProps<LegacyComponentType>(component: LegacyComponentType, props: Record<string, any>): void
withProps(const MyComponent: LegacyComponentType
MyComponent, { foo: string
foo: 'bar' });
type ComponentProps<
Comp extends SvelteComponent | Component<any, any>
> =
Comp extends SvelteComponent<infer Props>
? Props
: Comp extends Component<infer Props, any>
? Props
: never;
ComponentType
当使用新的
Component
类型时,此类型已过时。
type ComponentType<
Comp extends SvelteComponent = SvelteComponent
> = (new (
options: ComponentConstructorOptions<
Comp extends SvelteComponent<infer Props>
? Props
: Record<string, any>
>
) => Comp) & {
/** The custom element version of the component. Only present if compiled with the `customElement` compiler option */
element?: typeof HTMLElement;
};
EventDispatcher
interface EventDispatcher<
EventMap extends Record<string, any>
> {…}
<Type extends keyof EventMap>(
...args: null extends EventMap[Type]
? [type: Type, parameter?: EventMap[Type] | null | undefined, options?: DispatchOptions]
: undefined extends EventMap[Type]
? [type: Type, parameter?: EventMap[Type] | null | undefined, options?: DispatchOptions]
: [type: Type, parameter: EventMap[Type], options?: DispatchOptions]
): boolean;
MountOptions
定义 mount()
函数接受的选项。
type MountOptions<
Props extends Record<string, any> = Record<string, any>
> = {
/**
* Target element where the component will be mounted.
*/
target: Document | Element | ShadowRoot;
/**
* Optional node inside `target`. When specified, it is used to render the component immediately before it.
*/
anchor?: Node;
/**
* Allows the specification of events.
* @deprecated Use callback props instead.
*/
events?: Record<string, (e: any) => any>;
/**
* Can be accessed via `getContext()` at the component level.
*/
context?: Map<any, any>;
/**
* Whether or not to play transitions on initial render.
* @default true
*/
intro?: boolean;
} & ({} extends Props
? {
/**
* Component properties.
*/
props?: Props;
}
: {
/**
* Component properties.
*/
props: Props;
});
Snippet
#snippet
块的类型。您可以使用它来(例如)表示您的组件期望某个特定类型的代码片段。
let { let banner: Snippet<[{
text: string;
}]>
banner }: { banner: Snippet<[{
text: string;
}]>
banner: type Snippet = /*unresolved*/ any
Snippet<[{ text: string
text: string }]> } = function $props(): any
Declares the props that a component accepts. Example:
let { optionalProp = 42, requiredProp, bindableProp = $bindable() }: { optionalProp?: number; requiredProps: string; bindableProp: boolean } = $props();
$props();
您只能通过 {@render ...}
标签调用代码片段。
/docs/svelte/snippet
interface Snippet<Parameters extends unknown[] = []> {…}
(
this: void,
// this conditional allows tuples but not arrays. Arrays would indicate a
// rest parameter type, which is not supported. If rest parameters are added
// in the future, the condition can be removed.
...args: number extends Parameters['length'] ? never : Parameters
): {
'{@render ...} must be called with a Snippet': "import type { Snippet } from 'svelte'";
} & typeof SnippetReturn;