ng-ytl-zorro-antd
Version:
An enterprise-class UI components based on Ant Design and Angular
157 lines (154 loc) • 5.68 kB
HTML
<article>
<section class="markdown">
<h1>Message 全局提示</h1>
<section class="markdown"><p>全局展示操作反馈信息。</p>
<h2><span>何时使用</span>
<a class="anchor">#</a>
</h2>
<ul>
<li><p>可提供成功、警告和错误等反馈信息。</p></li>
<li><p>顶部居中显示并自动消失,是一种不打断用户操作的轻量级提示方式。</p></li>
</ul>
<h2 id="如何使用">
<span>如何使用</span>
<!-- <a class="anchor">#</a> -->
</h2>
<p>如果要修改message的默认配置,你可以设置提供商<code>NZ_MESSAGE_CONFIG</code>的值来修改。
<p>(如:在你的模块的providers中加入 <code>{{ '{' }} provide: NZ_MESSAGE_CONFIG, useValue: {{ '{' }} nzDuration: 3000 {{ '}' }} {{ '}' }}</code>,<code>NZ_MESSAGE_CONFIG</code>可以从<code>ng-zorro-antd</code>导入)</p>
<p>默认配置为</p>
<pre style="font-size:12px;"> {{ '{' }}
nzDuration : 1500,
nzMaxStack : 7,
nzPauseOnHover : true,
nzAnimate : true
{{ '}' }}</pre>
</section>
<h2>代码演示<i class="code-box-expand-trigger anticon anticon-appstore" title="展开全部代码"></i>
</h2></section>
<div nz-row [nzGutter]="8">
<div nz-col [nzSpan]="12">
<nz-code-box [nzTitle]="'普通提示'" id="components-message-demo-basic" [nzCode]="NzDemoMessageBasicCode">
<nz-demo-message-basic demo></nz-demo-message-basic>
<div intro>
<p>信息提醒反馈。</p>
</div>
</nz-code-box>
<nz-code-box [nzTitle]="'自定义时长提示'" id="components-message-demo-duration" [nzCode]="NzDemoMessageDurationCode">
<nz-demo-message-duration demo></nz-demo-message-duration>
<div intro>
<p>自定义时长 <code>10s</code>,默认时长为 <code>1.5s</code>。</p>
</div>
</nz-code-box>
</div>
<div nz-col [nzSpan]="12">
<nz-code-box [nzTitle]="'其他提示类型'" id="components-message-demo-icon" [nzCode]="NzDemoMessageIconCode">
<nz-demo-message-icon demo></nz-demo-message-icon>
<div intro>
<p>包括成功、失败、警告。</p>
</div>
</nz-code-box>
<nz-code-box [nzTitle]="'加载中'" id="components-message-demo-loading" [nzCode]="NzDemoMessageLoadingCode">
<nz-demo-message-loading demo></nz-demo-message-loading>
<div intro>
<p>进行全局 loading,异步自行移除。</p>
</div>
</nz-code-box>
</div>
</div>
<section class="markdown api-container">
<h2 id="API">
<span>API</span>
<!-- <a class="anchor">#</a> -->
</h2>
<h4><span>全局配置(NZ_MESSAGE_CONFIG)</span><!-- <a class="anchor">#</a> --></h4>
<table>
<thead>
<tr>
<th>参数</th>
<th>类型</th>
<th>默认值</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>nzDuration</td>
<td>Number</td>
<td>0</td>
<td>持续时间,当设置为0时不消失(可用于NzNotificationService中)</td>
</tr>
<tr>
<td>nzMaxStack</td>
<td>Number</td>
<td>8</td>
<td>可展示的最大提示数量</td>
</tr>
<tr>
<td>nzPauseOnHover</td>
<td>Boolean</td>
<td>true</td>
<td>鼠标移上时暂停倒计时(可用于NzNotificationService中)</td>
</tr>
<tr>
<td>nzAnimate</td>
<td>Boolean</td>
<td>true</td>
<td>开关动画效果(可用于NzNotificationService中)</td>
</tr>
</tbody>
</table>
<h4><span>NzMessageService服务</span><!-- <a class="anchor">#</a> --></h4>
<p>提示:以下options参数支持全局配置中的 <code>nzDuration/nzAnimate/nzPauseOnHover</code></p>
<table>
<thead>
<tr>
<th>方法</th>
<th>参数</th>
<th>说明</th>
</tr>
</thead>
<tbody>
<tr>
<td>loading</td>
<td><code>(content: string, options?: Object)</code></td>
<td>加载中</td>
</tr>
<tr>
<td>success</td>
<td><code>(content: string, options?: Object)</code></td>
<td>成功消息</td>
</tr>
<tr>
<td>error</td>
<td><code>(content: string, options?: Object)</code></td>
<td>失败消息</td>
</tr>
<tr>
<td>warning</td>
<td><code>(content: string, options?: Object)</code></td>
<td>警告消息</td>
</tr>
<tr>
<td>info</td>
<td><code>(content: string, options?: Object)</code></td>
<td>信息消息</td>
</tr>
<tr>
<td>create</td>
<td><code>(type: string, content: string, options?: Object)</code></td>
<td>提供type属性,可传入'success'等选项</td>
</tr>
<tr>
<td>html</td>
<td><code>(html: string, options?: Object)</code></td>
<td>可使用html代码来渲染内容</td>
</tr>
<tr>
<td>remove</td>
<td><code>(id?: string)</code></td>
<td>移除特定id的消息,当id为空时,移除所有消息</td>
</tr>
</tbody>
</table>
</section>
</article>