Command Palette

Search for a command to run...

Docs
Operation Box

Operation Box

用于展示 API 操作的容器组件,提供统一的布局和样式。

Operation Box 组件是一个容器组件,用于展示完整的 API 操作信息,包括方法、路径、描述等。

Loading...

安装

使用方法

import { OperationBox } from "@/components/pivot/operation-box";
<OperationBox
  method="GET"
  path="/api/users"
  summary="获取用户列表"
  description="获取系统中所有用户的分页列表"
>
  {/* 操作详细内容 */}
</OperationBox>

示例

基本用法

<OperationBox
  method="GET"
  path="/api/users/{id}"
  summary="获取用户详情"
  description="根据用户ID获取特定用户的详细信息"
>
  <div className="space-y-4">
    <ParametersSection parameters={pathParameters} />
    <ResponsesSection responses={responses} />
  </div>
</OperationBox>

完整的 API 操作

<div className="space-y-6">
  <OperationBox
    method="GET"
    path="/api/users"
    summary="获取用户列表"
    description="获取系统中所有用户的分页列表,支持搜索和过滤"
  >
    <ParametersSection parameters={queryParameters} />
    <ResponsesSection responses={getResponses} />
  </OperationBox>
 
  <OperationBox
    method="POST"
    path="/api/users"
    summary="创建用户"
    description="在系统中创建一个新的用户账户"
  >
    <RequestBodySection schema={userCreateSchema} />
    <ResponsesSection responses={postResponses} />
  </OperationBox>
</div>

API 参考

Props

属性类型默认值描述
methodstring-HTTP 方法
pathstring-API 路径
summarystring-操作摘要
descriptionstring-操作详细描述
childrenReact.ReactNode-操作的详细内容
classNamestring-额外的 CSS 类名