Utilização

Scroll a list to a particular item.

tsx
// Scroll a list to a particular item.
import { Button, List, Text, ref, type ListHandle, type ScrollToIndexOptions } from 'kuito';

function Chapters(props: { titles: string[]; current: number }) {
  const list = ref<ListHandle>();
  // Centers the current chapter, with room for the header above it.
  const toCurrent: ScrollToIndexOptions = {
    index: props.current,
    align: 0.5,
    margin: 16,
    animated: true,
  };

  return (
    <>
      <Button onPress={() => list.current?.scrollToIndex(toCurrent)}>Current chapter</Button>
      <List ref={list} data={props.titles} renderItem={({ item }) => <Text>{item}</Text>} />
    </>
  );
}

Declaração do tipo

ts
export interface ListHandle extends ScrollHandle {
  scrollToIndex(params: ScrollToIndexOptions): void;
  scrollToItem(params: Omit<ScrollToIndexOptions, 'index'> & { item: unknown }): void;
}

Membros 13

NomeTipoObrigatórioDescrição
scrollToIndex(params: ScrollToIndexOptions) => voidSim—
scrollToItem(params: Omit<ScrollToIndexOptions, "index"> & { item: unknown;}) => voidSim—
scrollTo(params: { offset: number; animated?: boolean;} | { page: number; animated?: boolean;}) => voidSimScrolls 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;}) => voidSimScrolls to the end of the content, including what the same update added.
idsó de leiturastringSim—
parentsó de leituraElementHandleSim—
childrensó de leituraElementHandle[]Sim—
focus() => voidSim—
blur() => voidSim—
setProperty<K extends keyof ElementProperties>(key: K, value: ElementProperties[K] | null) => voidSimSets 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;}) => voidSim—
removeEventListener(type: string, fn: (e: KuitoNativeEvent) => void, options?: boolean | { capture?: boolean;}) => voidSim—
dispatchEvent(event: { type: string; bubbles?: boolean; cancelable?: boolean;}) => booleanSimSends 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.
scrollToIndex — assinaturas de método

Assinaturas

ts
(params: ScrollToIndexOptions): void

Parâmetros

NomeTipoObrigatórioDescrição
paramsScrollToIndexOptionsSim—

Devolve

void

scrollToItem — assinaturas de método

Assinaturas

ts
(params: Omit<ScrollToIndexOptions, "index"> & { item: unknown; }): void

Parâmetros

NomeTipoObrigatórioDescrição
paramsOmit<ScrollToIndexOptions, "index"> & { item: unknown;}Sim—

Devolve

void

scrollTo — assinaturas de método

Assinaturas

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

Parâmetros

NomeTipoObrigatórioDescrição
params{ offset: number; animated?: boolean;} | { page: number; animated?: boolean;}Sim—

Devolve

void

scrollToEnd — assinaturas de método

Assinaturas

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

Parâmetros

NomeTipoObrigatórioDescrição
params{ animated?: boolean;}Não—

Devolve

void

focus — assinaturas de método

Assinaturas

ts
(): void

Parâmetros

Sem parâmetros.

Devolve

void

blur — assinaturas de método

Assinaturas

ts
(): void

Parâmetros

Sem parâmetros.

Devolve

void

setProperty — assinaturas de método

Assinaturas

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

Parâmetros de tipo

NomeRestriçãoPredefinição
Kkeyof ElementProperties—

Parâmetros

NomeTipoObrigatórioDescrição
keyKSim—
valueElementProperties[K]Sim—

Devolve

void

addEventListener — assinaturas de método

Assinaturas

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

Parâmetros

NomeTipoObrigatórioDescrição
typestringSim—
fn(e: KuitoNativeEvent) => voidSim—
optionsboolean | { capture?: boolean; once?: boolean; signal?: AbortSignal;}Não—

Devolve

void

removeEventListener — assinaturas de método

Assinaturas

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

Parâmetros

NomeTipoObrigatórioDescrição
typestringSim—
fn(e: KuitoNativeEvent) => voidSim—
optionsboolean | { capture?: boolean;}Não—

Devolve

void

dispatchEvent — assinaturas de método

Assinaturas

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

Parâmetros

NomeTipoObrigatórioDescriçã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.