blockly > FocusManager > registerTree
طريقة FocusManager.registerTree()
تسجّل هذه الطريقة IFocusableTree جديدًا لإدارة التركيز التلقائي.
إذا كانت الشجرة تتضمّن حاليًا عنصرًا مع تركيز DOM، لن يؤثّر ذلك في الحالة الداخلية في هذه الأداة إلى أن يتغيّر التركيز إلى عنصر/عقدة جديدة يتم تتبّعها الآن.
تعرض هذه الدالة خطأً إذا كانت الشجرة المقدَّمة مسجَّلة حاليًا في هذا المدير. استخدِم isRegistered للتحقّق في الحالات التي لا يمكن فيها التأكّد مما إذا تم تسجيل الشجرة.
يمكن تخصيص تسجيل الشجرة لضبط مواضع التوقف التلقائي لعلامات التبويب. يوفّر ذلك تحديدًا إمكانية تنقّل المستخدم إلى جذر الشجرة باستخدام مفتاح Tab، ولكن فقط عندما لا تكون الشجرة في وضع التركيز النشط. في حال إيقاف هذه الوظيفة، سيتم تلقائيًا إتاحة التركيز على جذر الشجرة (ولكن ليس باستخدام مفتاح Tab) عند التركيز عليه لأول مرة بالطريقة نفسها التي يتم بها التركيز على أي عقدة أخرى يمكن التركيز عليها.
Signature:
registerTree(tree: IFocusableTree, rootShouldBeAutoTabbable?: boolean): void;
المعلمات
| المَعلمة | النوع | الوصف |
|---|---|---|
| شجرة | IFocusableTree | تمثّل هذه السمة IFocusableTree المطلوب تسجيله. |
| rootShouldBeAutoTabbable | قيمة منطقية | (اختياري) ما إذا كان يجب إضافة جذر هذه الشجرة كعلامة توقّف في علامة التبويب على مستوى أعلى عندما لا يكون التركيز نشطًا. |
المرتجعات:
void