Utilisation

Lay out an onboarding page

Ce type est utilisé par Pager

tsx
import { Page, Pager, Text, VStack, signal } from 'kuito';

export default function Onboarding() {
  const page = signal(0);

  return (
    <VStack flex={1}>
      <Pager page={page} flex={1}>
        <Page justifyContent="center" alignItems="center">
          <Text>Welcome</Text>
        </Page>
        <Page justifyContent="center" alignItems="center">
          <Text>Sync your library</Text>
        </Page>
        <Page justifyContent="center" alignItems="center">
          <Text>You're all set</Text>
        </Page>
      </Pager>
      <Text textAlign="center">{`${page.value + 1} of 3`}</Text>
    </VStack>
  );
}

Déclaration du type

ts
export interface PagerProps extends Omit<
  ScrollProps,
  'horizontal' | 'paging' | 'snapOffsets' | 'ref' | 'onScrollEnd' | 'children'
> {
  /**
   * The page shown, from 0; the first by default. Two-way when given a
   * signal: the pager writes it as the user pages.
   */
  page?: number | Signal<number>;
  /** The page the user paged to; the app's own `page` reports none. */
  onPageChange?: (page: number) => void;
  /** Its pages, each a `Page`. */
  children?: KuitoNode;
}

Membres 105

NomTypeRequisDescription
pagenumber | Signal<number>NonThe page shown, from 0; the first by default. Two-way when given a signal: the pager writes it as the user pages.
onPageChange(page: number) => voidNonThe page the user paged to; the app's own page reports none.
childrenKuitoNodeNonIts pages, each a Page.
scrollbarProp<boolean>NonShows the scrollbar while scrolling; true by default.
opacityAnimatable<number>Non—
backgroundColorAnimatable<string>Non—
borderRadiusAnimatable<number>Non—
borderColorAnimatable<string>Non—
widthAnimatable<SizeValue>Non—
heightAnimatable<SizeValue>Non—
translateXAnimatable<number>Non—
translateYAnimatable<number>Non—
scaleAnimatable<number>Non—
scaleXAnimatable<number>Non—
scaleYAnimatable<number>Non—
rotateAnimatable<number>NonDegrees.
shadowColorAnimatable<string>Non—
shadowRadiusAnimatable<number>Non—
shadowOffsetXAnimatable<number>Non—
shadowOffsetYAnimatable<number>Non—
hiddenProp<boolean>NonTakes the view out of layout and off screen, as CSS display: none.
paddingProp<LengthPercentage>Non—
positionProp<"relative" | "absolute">Non—
idstringNon—
classProp<ClassNames>NonClass names from a .css import or styles(): a string, or a list with falsy entries skipped, following the signals it reads.
styleStyleDeclarationsNonStyles of this view alone, compiled at build time: CSS properties in camelCase. A value that changes must set a native prop (opacity).
onPress(event: PressEvent) => voidNon—
onPressCapture(event: PressEvent) => voidNon—
keystring | numberNon—
paddingTopProp<LengthPercentage>Non—
paddingRightProp<LengthPercentage>Non—
paddingBottomProp<LengthPercentage>Non—
paddingLeftProp<LengthPercentage>Non—
minWidthProp<SizeValue>Non—
maxWidthProp<SizeValue>Non—
minHeightProp<SizeValue>Non—
maxHeightProp<SizeValue>Non—
aspectRatioProp<number>NonWidth divided by height; sizes the missing side from the other.
topProp<LengthPercentageAuto>Non—
rightProp<LengthPercentageAuto>Non—
bottomProp<LengthPercentageAuto>Non—
leftProp<LengthPercentageAuto>Non—
marginProp<LengthPercentageAuto>Non—
marginTopProp<LengthPercentageAuto>Non—
marginRightProp<LengthPercentageAuto>Non—
marginBottomProp<LengthPercentageAuto>Non—
marginLeftProp<LengthPercentageAuto>Non—
flexGrowProp<number>Non—
flexShrinkProp<number>Non—
flexBasisProp<SizeValue | "content">Non—
flexProp<number>NonA grow factor from a zero basis, as CSS flex: n; 0 is inflexible.
alignSelfProp<"auto" | SelfAlignment>Non—
directionProp<"ltr" | "rtl">NonThe way lines run; unset, the parent's, and the app's first language's at the root.
boxSizingProp<"border-box" | "content-box">Non—
paddingInlineStartProp<LengthPercentage>NonPadding on the side lines start from: the left in ltr, the right in rtl.
paddingInlineEndProp<LengthPercentage>NonPadding on the side lines end at: the right in ltr, the left in rtl.
marginInlineStartProp<LengthPercentageAuto>NonMargin on the side lines start from: the left in ltr, the right in rtl.
marginInlineEndProp<LengthPercentageAuto>NonMargin on the side lines end at: the right in ltr, the left in rtl.
insetInlineStartProp<LengthPercentageAuto>Nonleft in ltr, right in rtl.
insetInlineEndProp<LengthPercentageAuto>Nonright in ltr, left in rtl.
roleProp<Role>Non—
onAction(event: AccessibilityActionEvent) => voidNonThe screen reader action taken, by name.
accessibleProp<boolean>NonMakes the view one screen reader element, read as its label or its children's text.
labelProp<string>NonWhat a screen reader says for the view.
hintProp<string>NonWhat happens when the view is activated, read after the label.
aria-hiddenProp<boolean>NonScreen readers skip the view and its subtree.
actionsProp<readonly AccessibilityAction[]>NonActions a screen reader offers; onAction receives the one taken.
liveProp<"off" | "polite" | "assertive">NonARIA's aria-live: announces changes to the view's content, on iOS too.
aria-disabledProp<boolean>Non—
aria-selectedProp<boolean>Non—
aria-checkedProp<boolean | "mixed">Non—
aria-busyProp<boolean>Non—
aria-expandedProp<boolean>Non—
aria-valueminProp<number>Non—
aria-valuemaxProp<number>Non—
aria-valuenowProp<number>Non—
aria-valuetextProp<string>Non—
gesturesreadonly Composable[]NonThe view's gestures; several race unless composed with together or orElse.
transitionPartial<Record<"opacity" | "backgroundColor" | "transform" | "borderRadius" | "borderColor" | "shadow" | "width" | "height" | "all", Animation<unknown> | AnimationSpec>>NonHow the animatable props move when they change, enter or leave, by group; a CSS transition compiles to it.
animatePartial<Record<AnimatableProps, string | number>>NonAnimatable props whose every change moves as transition says; the first value applies at once.
enterEffectNonWhere the view enters from: fade.and(slide.up(12)).
exitProp<Effect>NonWhere the view leaves to; it stays on screen until it is there. The renderer gets true, and keeps the view until exited.
layoutAnimation<number>NonHow the view moves to a new frame the layout gives it: layout={spring()}.
overflowProp<"visible" | "hidden" | "clip" | "scroll">Nonhidden and scroll clip; as in CSS, either lets a flex item shrink below its content.
borderWidthProp<number>Non—
backgroundGradient{ angle: number; colors: string[];}Non—
colorProp<string>Non—
sharedIdProp<string>NonA view the navigation stack flies to the view with the same sharedId on the screen it pushes or pops to (docs/navigation.md#shared-elements).
alignItemsProp<SelfAlignment>Non—
justifyContentProp<ContentAlignment>Non—
gapProp<LengthPercentage>Non—
rowGapProp<LengthPercentage>Non—
columnGapProp<LengthPercentage>Non—
flexDirectionProp<"row" | "column" | "row-reverse" | "column-reverse">Non—
flexWrapProp<"nowrap" | "wrap" | "wrap-reverse" | "balance">Non—
flexLineCountProp<number>NonThe minimum number of lines a wrapping container breaks into (CSS Flexbox 2).
alignContentProp<ContentAlignment>Non—
keyboardProp<{ dismiss?: "none" | "on-drag" | "interactive"; persistTaps?: "never" | "always" | "handled"; inset?: boolean; avoid?: "none" | "padding" | "position";}>Non—
motionScrollMotionNonMoves with the view every frame on the UI thread: scrollMotion(), given to one view.
onScroll(event: ScrollEvent) => voidNon—
onReachEnd(event: KuitoEvent<"reachend">) => voidNonCalled once each time the content end comes within the threshold.
onRefresh(event: KuitoEvent<"refresh">) => voidNonEnables pull-to-refresh.
scrollIntervalProp<number>NonAt most one scroll event per this many milliseconds; 50 by default.
reachEndThresholdProp<number>NonDistance from the end, in visible lengths, that counts as the end; 0.5 by default.
refreshingBound<boolean>NonShows the pull-to-refresh spinner while true.
onPageChange — signatures de méthode

Signatures

ts
(page: number): void

Paramètres

NomTypeRequisDescription
pagenumberOui—

Retourne

void

onPress — signatures de méthode

Signatures

ts
(event: PressEvent): void

Paramètres

NomTypeRequisDescription
eventPressEventOui—

Retourne

void

onPressCapture — signatures de méthode

Signatures

ts
(event: PressEvent): void

Paramètres

NomTypeRequisDescription
eventPressEventOui—

Retourne

void

onAction — signatures de méthode

Signatures

ts
(event: AccessibilityActionEvent): void

Paramètres

NomTypeRequisDescription
eventAccessibilityActionEventOui—

Retourne

void

backgroundGradient — champs imbriqués

backgroundGradient champs

NomTypeRequisDescription
anglenumberOui—
colorsstring[]Oui—
onScroll — signatures de méthode

Signatures

ts
(event: ScrollEvent): void

Paramètres

NomTypeRequisDescription
eventScrollEventOui—

Retourne

void

onReachEnd — signatures de méthode

Signatures

ts
(event: KuitoEvent<"reachend">): void

Paramètres

NomTypeRequisDescription
eventKuitoEvent<"reachend">Oui—

Retourne

void

onRefresh — signatures de méthode

Signatures

ts
(event: KuitoEvent<"refresh">): void

Paramètres

NomTypeRequisDescription
eventKuitoEvent<"refresh">Oui—

Retourne

void

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.