Flutter SDK - تتبّع حقول الإدخال

تفاصيل حول تتبّع حقول الإدخال باستخدام أداة تتبّع Flutter

Flutter SDK ⁠-⁠ تتبّع حقول الإدخال

لا تتم مراقبة حقول النص تلقائيًا — إذ لا يمتلك Flutter ما يعادل سلسلة المستجيبين (responder chain) في UIKit للارتباط بها. اربط أداة التتبّع بوحدات التحكم (controllers) التي تهمّك، وستستمع إلى تغيّرات القيمة (مع تأخير debounce) وترسل القيمة الناتجة إلى الواجهة الخلفية لـ OpenReplay.

إضافة حقول إدخال متتبَّعة

Section titled إضافة حقول إدخال متتبَّعة

استخدم observeInput(controller, label:, masked:):

  • controller: TextEditingController — وحدة التحكم المراد مراقبتها
  • label: String — تسمية حقل الإدخال المُسجَّل
  • masked: bool — إذا كانت القيمة true، فستُسجّل أداة التتبّع حدث الإدخال لكنها سترسل **** بدلًا من القيمة. القيمة الافتراضية: false.

تُرجع هذه الطريقة دالة استدعاء (callback) تُزيل المستمع، لذا اربطها بـ dispose():

import 'package:openreplay/openreplay.dart';

class _LoginFormState extends State<LoginForm> {
  final _email = TextEditingController();
  late final VoidCallback _stopObserving;

  @override
  void initState() {
    super.initState();
    _stopObserving = OpenReplay.instance.observeInput(_email, label: 'Email');
  }

  @override
  void dispose() {
    _stopObserving();
    _email.dispose();
    super.dispose();
  }
}

إذا كانت لديك أي أسئلة حول هذه العملية، فلا تتردّد في التواصل معنا عبر Slack أو الاطّلاع على المنتدى الخاص بنا.