blockly > IFocusableNode > getFocusableElement

השיטה IFocusableNode.getFocusableElement()‎

מחזירה את רכיב ה-DOM שאפשר לבקש במפורש להעביר אליו את המיקוד.

חשוב: הרכיב הזה אמור להיות גלוי בדף, כי הוא יקבל פוקוס באופן מפורש והסגנון שלו ישתנה בהתאם למצב הפוקוס הנוכחי שלו (כלומר, מטושטש, בפוקוס פעיל ובפוקוס פסיבי). לאלמנט יצורף אחד משני סגנונות (אם לא מצורף סגנון, המשמעות היא שהאלמנט מטושטש או לא בפוקוס): - blocklyActiveFocus - blocklyPassiveFocus

לאלמנט שמוחזר צריך להיות גם מזהה תקין, והמזהה הזה צריך להיות ייחודי בכל הדף. אם לא מקצים מזהה ייחודי כמו שצריך, יכול להיות שתנסו להתמקד בצומת אחד (למשל באמצעות קליק בעכבר) אבל בפועל תתמקדו בצומת אחר עם אותו מזהה באמצעות FocusManager.

האלמנט שמוחזר חייב להיות גלוי אם הצומת מתמקד אי פעם באמצעות FocusManager.focusNode()‎ או FocusManager.focusTree()‎. מותר להסתיר אלמנט עד שמתבצעת קריאה ל-onNodeFocus()‎, או להסתיר אותו באמצעות קריאה ל-onNodeBlur()‎.

צפוי שהרכיב שמוחזר בפועל לא ישתנה במהלך חיי הצומת (כלומר, המאפיינים שלו יכולים להשתנות, אבל אף פעם לא יוחזר רכיב חדש). בנוסף, הערך של tabindex של הרכיב שמוחזר ייכתב מחדש לאורך מחזור החיים של הצומת הזה ושל FocusManager.

אם צריך להגדיר מיקוד ישיר לצומת בלי להגדיר קודם מיקוד דרך FocusManager, צריך להגדיר לצומת את אינדקס ה-Tab שלו.

Signature:

getFocusableElement(): HTMLElement | SVGElement;

החזרות:

HTMLElement | SVGElement

רכיב HTMLElement או SVGElement שיכול לקבל מיקוד ולהיות מיוצג חזותית כרכיב ממוקד באופן פעיל או פסיבי עבור הצומת הזה.