> 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.

# picker-view

滚轮选择器容器，支持多列组合选择。

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

## 扫码预览

![扫码预览 picker-view](https://api.qrserver.com/v1/create-qr-code/?size=200x200\&data=doubao%3A%2F%2Fdoubao_apps%3Fapp_id%3Ddb_1McM5Ni%26path%3D%252Fpages%252Fcomponent%252Fpicker-view%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>ReactNode</code></td><td>-</td><td>否</td><td>子元素，通常是 PickerColumn</td></tr>
<tr><td>className</td><td><code>string</code></td><td>-</td><td>否</td><td>组件类名</td></tr>
<tr><td>itemHeight</td><td><code>number</code></td><td>-</td><td>否</td><td>单个选项高度，单位 px。PickerView 会用它同步 indicator 高度和滚动居中计算。</td></tr>
<tr><td>onChange</td><td><code>(values: (string | number)[], options: PickerColumnOption[]) =&gt; void</code></td><td>-</td><td>否</td><td>选项变化时触发</td></tr>
<tr><td>style</td><td><code>CSSProperties</code></td><td>-</td><td>否</td><td>组件样式</td></tr>
<tr><td>theme</td><td><code>Theme</code></td><td>-</td><td>否</td><td>组件主题。未传时跟随豆包当前主题；传入后固定使用指定主题。</td></tr>
</tbody>
</table>

## Ref 方法

<table>
<thead>
<tr><th width="180">方法名</th><th width="260">类型</th><th width="360">说明</th></tr>
</thead>
<tbody>
<tr><td>getOptions</td><td><code>() =&gt; PickerColumnOption[]</code></td><td>按列顺序获取各列当前选中项的完整选项数据。</td></tr>
<tr><td>getValues</td><td><code>() =&gt; (string | number)[]</code></td><td>按列顺序获取各列当前选中项的值。</td></tr>
<tr><td>setValues</td><td><code>(values: (string | number)[]) =&gt; void</code></td><td>按列顺序把各列滚动到指定值对应的选项。</td></tr>
</tbody>
</table>
