هي إضافة جي كويري تم تعريبها في الأساس من إضافة أخرى لعرض الوقت و تحديثه تلقائياً في مشاريعك .
يمكنك إستخدام هذه الإضافة في كل صفحاتك التي تقوم ببرمجتها بأي لغة كانت .
يمكنك بكل بساطة إستخدامها عن طريق تحميل الملف الموجود في هذا المستودع و إرفاقه داخل صفحة الويب الخاصة بك على سبيل المثال :
<script src="arabic-timeago.js" type="text/javascript"></script>
إضافتنا ستقوم بتحديث الوقت في كل دقيقة تمر أثناء فتح صفحة الويب الخاصة بك تلقائياً للاوقات الموجودة داخل الصفحة ، لكن هذه ليست القاعدة ، على سبيل المثال إذا كان هناك وقت في صفحتك يشير إلى التالي "منذ ساعتين" في هذه الحالة لن تقوم الإضافة بمحاولة التحديث كل 60 ثانية بل ستقوم بزيادة وقت التحديث إلى 30 دقيقة .
قواعد التحقق من تحديث الوقت :
الوقت في الصفحة من 1 دقيقة إلى 50 دقيقة سيتم تحديثه بفاصل زمني 1 دقيقة .
الوقت في الصفحة من 51 دقيقة إلى 89 دقيقة سيتم تحديثه بفاصل زمني 22 دقيقة .
الوقت في الصفحة من 90 دقيقة إلى 42 ساعة سيتم تحديثه بفاصل زمني 30 دقيقة .
الوقت في الصفحة أكثر من 42 ساعة سيتم تحديثه بفاصل زمني نصف يوم .
من المميزات الأخرى لإضافتنا بعد التعريب أنها تدعم صيغة المثنى ، كمثال إذا كان لديك وقت تريد حسابه و قد مضى عليه دقيقتين أو يومين أو شهرين أو حتى سنتين ستظهر لك بهذه الصورة "منذ دقيقتين" أو "منذ ساعتين" ... بدﻻً من "منذ 2 دقائق" أو "منذ 2 ساعات" ، أيضاً إضافتنا تدعم قواعد اللغة العربية كمثال إضافتنا تقوم بكتابة "منذ 15 ساعة" بدﻻً من "منذ 15 ساعات" و هذا شيء جديد كلياً في هذه الإضافة .
إستخدام الإضافة سهل جداً ، بعد إرفاق ملف الإضافة في صفحتك قم بإضافة وسم الوقت كالتالي :
<time class="timeago" datetime="2015-03-06 07:51:50 Z"></time>
`datetime` | مع إمكانية تغيير خاصية الوقت و التاريخ بالوقت الذي تريد
بعد إضافة وسم الوقت ولكي تعمل الإضافة يجب إضافة كود جافا سكريبت إلى نهاية وسم جسم الصفحة كالتالي :
<body>
<!-- code here -->
<script>
$('.timeago').timeago();
</script>
</body>
بهذا الشكل سيتم تحديث كل الأوقات الموجودة في صفحتك .
غير ذلك يمكنك تحديث الوقت في مجال معين كالتالي :
<div class="timeLables">
<time class="timeago" datetime="2015-03-06 07:51:50 Z"></time>
<time class="timeago" datetime="2015-03-06 07:51:50 Z"></time>
</div>
$('.timeLables').timeago();
بهذا الشكل سيقوم بتحديث الوقت الموجود داخل المجال `timeLables`
أما إذا كنت تحتاج إلى تحديث الوقت بشكل يدوي يمكنك إستخدام الدالة `refresh`
$('.timeago').timeago('refresh');
يمكنك إستخدام هذه الإضافة مع إطار عمل روبي أون ريلز بشكل سهل كالتالي :
- قم بإرفاق الملف الموجود في هذا المستودع مع تطبيق روبي أون ريلز الخاص بك
- قم بالإشارة إلى الملف في ملف الجافا سكريبت الأساسي الخاص بتطبيقك كالتالي
//= require arabic-timeago // for .js
or
#= require arabic-timeago // for .coffee
- قم بإضافة وسم الوقت عن طريق دوال روبي أون ريلز المساعدة في صفحات الويب الخاصة بك كالتالي
<%= content_tag :time, '', class: 'timeago', datetime: "2015-04-11 13:00:00 Z" %>
- قم بإضافة كود الجافا سكريبت إلى نهاية وسم جسم الصفحة كالتالي
<body>
<!-- code here -->
<script>
$('.timeago').timeago();
</script>
</body>
يمكنك رؤية هذا المثال والذي يوضح كيفية إستخدام هذه الإضافة .
Released under the MIT License
smart-time-ago License
Copyright (c) 2015 AliOsm
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent