组件 API

View

type ViewProps = {
  style?: ViewStyles | ViewStyles[];
  children?: any;
  ref?: (el: PView) => void;
} & EventProps;

详见：View 组件文档

---

Image

type ImageProps = {
  src: Sprite | Graphics;
  style?: ImageStyles | ImageStyles[];
  ref?: (el: PImage) => void;
} & EventProps;

interface ImageStyles extends ViewStyles {
  objectFit?: 'contain' | 'cover' | 'fill' | 'none';
}

详见：Image 组件文档

---

Text

interface TextProps {
  style?: TextStyles | TextStyles[];
  children?: JSX.Element;
  ref?: (el: PText) => void;
}

常用文本截断样式（通过 style 传入）：

• textOverflow: 'clip' | 'ellipsis'
• lineClamp: number

详见：Text 组件文档

---

Span

// Span 内联文本样式包裹器，仅用于 Text 内部
function Span(props: {
  style?: TextStyles;
  bold?: boolean;
  italic?: boolean;
  children?: any;
}): JSX.Element;

---

Img

// Img 行内图片，仅用于 Text 内部
function Img(props: {
  src: Sprite | Graphics;
  style?: TextStyles;
}): JSX.Element;

---

ScrollView

type ScrollViewProps = {
  style?: ViewStyles | ViewStyles[];
  children?: any;
  ref?: (el: PScrollView) => void;
  horizontal?: boolean;
} & EventProps;

详见：ScrollView 组件文档

---

CustomView

type CustomViewProps = {
  style?: ViewStyles | ViewStyles[];
  onDraw?: (graphics: Graphics, width: number, height: number) => void;
  ref?: (el: PCustomView) => void;
} & EventProps;

详见：CustomView 组件文档

---

Show

type ShowProps<T> = {
  when: T;
  children?: JSX.Element | ((item: () => NonNullable<T>) => JSX.Element);
  fallback?: JSX.Element;
};

function Show<T>(props: ShowProps<T>): JSX.Element;

详见：Show 控制流文档

---

For

function For<T>(props: {
  each: T[];
  fallback?: JSX.Element;
  children: (item: T, index: Getter<number>) => JSX.Element;
}): JSX.Element;

详见：For 控制流文档

---

Index

function Index<T>(props: {
  each: T[];
  fallback?: JSX.Element;
  children: (item: Getter<T>, index: number) => JSX.Element;
}): JSX.Element;

详见：For 与 Index 文档

---

Switch

type SwitchProps = {
  fallback?: JSX.Element;
  children?: JSX.Element;
};

function Switch(props: SwitchProps): JSX.Element;

---

Match

type MatchProps<T> = {
  when?: T | false | null;
  keyed?: boolean;
  children?: JSX.Element | ((value: T | (() => T)) => JSX.Element);
};

function Match<T>(props: MatchProps<T>): JSX.Element;

详见：Switch 与 Match 文档

---

Dynamic

interface DynamicProps {
  component: JSX.Element;
  props: any;
}

function Dynamic(props: DynamicProps): JSX.Element;

详见：Dynamic 控制流文档

---

ErrorBoundary

function ErrorBoundary(props: {
  fallback: JSX.Element | ((err: Error, reset: () => void) => JSX.Element);
  children: JSX.Element;
}): JSX.Element;

详见：ErrorBoundary 文档

---

事件 Props（EventProps）

所有支持交互的组件（View、Image、ScrollView、CustomView）均接受以下事件 props：

type EventProps = {
  onClick?: (event: FederatedPointerEvent) => void;
  onPointerDown?: (event: FederatedPointerEvent) => void;
  onPointerUp?: (event: FederatedPointerEvent) => void;
  onPointerMove?: (event: FederatedPointerEvent) => void;
  onPointerEnter?: (event: FederatedPointerEvent) => void;
  onPointerLeave?: (event: FederatedPointerEvent) => void;
  onPointerOver?: (event: FederatedPointerEvent) => void;
  onPointerOut?: (event: FederatedPointerEvent) => void;
  onPointerCancel?: (event: FederatedPointerEvent) => void;
  onPointerUpOutside?: (event: FederatedPointerEvent) => void;
  onPointerTap?: (event: FederatedPointerEvent) => void;
  onRightClick?: (event: FederatedPointerEvent) => void;
  onRightDown?: (event: FederatedPointerEvent) => void;
  onRightUp?: (event: FederatedPointerEvent) => void;
  onRightUpOutside?: (event: FederatedPointerEvent) => void;
  onWheel?: (event: FederatedWheelEvent) => void;
  onGlobalMouseMove?: (event: FederatedPointerEvent) => void;
  onGlobalTouchMove?: (event: FederatedPointerEvent) => void;
  onGlobalPointerMove?: (event: FederatedPointerEvent) => void;
  // ... 完整列表详见事件处理文档
};

详见：事件处理文档