> For AI agents: the complete documentation index is available at /apps-plugin/docs/llms.txt, the full documentation bundle is available at /apps-plugin/docs/llms-full.txt.

# swiper-item

轮播项组件，用于包裹单个轮播内容，必须作为 Swiper 的直接子组件使用。

<iframe src="https://developer.doubao.com/docs-preview/component-simulator/?caseId=swiper"
  title="组件示例 swiper-item"
  width="100%"
  height="700"
  loading="lazy"
  style="width:100%;height:700px;border:0;border-radius:16px;overflow:hidden;"
></iframe>

## 扫码预览

![扫码预览 swiper-item](https://api.qrserver.com/v1/create-qr-code/?size=200x200\&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fcomponent%252Fswiper%252Findex)

## Props

<table>
<thead>
<tr><th width="140">属性名</th><th width="240">类型</th><th width="120">默认值</th><th width="80">必填</th><th width="360">说明</th></tr>
</thead>
<tbody>
<tr><td>children</td><td><code>ReactElement&lt;any, string | JSXElementConstructor&lt;any&gt;&gt;<br>| ReactElement&lt;any, string | JSXElementConstructor&lt;any&gt;&gt;[]</code></td><td>-</td><td>是</td><td>子元素</td></tr>
<tr><td>className</td><td><code>string</code></td><td>-</td><td>否</td><td>类名</td></tr>
<tr><td>index</td><td><code>number</code></td><td>-</td><td>是</td><td>当前 SwiperItem 的索引，基于 Swiper 的数据</td></tr>
<tr><td>overlap</td><td><code>boolean</code></td><td>-</td><td>否</td><td>传递给 SwiperItem 直接子元素的 <code>overlap</code> 属性<br>仅在透明度有问题时使用</td></tr>
<tr><td>realIndex</td><td><code>number</code></td><td>-</td><td>否</td><td>当前 SwiperItem 的真实索引，基于 Swiper 的数据<br>与 <code>index</code> 相同，但在 loop 模式下会不同</td></tr>
<tr><td>style</td><td><code>CSSProperties</code></td><td>-</td><td>否</td><td>样式</td></tr>
</tbody>
</table>
