siftal
Version:
CSS Framework, not bad ;)
43 lines (29 loc) • 2.24 kB
Markdown
نمایش اطلاع
===
این ماژول وظیفه نمایش یک عنصر به عنوان اطلاع یا Notification را دارد که پس از مدت زمانی حذف میشود.
نحوه کار
این اطلاعها در عنصری با آیدی `formError` قرار میگیرند.
با اجرای این ماژول رویداد `notify:before` با شی آرگومان روی پنجره اجرا میشود.
سپس در صورتی که مقدار آرگومان اول این تابع مقدار `false` باشد اطلاعهایی که در حال حاظر باز هستند حذف میشوند و رویدادهای `notify:close:force` و `notify:done` اجرا میشوند. در غیر این صورت اطلاع نمایش داده میشود و رویداد `notify:shown` جرقه میخورد.
پس از قرار دادن محتویات مورد نظر در اطلاع رویداد `notify:html` اجرا میشود.
در صورتی که اطلاع بعد از اتمام زمان مورد نظر بسته شود، رویداد `notify:close:timeout` و در صورتی که با کلیک بسته شود، رویداد `notify:close:click` جرقه میخورد.
استفاده
برای استفاده از این ماژول شما باید HTML مورد نظر در صورت نیاز، و یا متنی ساده در صورت نبود نیاز به این تابع بدهید:
```javascript
notify({
html: '<ul>...</ul>',
// text: 'Hi',
sticky: false,
delay: 7000
});
```
######html
مقدار این مشخصه به عنوان HTML به عنصر دربرگیرنده یا `#formError` اضافه میشود.
######text
در صورتی که مشخصه `html` تعیین نشده باشد، مقدار این مشخصه در یک عنصر `p` داخل اطلاع قرار میگیرد.
######delay
این مشخصه تعیین میکند که اطلاع پس از چند میلیثانیه از صفحه محو شود.
######sticky
در صورت مثبت بودن این مشخصه اطلاع تا زمانی که روی آن کلیک نشود از صفحه حذف نمیشود.