ScrollHandle
What a Scroll ref holds: its element, and methods that scroll it.
Utilização
Scroll after adding content
import { Button, For, ref, Scroll, signal, Text, VStack } from 'kuito';
import type { ScrollHandle } from 'kuito';
function Chat() {
const messages = signal<string[]>([]);
const thread = ref<ScrollHandle>();
function send() {
messages.value = [...messages.value, 'Message ' + (messages.value.length + 1)];
thread.current?.scrollToEnd();
}
return (
<VStack flex={1} gap={8}>
<Scroll ref={thread} flex={1}>
<For each={messages}>{(message) => <Text>{message}</Text>}</For>
</Scroll>
<Button onPress={send}>Send</Button>
</VStack>
);
}Declaração do tipo
export interface ScrollHandle extends ElementHandle {
/**
* Scrolls to `offset` points along the view's axis, or to `page`, a whole
* view length each from 0, as `paging` rests; animated by default.
*/
scrollTo(
params: { offset: number; animated?: boolean } | { page: number; animated?: boolean },
): void;
/** Scrolls to the end of the content, including what the same update added. */
scrollToEnd(params?: { animated?: boolean }): void;
}Membros 11
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
scrollTo | (params: { offset: number; animated?: boolean;} | { page: number; animated?: boolean;}) => void | Sim | Scrolls to offset points along the view's axis, or to page, a whole
view length each from 0, as paging rests; animated by default. |
scrollToEnd | (params?: { animated?: boolean;}) => void | Sim | Scrolls to the end of the content, including what the same update added. |
idsó de leitura | string | Sim | — |
parentsó de leitura | ElementHandle | Sim | — |
childrensó de leitura | ElementHandle[] | Sim | — |
focus | () => void | Sim | — |
blur | () => void | Sim | — |
setProperty | <K extends keyof ElementProperties>(key: K, value: ElementProperties[K] | null) => void | Sim | Sets a native prop on the view now, until its binding writes it again. |
addEventListener | (type: string, fn: (e: KuitoNativeEvent) => void, options?: boolean | { capture?: boolean; once?: boolean; signal?: AbortSignal;}) => void | Sim | — |
removeEventListener | (type: string, fn: (e: KuitoNativeEvent) => void, options?: boolean | { capture?: boolean;}) => void | Sim | — |
dispatchEvent | (event: { type: string; bubbles?: boolean; cancelable?: boolean;}) => boolean | Sim | Sends an event through the tree, capture to bubble, as a native one travels:
a KuitoCustomEvent, or any object with a type. False when a listener
called preventDefault() on a cancelable event. |
scrollTo — assinaturas de método
Assinaturas
(params: { offset: number; animated?: boolean; } | { page: number; animated?: boolean; }): voidParâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
params | { offset: number; animated?: boolean;} | { page: number; animated?: boolean;} | Sim | — |
Devolve
void
scrollToEnd — assinaturas de método
Assinaturas
(params?: { animated?: boolean; }): voidParâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
params | { animated?: boolean;} | Não | — |
Devolve
void
focus — assinaturas de método
Assinaturas
(): voidParâmetros
Sem parâmetros.
Devolve
void
blur — assinaturas de método
Assinaturas
(): voidParâmetros
Sem parâmetros.
Devolve
void
setProperty — assinaturas de método
Assinaturas
<K extends keyof ElementProperties>(key: K, value: ElementProperties[K] | null): voidParâmetros de tipo
| Nome | Restrição | Predefinição |
|---|---|---|
K | keyof ElementProperties | — |
Parâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
key | K | Sim | — |
value | ElementProperties[K] | Sim | — |
Devolve
void
addEventListener — assinaturas de método
Assinaturas
(type: string, fn: (e: KuitoNativeEvent) => void, options?: boolean | { capture?: boolean; once?: boolean; signal?: AbortSignal; }): voidParâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
type | string | Sim | — |
fn | (e: KuitoNativeEvent) => void | Sim | — |
options | boolean | { capture?: boolean; once?: boolean; signal?: AbortSignal;} | Não | — |
Devolve
void
removeEventListener — assinaturas de método
Assinaturas
(type: string, fn: (e: KuitoNativeEvent) => void, options?: boolean | { capture?: boolean; }): voidParâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
type | string | Sim | — |
fn | (e: KuitoNativeEvent) => void | Sim | — |
options | boolean | { capture?: boolean;} | Não | — |
Devolve
void
dispatchEvent — assinaturas de método
Assinaturas
(event: { type: string; bubbles?: boolean; cancelable?: boolean; }): booleanParâmetros
| Nome | Tipo | Obrigatório | Descrição |
|---|---|---|---|
event | { type: string; bubbles?: boolean; cancelable?: boolean;} | Sim | — |
Devolve
boolean
Gerado a partir das declarações TypeScript públicas: assinaturas, props e predefinições vêm da fonte verificada, as descrições da sua JSDoc. Nenhuma predefinição é inventada.