# NoticeBar - 通知栏

## 说明

单行或多行（最多 3 行）通知提示条，用于展示状态提示信息。支持四种状态配色、可选左侧图标，以及右侧交互（跳转箭头或关闭按钮）。整条可点击，仅当 `actionType` 为 `navigate` / `close` 且对应回调存在时才可交互，否则禁用点击。左侧图标为 SVG 组件时会自动套用当前状态的图标色。

## 属性

| 属性 | 说明 | 类型 | 默认值 | 必填 |
|------|------|------|--------|------|
| **title** | 通知文本内容（最多 3 行，超出省略） | `string` | - | 是 |
| **status** | 状态/类型。`default` 常规、`emphasis` 强调（按 `colorType` 着色）、`notice` 提示（黄）、`warning` 警示（红） | `'default' \| 'emphasis' \| 'notice' \| 'warning'` | `'default'` | 否 |
| **leadingIcon** | 左侧图标，不传则不显示 | `React.ReactElement` | - | 否 |
| **actionType** | 右侧交互类型。`none` 无、`navigate` 跳转箭头、`close` 关闭按钮 | `'none' \| 'navigate' \| 'close'` | `'none'` | 否 |
| **colorType** | 色系，仅 `status='emphasis'` 时生效 | `ColorType` | `'green'` | 否 |
| **onPress** | `actionType='navigate'` 时的点击回调 | `() => void` | - | 否 |
| **onClose** | `actionType='close'` 时的关闭回调 | `() => void` | - | 否 |
| **accessible** | 无障碍：是否启用 | `boolean` | `true` | 否 |

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

## 使用示例

```tsx
import { NoticeBar } from 'miot/ui/hyperOSUI';
import SomeIcon from '@icons/SomeIcon';

// 普通提示
<NoticeBar title="设备已离线，请检查网络连接" status="notice" />

// 可跳转
<NoticeBar
  title="检测到新固件版本，点击查看"
  status="emphasis"
  colorType="blue"
  actionType="navigate"
  onPress={onNavigate}
/>

// 带图标、可关闭
<NoticeBar
  title="当前处于勿扰模式"
  status="warning"
  leadingIcon={<SomeIcon width={18} height={18} />}
  actionType="close"
  onClose={onClose}
/>
```

## 注意事项

- 整条是否可点击取决于 `actionType`：仅 `navigate`（`onPress`）/ `close`（`onClose`）时可交互，`none` 时禁用点击。
- `leadingIcon` 为有效的 SVG 元素时，组件会通过 `fill` 覆盖为当前状态对应的图标颜色。
- `colorType` 仅在 `status='emphasis'` 时参与配色，其他状态下忽略。

## 修改记录

| 日期 | 版本 | 修改内容 | 修改原因 | 关联 |
|------|------|----------|----------|------|
| 2026-07-20 | v1.18.17 | 118 版本组件更新 | — | feef8025 |
| 2026-06-04 | v1.18.12 | 优化通知栏样式 | — | 12981332 |
| 2026-04-29 | v1.18.6 | 优化组件 | — | 7e97700e |
| 2026-04-29 | v1.18.6 | 修复组件问题 | — | e15b02a4 |
| 2026-04-22 | v1.18.5-alpha.0 | 清理废弃引用 | — | 5f8f6396 |
| 2026-04-16 | v1.18.5-alpha.0 | 组件细节优化 | — | 805a263e |
| 2026-04-14 | v1.18.5-alpha.0 | 组件初版改造 | — | 9dc50c99 |