跳到主要内容
smallPict
免费开始
首页框架集成React 组件 SDK

面向现代 React 应用的高性能响应式图片组件

为单页应用(SPA)以及 React 框架(Vite、Remix、Gatsby、Astro)集成动态图像转换、模糊过渡占位与艺术指导功能。

安装命令

TSX 软件包
$ npm install @smallpict/react

代码接入示例

tsx
import { SmallPictImage } from '@smallpict/react';

export function ProductHero() {
  return (
    <SmallPictImage
      src="https://my-bucket.s3.amazonaws.com/camera.jpg"
      alt="Pro Mirrorless Camera"
      width={800}
      height={500}
      format="auto" // Auto-selects AVIF or WebP based on browser support
      quality={85}
      placeholder="blur"
      className="rounded-2xl shadow-xl"
    />
  );
}

集成接入步骤

  1. 安装依赖包

    在 React 项目中运行 npm install @smallpict/react。

  2. 配置 SmallPictProvider

    在应用根节点包裹 Provider 并配置 API 密钥及 CDN 域名。

  3. 使用 SmallPictImage

    用 SmallPictImage 替换普通 img 标签。

核心优势与收益

  • 自动渲染带 AVIF/WebP/PNG 回退的 picture 标签
  • 基于 IntersectionObserver 的原生懒加载
  • 预留图片尺寸,布局不会偏移
  • 包体积小

需要完整的开发指南与 API 规范?

在官方 React 组件 SDK 开发者指南中查阅完整的参数参考、鉴权机制、错误码说明及本地调试教程。

查阅 React 组件 SDK 完整文档

加速您的 React 组件 SDK 图片处理流程

在您的应用中试用 AVIF 与 WebP 图片优化。无入网费,立即获取沙箱密钥。