blockly > IFocusableNode > getFocusableElement

متد ()IFocusableNode.getFocusableElement

عنصر DOM را که می توان به صراحت برای دریافت فوکوس درخواست کرد، برمی گرداند.

مهم: لطفاً توجه داشته باشید که انتظار می‌رود این عنصر در صفحه حضور بصری داشته باشد، زیرا هم به‌صراحت فوکوس می‌شود و هم سبک آن بسته به حالت فوکوس فعلی آن تغییر می‌کند (یعنی تار، متمرکز فعال، و فوکوس غیرفعال). این عنصر دارای یکی از دو سبک متصل خواهد بود (در جایی که هیچ سبکی نشان‌دهنده تاری/عدم تمرکز است): - blocklyActiveFocus - blocklyPassiveFocus

عنصر برگشتی نیز باید دارای شناسه معتبر مشخص شده باشد و این شناسه باید در کل صفحه منحصر به فرد باشد. نداشتن شناسه منحصربه‌فرد می‌تواند منجر به تلاش برای متمرکز کردن یک گره (مانند با کلیک ماوس) شود که منجر به گره دیگری با همان شناسه در واقع توسط FocusManager شود.

اگر گره از طریق FocusManager.focusNode() یا FocusManager.focusTree() متمرکز شده باشد، عنصر برگشتی باید قابل مشاهده باشد. مجاز است یک عنصر تا فراخوانی ()onNodeFocus مخفی شود یا با فراخوانی onNodeBlur() مخفی شود.

انتظار می رود عنصر بازگشتی واقعی در طول عمر گره تغییر نکند (یعنی ویژگی های آن می تواند تغییر کند اما یک عنصر جدید هرگز نباید برگردانده شود). همچنین، عنصر بازگشتی در طول چرخه عمر این گره و FocusManager، فهرست برگه آن بازنویسی می‌شود.

اگر یک گره نیاز به توانایی فوکوس مستقیم بدون فوکوس شدن از طریق FocusManager داشته باشد، باید فهرست برگه خود را تنظیم کند.

امضا:

getFocusableElement(): HTMLElement | SVGElement;

برمی گرداند:

HTMLElement | SVGElement

HTMLElement یا SVGElement که هم می تواند فوکوس دریافت کند و هم به صورت بصری به صورت فعال یا غیر فعال برای این گره نشان داده شود.