واجهة مستخدم مدونة (YUIBlog)

تحرير النمط السريع ليوي 3 DataTable

على الرغم من يوي 3 DataTable ليس لديها بعد التحرير مضمنة من الخلايا الفردية ، هو بسيط نسبيا لتنفيذ سريع وضع التحرير. و QuickEdit المساعد لDataTable في معرض 3 يوي يتيح لجميع القيم مرئية في DataTable إلى أن تعدل في وقت واحد.

( انقر لقطة للشاشة للعب مع هذا المثال .)

نظرة عامة

كما هو الحال مع نسخة 2 يوي ، الفكرة الأساسية لتحرير النمط السريع لمبادلة خارج كل خلية منسقات بأخرى جديدة الذي ملء الخلايا مع عناصر النموذج ، على سبيل المثال ، حقول الإدخال أو القائمه المنسدله للروابط. ذلك هو عندما start() يسمى ، على أساس التكوين هو موضح أدناه. بعد انتهاء المستخدم ، يمكنك استدعاء getChanges() للحصول على القيم التي تم تغييرها ومن ثم تستمر لهم. للخروج من وضع التحرير السريع ، استدعاء cancel() . (المسمى ومن إلغاء بدلا من وقف لتذكيرك أنه يتجاهل كافة التغييرات.)

منذ التحرير السريع وحدة معرض هو البرنامج المساعد لDataTable ، تحتاج إلى بتوصيله إلى datatable الخاص قبل أن تتمكن من استخدامه :

 my_table.plug (Y.Plugin.DataTableQuickEdit) ؛

يخزن هذا البرنامج المساعد في qe عضو في datatable ، لذا يجب استدعاء المساعد في وظائف من هذا القبيل :

 my_table.qe.start () ؛

التكوين

ويضيف سريعة تحرير اثنين من سمات التكوين الجديد لكافة الأعمدة : quickEdit و qeFormatter .

إذا كان العمود quickEdit تعريف الملكية ، العمود سوف تكون قابلة للتحرير في وضع التحرير السريع. لقبول كافة الإعدادات الافتراضية ، يمكنك ببساطة وضع quickEdit:true . لمزيد من التحكم ، يمكنك تمرير كائن مع الخصائص التالية :

formatter

المنسق الخلية التي سوف تجعل أي حقل النموذج المناسب : type="text"> <input، <textarea>، أو <select>. افتراضيا ، الخلية المنسق Y.Plugin.QuickEdit.textFormatter يستخدم لجميع الخلايا لانتاج عناصر المدخلات. للحصول على textarea عنصر ، تكوين عمود إلى استخدام Y.Plugin.QuickEdit.textareaFormatter بدلا من ذلك.

validation

التحقق من صحة تكوين لكل حقل في العمود.

css

الطبقات المغلق قواعد التحقق من صحة الترميز الأساسية :

yiv-required

يجب أن لا تكون القيمة فارغة.

yiv-length:[x,y]

يجب أن تكون السلسلة على الأقل x حرفا ، وعلى الأكثر y حرفا. واحد على الأقل من العاشر ويجب أن تكون محددة ذ.

yiv-integer:[x,y]

صحيح أن قيمة ويكون ما لا يقل عن x ، وعلى الأكثر y . x و y كلاهما الاختياري.

yiv-decimal:[x,y]

العشرية قيمة ويجب ان تكون على الاقل x وعلى الأكثر y . سمح الدعاة ليسوا كذلك. x و y كلاهما الاختياري.

fn

والدالة التي سوف يطلق مع DataTable ونطاقه وعنصر الخلية شكل كوسيطة. العودة الحقيقية إذا كانت القيمة غير صالحة. خلاف ذلك ، اتصل this.displayMessage(...) لعرض خطأ ثم العودة كاذبة.

msg

خريطة أنواع الرسائل التي سيتم عرضها عندما يكون لقاعدة التحقق من صحة الأساسية أو رجإكس فشل. أنواع الصالحة هي : required ، min_length ، max_length ، integer ، decimal ، و regex . لا يوجد الافتراضي لنوع regex ، لذلك يجب تحديد رسالة إذا قمت بتكوين التحقق من صحة رجإكس. خطأ للرسائل أنواع أخرى المخزنة الافتراضي في Y.FormManager.Strings (التي قدمها ، معرض formmgr التحقق من صحة المغلق ، ويمكن أن يتم تجاوز و / أو المترجمة.

regex

التعبير العادية أن القيمة يجب أن ترضي من أجل أن يعتبر صحيحا.

أحيانا ، لا بد من تقديم عمود غير قابلة للتعديل بشكل مختلف خلال التحرير السريع واسطة. أفضل مثال على ذلك هو عمود تحتوي على وصلة ، منذ التنقل بعيدا عن الصفحة أثناء وجوده في وضع التحرير السريع يمكن أن يكون كارثيا. لإزالة الارتباط خلال تحرير السريع ، تكوين qeFormatter للعمود أن Y.Plugin.QuickEdit.readonlyLinkFormatter . لعناوين البريد الإلكتروني ، واستخدام Y.Plugin.QuickEdit.readonlyEmailFormatter . يمكنك أيضا كتابة لك المخصصة الخاصة ، المنسق للقراءة فقط. ببساطة اتبع القواعد العادية لبناء الخلية المنسق DataTable.

في عداد المفقودين ميزات

بسبب وجود خلل في يوي 3.3.0 DataTable ، و td العنصر التي تم تمريرها إلى المنسق العمود هو في الواقع من العمود السابق. وهذا جعل من مزعجة للغاية لدعم نسخة أسفل ، حيث زر في الصف الأول يتيح لك نسخ قيمة وصولا الى جميع الصفوف الأخرى.

علة يحتاج أيضا إلى إعادة صياغة كاملة للتحرير السريع الأساسية منسقات خلية للعودة النص بدلا من التلاعب دوم. هذا هو لماذا لا منسقات الخلية مخصص معتمد رسميا في هذا الإصدار الأولي. إذا كنت المغامرة ، يمكنك بناء لا يزال لهم ، ولكن نضع في اعتبارنا أن ستحتاج إلى إعادة كتابة عليها ، بما في ذلك إضافة لدعم لنسخة أسفل ، خلل في DataTable يتم إصلاح بمجرد.

نبذة عن الكاتب : جون لندال ( @ jafl5272 على التغريد) هو واحد من المهندسين يؤدي بناء الأساس الذي ياهو! الرابطة بني. سابقا ، كان يعمل في شبكة ياهو الناشر.

العثور على المحادثات : المدونات | ستثمبليوبون

وتوسيع نطاق مشاركة : احفظ مع del.icio.us | يسو أنها! | صديق!