# Notify 消息提示

### 引入

在`index.config.js中引入组件

```json
"usingComponents": {
  "van-notify": "@vant/weapp/notify/index"
}
```

## 代码演示

### 基础用法

```js
import Notify from 'path/to/@vant/weapp/dist/notify/notify';

Notify('通知内容');
```

```html
<!-- 在页面内添加对应的节点 -->
<van-notify id="van-notify" />
```

### 通知类型

支持`primary`、`success`、`warning`、`danger`四种通知类型，默认为`danger`

```js
// 主要通知
Notify({ type: 'primary', message: '通知内容' });

// 成功通知
Notify({ type: 'success', message: '通知内容' });

// 危险通知
Notify({ type: 'danger', message: '通知内容' });

// 警告通知
Notify({ type: 'warning', message: '通知内容' });
```

### 自定义通知

自定义消息通知的颜色和展示时长

```js
Notify({
  message: '自定义颜色',
  color: '#ad0000',
  background: '#ffe1e1',
});

Notify({
  message: '自定义时长',
  duration: 1000,
});
```

### 自定义选择器

```js
Notify({
  message: '自定义节点选择器',
  duration: 1000,
  selector: '#custom-selector',
});
```

```html
<!-- 在页面内添加自定义节点 -->
<van-notify id="custom-selector" />
```

## API
### 注:属性应用在组件上需要统一使用驼峰式命名，如custom-class应变为
```html
<van-button type="primary" customClass='myClass' size="large">大号按钮</van-button>
```
### 注:事件应用在组件上需要统一使用驼峰式命名，如bind:click/bind:search/bind:before-enter应变为
```html
<van-button type="primary" onClick={()=>this.onClick()}>大号按钮</van-button>
<van-search type="primary" onSearch={()=>this.onSearch()}>大号按钮</van-search>
<van-transition type="primary" onBeforeEnter={()=>this.onBeforeEnter()}>大号按钮</van-transition>
```
### 方法

| 方法名       | 说明     | 参数                | 返回值      |
| ------------ | -------- | ------------------- | ----------- |
| Notify       | 展示提示 | `options | message` | notify 实例 |
| Notify.clear | 关闭提示 | `options`           | `void`      |

### Options

| 参数 | 说明 | 类型 | 默认值 | 版本 |
| --- | --- | --- | --- | --- |
| type | 类型，可选值为 `primary` `success` `warning` | _string_ | `danger` | 1.0.0 |
| message | 展示文案，支持通过`\n`换行 | _string_ | 1.0.0 | - |
| duration | 展示时长(ms)，值为 0 时，notify 不会消失 | _number_ | `3000` | - |
| selector | 自定义节点选择器 | _string_ | `van-notify` | - |
| color | 字体颜色 | _string_ | `#fff` | - |
| top | 顶部距离 | _number_ | `0` | - |
| background | 背景颜色 | _string_ | - | - |
| context | 选择器的选择范围，可以传入自定义组件的 this 作为上下文 | _object_ | 当前页面 | - |
| onClick | 点击时的回调函数 | _Function_ | - | - |
| onOpened | 完全展示后的回调函数 | _Function_ | - | - |
| onClose | 关闭时的回调函数 | _Function_ | - | - |
| safeAreaInsetTop | 是否留出顶部安全距离（状态栏高度） | _boolean_ | `false` | - |