ScrollHandle — Kuito Documentation

Utilisation

Scroll after adding content

tsx

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>
  );
}

Déclaration du type

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;
}

Membres 11

Nom	Type	Requis	Description
`scrollTo`	`(params: { offset: number; animated?: boolean;} \| { page: number; animated?: boolean;}) => void`	Oui	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`	Oui	Scrolls to the end of the content, including what the same update added.
`id`lecture seule	`string`	Oui	—
`parent`lecture seule	`ElementHandle`	Oui	—
`children`lecture seule	`ElementHandle[]`	Oui	—
`focus`	`() => void`	Oui	—
`blur`	`() => void`	Oui	—
`setProperty`	`<K extends keyof ElementProperties>(key: K, value: ElementProperties[K] \| null) => void`	Oui	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`	Oui	—
`removeEventListener`	`(type: string, fn: (e: KuitoNativeEvent) => void, options?: boolean \| { capture?: boolean;}) => void`	Oui	—
`dispatchEvent`	`(event: { type: string; bubbles?: boolean; cancelable?: boolean;}) => boolean`	Oui	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 — signatures de méthode

Signatures

(params: { offset: number; animated?: boolean; } | { page: number; animated?: boolean; }): void

Paramètres

Nom	Type	Requis	Description
`params`	`{ offset: number; animated?: boolean;} \| { page: number; animated?: boolean;}`	Oui	—

Retourne

void

scrollToEnd — signatures de méthode

Signatures

(params?: { animated?: boolean; }): void

Paramètres

Nom	Type	Requis	Description
`params`	`{ animated?: boolean;}`	Non	—

Retourne

void

focus — signatures de méthode

Signatures

(): void

Paramètres

Aucun paramètre.

Retourne

void

blur — signatures de méthode

Signatures

(): void

Paramètres

Aucun paramètre.

Retourne

void

setProperty — signatures de méthode

Signatures

<K extends keyof ElementProperties>(key: K, value: ElementProperties[K] | null): void

Paramètres de type

Nom	Contrainte	Par défaut
`K`	`keyof ElementProperties`	—

Paramètres

Nom	Type	Requis	Description
`key`	`K`	Oui	—
`value`	`ElementProperties[K]`	Oui	—

Retourne

void

addEventListener — signatures de méthode

Signatures

(type: string, fn: (e: KuitoNativeEvent) => void, options?: boolean | { capture?: boolean; once?: boolean; signal?: AbortSignal; }): void

Paramètres

Nom	Type	Requis	Description
`type`	`string`	Oui	—
`fn`	`(e: KuitoNativeEvent) => void`	Oui	—
`options`	`boolean \| { capture?: boolean; once?: boolean; signal?: AbortSignal;}`	Non	—

Retourne

void

removeEventListener — signatures de méthode

Signatures

(type: string, fn: (e: KuitoNativeEvent) => void, options?: boolean | { capture?: boolean; }): void

Paramètres

Nom	Type	Requis	Description
`type`	`string`	Oui	—
`fn`	`(e: KuitoNativeEvent) => void`	Oui	—
`options`	`boolean \| { capture?: boolean;}`	Non	—

Retourne

void

dispatchEvent — signatures de méthode

Signatures

(event: { type: string; bubbles?: boolean; cancelable?: boolean; }): boolean

Paramètres

Nom	Type	Requis	Description
`event`	`{ type: string; bubbles?: boolean; cancelable?: boolean;}`	Oui	—

Retourne

boolean

Généré depuis les déclarations TypeScript publiques : signatures, props et valeurs par défaut viennent de la source vérifiée, les descriptions de sa JSDoc. Aucune valeur par défaut n'est inventée.