حدث تغيير النص في UITextField: التقاط كل ضغطة بشكل صحيح

تعلم Python بسهولة دون إرهاق نظري. حل مهام عملية مع التحقق التلقائي واكتب الكود مباشرة في المتصفح.

حدث تغيير النص في UITextField: كل حرف مهم

\n\n

تخيل: أنت تكتب تطبيقًا للملاحظات، أو البحث في الكتالوج، أو تطبيق مراسلة. المستخدم بدأ للتو في الكتابة في UITextField، وتحتاج أنت بالفعل إلى الرد — إظهار الاقتراحات، حساب الأحرف المتبقية، أو إرسال طلب إلى الخادم. كيف تلتقط هذه اللحظة بالذات عندما يتغير النص؟ سؤال يقلق المبتدئين وحتى مطوري iOS ذوي الخبرة. على Stack Overflow، موضوع حدث تغيير النص في UITextField حصل على آلاف المشاهدات — وليس بدون سبب.

\n\n

في تطوير iOS، هناك على الأقل ثلاثة طرق عملية. واختيار الطريقة الخاطئة قد يكلفك أخطاء، تسرب ذاكرة، أو 100 سطر إضافي من الكود. اليوم سنقوم بتفصيل جميع طرق تتبع تغيير النص في UITextField: من المفوض الكلاسيكي إلى Combine الحديث. هيا بنا!

\n\n

لماذا لا يكفي مجرد الضغط على زر؟

\n\n

قد يبدو الأمر بسيطًا؟ المستخدم أدخل النص — ضغط على "تم" أو زر "بحث". لكن الواجهات الحديثة تتطلب رد فعل في الوقت الفعلي. إليك السيناريوهات النموذجية:

الإكمال التلقائي (search as you type) — تظهر الاقتراحات مع كل ضغطة مفتاح.
التحقق الفوري — التحقق من البريد الإلكتروني أو رقم الهاتف دون إرسال النموذج.
عداد الأحرف — على سبيل المثال، في تطبيق تويتر تحتاج إلى إظهار عدد الأحرف المتبقية حتى الحد الأقصى.
البحث الديناميكي — تصفية قائمة جهات الاتصال أو المنتجات.

في كل هذه الحالات، نحتاج إلى حدث UITextField text change event. والآن السؤال: كيف ننفذه بشكل صحيح في Swift؟

\n\n

الطريقة 1: مفوض UITextFieldDelegate — الكلاسيكية

\n\n

الطريقة الأكثر وضوحًا، وربما الأكثر شيوعًا. تقوم بتعيين مفوض لحقل النص الخاص بك وتنفيذ الطريقة textField(_:shouldChangeCharactersIn:replacementString:). لكن هناك فارق بسيط: هذه الطريقة تُستدعى قبل أن يتغير النص فعليًا. إنها تسأل: "هل يمكن إدراج هذا الحرف؟"

\n\n

للحصول على النص الفعلي، تحتاج إلى بنائه يدويًا:

\n\n

class ViewController: UIViewController, UITextFieldDelegate {\n    \n    @IBOutlet weak var textField: UITextField!\n    \n    override func viewDidLoad() {\n        super.viewDidLoad()\n        textField.delegate = self\n    }\n    \n    func textField(_ textField: UITextField, shouldChangeCharactersIn range: NSRange, replacementString string: String) -> Bool {\n        let currentText = textField.text ?? ""\n        guard let stringRange = Range(range, in: currentText) else { return false }\n        let updatedText = currentText.replacingCharacters(in: stringRange, with: string)\n        \n        print("النص الجديد: \\(updatedText)")\n        // هنا يمكن تحديث الواجهة أو بدء البحث\n        return true\n    }\n}\n

\n\n

المزايا:

تحكم كامل في الإدخال — يمكن منع إدراج أحرف معينة.
يعمل على جميع إصدارات iOS.

العيوب:

الكود ضخم لمجرد "التقاط التغيير".
تحتاج إلى تذكر NSRange وتحويله إلى Range<String.Index>.
لا يعمل عند تغيير النص برمجيًا مثل textField.text = "نص جديد".

\n\n

هذه الطريقة مناسبة تمامًا إذا كنت بحاجة إلى التحقق من الإدخال (مثل منع الأحرف في حقل رقم الهاتف). لكن لتتبع التغييرات البسيطة، هناك خيارات أكثر أناقة.

\n\n