# ActionSheet - 底部动作面板

## 说明

从底部弹出的动作面板，用于呈现一组操作选项（建议 2-4 个），底部固定一个取消按钮。基于 `BaseDialog` 实现，遮罩、关闭行为与其他 HyperOS 弹窗一致；点击任一选项或取消按钮、点击遮罩都会关闭面板。选项区超高时可滚动，取消区始终固定在底部。

## 属性

| 属性 | 说明 | 类型 | 默认值 | 必填 |
|------|------|------|--------|------|
| **visible** | 是否显示 | `boolean` | - | 是 |
| **title** | 顶部标题，为空不展示 | `string` | - | 否 |
| **options** | 操作选项列表（建议 2-4 个） | `ActionSheetOption[]` | - | 是 |
| **cancelText** | 取消按钮文字 | `string` | `'取消'` | 否 |
| **onCancel** | 取消回调（点击取消按钮或遮罩均触发） | `() => void` | - | 否 |
| **accessible** | 无障碍：是否启用 | `boolean` | `true` | 否 |
| **accessibilityLabel** | 无障碍标签 | `string` | - | 否 |
| **accessibilityHint** | 无障碍提示 | `string` | - | 否 |

### ActionSheetOption

| 字段 | 说明 | 类型 | 默认值 | 必填 |
|------|------|------|--------|------|
| **label** | 按钮文字（最多 3 行） | `string` | - | 是 |
| **type** | 按钮类型。`default` 常规、`warning` 警示（红色）、`emphasis` 强调（按 `colorType` 着色） | `'default' \| 'warning' \| 'emphasis'` | `'default'` | 否 |
| **colorType** | 强调色系，仅 `type='emphasis'` 时生效 | `ColorType` | `'blue'` | 否 |
| **disabled** | 是否禁用 | `boolean` | `false` | 否 |
| **onPress** | 点击回调 | `() => void` | - | 否 |

> `ColorType` 可选值：`'blue' \| 'green' \| 'wathet' \| 'purple' \| 'orange'`。

## 使用示例

```tsx
import { ActionSheet } from 'miot/ui/hyperOSUI';

<ActionSheet
  visible={visible}
  title="更多操作"
  options={[
    { label: '分享', onPress: onShare },
    { label: '置顶', type: 'emphasis', colorType: 'blue', onPress: onPin },
    { label: '删除', type: 'warning', onPress: onDelete },
  ]}
  onCancel={() => setVisible(false)}
/>
```

## 注意事项

- 点击选项的 `onPress` 后，面板不会自动关闭，需要在回调里自行将 `visible` 置为 `false`（`onCancel` 仅在点击取消按钮或遮罩时触发）。
- `options` 过多时选项区可滚动，取消区始终固定在底部。

## 修改记录

| 日期 | 版本 | 修改内容 | 修改原因 | 关联 |
|------|------|----------|----------|------|
| 2026-06-04 | v1.18.12 | 优化动作面板视觉样式 | — | 12981332 |
| 2026-05-19 | v1.18.8 | 改用 BaseDialog 包裹，统一遮罩与关闭行为 | — | 70c64e3c |
| 2026-05-07 | v1.18.8 | 调整选项按压态表现 | — | bb509919 |
| 2026-05-07 | v1.18.8 | 修复若干已知问题 | — | 8576ace3 |
| 2026-04-24 | v1.18.6 | 取消按钮改用 BlockButton | — | 2db85c0f |
| 2026-04-14 | v1.18.5-alpha.0 | 调整组件参数 | — | db2b5d5a |
| 2026-04-11 | v1.18.5-alpha.0 | ActionSheet 组件初版 | — | 4ff16fa0 |