ناوبری صفحه کلید

این راهنما بر نحوه استفاده از ناوبری صفحه کلید پیش فرض همانطور که در حال حاضر در Blockly پیاده سازی شده است تمرکز دارد.

با استفاده از پیمایش صفحه کلید

برای موفقیت ناوبری صفحه کلید، کاربر باید بتواند وظایف زیر را انجام دهد:

  • در محیط کار حرکت کنید
  • بلوک ها را در یک فضای کاری وصل کنید
  • یک بلوک به فضای کاری اضافه کنید
  • بلوک ها را جدا کنید
  • در جعبه ابزار حرکت کنید
  • در flyout حرکت کنید
  • بلوک ها را از فلای اوت وارد کنید

در زیر توضیح داده می شود که چگونه پیمایش صفحه کلید پیش فرض Blockly این وظایف را انجام می دهد.

فعال کردن پیمایش صفحه کلید

کاربر می تواند با زدن Shift + Ctrl + k، ناوبری صفحه کلید را فعال و غیرفعال کند. هنگامی که ناوبری صفحه کلید برای اولین بار فعال می شود، یک خط قرمز چشمک زن در فضای کاری ظاهر می شود. این مکان نما است. مکان فعلی کاربر و به‌روزرسانی‌ها را در حین حرکت کاربر در فضای کاری نشان می‌دهد.
هنگامی که کاربر کلید شیفت k را می زند، یک خط قرمز چشمک زن روی صفحه ظاهر می شود. این مکان نما است.

با زدن Enter یک خط آبی در مکان فعلی ایجاد می شود که نشانگر کاربر را نشان می دهد. یک نشانگر مکان هدف را برای درج بلوک نشان می دهد. با حرکت مکان نما در محیط کار، به روز نمی شود.
وقتی کاربر Enter را می‌زند، یک خط آبی روی صفحه ظاهر می‌شود. این نشانگر است.

با استفاده از مکان نما پیش فرض

فضای کاری از ورودی ها، فیلدها، اتصالات، بلوک ها و مختصات فضای کاری تشکیل شده است. مکان‌نمای پیش‌فرض با تقسیم تمام اجزاء به سطوح مختلف در محیط کار حرکت می‌کند.

برای پیمایش بین سطوح از کلیدهای A و D استفاده کنید. برای حرکت در یک سطح از کلیدهای W و S استفاده کنید.

سطح فضای کاری

با زدن Shift + Ctrl + k وارد حالت ناوبری صفحه کلید شوید. این مکان نما را در فضای کاری یا در اولین بلوک در فضای کاری قرار می دهد. اگر مکان نما روی یک بلوک است، آن را با دو بار فشار دادن A به سطح فضای کاری منتقل کنید. برای حرکت مکان نما در فضای کاری از Shift + WASD استفاده کنید. برای حرکت به سطح پشته از کلید D استفاده کنید.
هنگامی که کاربر کلیدهای Shift و W A S D را فشار می دهد، مکان نما در فضای کاری بلوک حرکت می کند. هنگامی که کاربر به d ضربه می زند، مکان نما به صورت یک مستطیل در اطراف اولین پشته بلوک ها ظاهر می شود

سطح پشته

در سطح پشته می‌توانید با استفاده از کلیدهای W و S بین پشته‌های بلوک‌ها در فضای کاری حرکت کنید. در این سطح مکان نما با یک مستطیل قرمز رنگ در اطراف همه بلوک های یک پشته نشان داده می شود. برای رفتن به اولین بلوک در پشته انتخاب شده از کلید D استفاده کنید.
وقتی کاربر s را فشار می دهد مکان نما به پشته بعدی بلوک ها حرکت می کند. هنگامی که کاربر d را می زند، مکان نما به صورت یک خط قرمز چشمک زن در بالای اولین بلوک در پشته انتخاب شده ظاهر می شود.

سطح بلوک و اتصالات

این سطح یک بلوک و تمام اتصالات بیرونی بلوک را نگه می دارد. مکان نما پیش فرض تنظیم شده است که در صورت وجود اتصال قبلی یا خروجی، بلوک را رد کند. اگر هیچکدام وجود نداشته باشند، مکان نما مانند شکل زیر به بلوک منتقل می شود.

هنگامی که کاربر d را فشار می دهد، مکان نما از یک مستطیل قرمز در اطراف پشته بلوک ها به نیمی از مستطیلی که اولین بلوک در پشته را احاطه کرده است، حرکت می کند.

سه اتصال خارجی ممکن در زیر نشان داده شده است.
یک خط قرمز سه اتصال خارجی ممکن را برجسته می کند. اینها اتصالات قبلی، بعدی و خروجی روی یک بلوک هستند.

در سطح بلوک و اتصال می توانید با استفاده از کلیدهای W و S از طریق اتصالات بیرونی حرکت کنید. در این سطح مکان نما با یک طرح قرمز چشمک زن از اتصال فعلی نشان داده می شود. برای رفتن به اولین فیلد یا ورودی یک بلوک، D را فشار دهید.
هنگامی که کاربر کلید S را فشار می دهد، مکان نما به صورت یک خط چشمک زن قرمز در اتصال بعدی یک بلوک ظاهر می شود. هنگامی که کاربر کلید d را فشار می دهد مکان نما به صورت یک مستطیل قرمز در اطراف اولین فیلد روی بلوک ظاهر می شود.

فیلدها و سطح ورودی

این سطح تمام فیلدها و ورودی هایی را که روی بلوک هستند را در خود جای می دهد. نمونه هایی از شکل ظاهری فیلدها و ورودی ها در زیر نشان داده شده است.
یک مستطیل قرمز نمونه هایی از ورودی ها و فیلدهای یک بلوک را برجسته می کند.
در این سطح می‌توانید با W و S در میان فیلدها و ورودی‌های قابل ویرایش بلوک فعلی حرکت کنید. برای یک میدان، مکان نما یک مستطیل قرمز رنگ است. برای ورودی، مکان نما یک قطعه پازل قرمز چشمک زن است. وقتی مکان نما روی یک ورودی است ، D را فشار دهید تا به بلوک متصل بروید.

وقتی کاربر کلید S را می‌زند، مکان‌نما در ورودی‌ها و فیلدهای بلوک حرکت می‌کند. هنگامی که کاربر در حالی که در ورودی با بلوک متصل است، d را می زند، مکان نما به صورت یک خط قرمز چشمک زن در بالای بلوک متصل ظاهر می شود.

وقتی مکان نما روی یک فیلد است، Enter را فشار دهید تا آن را ویرایش کنید.

مکان نما به صورت یک مستطیل قرمز در اطراف یک میدان نمایش داده می شود. وقتی کاربر Enter را می‌زند، یک منوی کشویی باز می‌شود. کاربر کلید S را می‌زند تا مقداری را در منوی بازشو انتخاب کند و سپس enter را می‌زند تا بازشو بسته شود.

اتصال بلوک ها در فضای کاری

  1. با استفاده از کلیدهای WASD به اتصال هدف خود بروید
  2. اتصال را با استفاده از کلید Enter علامت گذاری کنید
  3. با استفاده از کلیدهای WASD به یک نقطه اتصال معتبر بروید
  4. دو بلوک را با استفاده از کلید I (برای درج) وصل کنید

یک اتصال ورودی دارای یک نقطه آبی است که نشان می دهد علامت گذاری شده است. وقتی کاربر i را در یک اتصال معتبر می‌زند، بلوک به نقطه اتصال علامت‌گذاری شده منتقل می‌شود.

حرکت یک بلوک در فضای کاری

به طور معمول در Blockly شما یک بلوک را با برداشتن آن، کشیدن آن به موقعیت مورد نظر و رها کردن آن به فضای کاری منتقل می کنید. با میانبرهای صفحه کلید، مکان مورد نظر خود را علامت گذاری می کنید، به بلوکی که می خواهید منتقل کنید بروید و سپس به آن بگویید که حرکت کند.

  1. با استفاده از کلیدهای Shift + WASD به یک موقعیت در فضای کاری بروید
  2. با استفاده از کلید Enter آن مکان را در فضای کاری علامت گذاری کنید
  3. با استفاده از کلیدهای WASD به بلوکی که می خواهید جابجا کنید بروید
  4. با استفاده از کلید I بلوک را به محل مشخص شده منتقل کنید

یک مکان نما در فضای کاری بلوک نشان داده می شود. هنگامی که کاربر اینتر را می زند، مکان خود را علامت گذاری می کند و یک خط آبی در این موقعیت ظاهر می شود. با استفاده از کلیدهای WASD مکان نما را به اتصال بیرونی یک بلوک منتقل می کنند. وقتی کاربر i را می‌زند، بلوک به محل علامت‌گذاری شده منتقل می‌شود.

جدا کردن بلوک ها

به طور معمول در Blockly شما دو بلوک را با برداشتن بلوک پایین تر و دور کردن آن از بلوک والد جدا می کنید. با میانبرهای صفحه کلید، بلوک ها را با فشار دادن X با مکان نما روی اتصالی که می خواهید قطع کنید، جدا می کنید.

  1. با استفاده از کلیدهای WASD به اتصالی که می خواهید قطع کنید بروید
  2. ارتباط با X را قطع کنید

دو بلوک روی صفحه نمایش با مکان نما نشان داده شده در وسط آنها به هم متصل می شوند. وقتی کاربر کلید x را می‌زند، بلوک‌ها قطع می‌شوند.

درج یک بلوک از جعبه ابزار

  1. کلید T را فشار دهید تا جعبه ابزار باز شود
  2. از کلیدهای W & S برای حرکت در دسته ها استفاده کنید
  3. کلید D را فشار دهید تا به بلوک های موجود در پرواز بروید
  4. با استفاده از کلیدهای W & S در میان بلوک ها حرکت کنید
  5. کلید Enter را فشار دهید تا یک بلوک از فلای اوت وارد شود

وقتی کاربر t را فشار می دهد جعبه ابزاری باز می شود که دسته های مختلف بلوک ها را نشان می دهد. ضربه زدن به دسته های مختلف حرکت می کند. وقتی کاربر d را می‌زند، اولین بلوک در دسته برجسته می‌شود. با زدن Enter بلوک در فضای کاری قرار می گیرد و جعبه ابزار بسته می شود.

آزمایش

ما معتقدیم چهار زمینه اصلی وجود دارد که افراد ممکن است علاقه مند به آزمایش با آنها باشند:

  1. نگاشت کلید : چه کلیدهایی باید به چه اقداماتی نگاشت شوند.
  2. متن برای صفحه‌خوان‌ها/ ثبت‌نام/هشدارها : چگونه یک صفحه‌خوان باید مکان‌های مکان‌نما و همچنین هرگونه خطا یا هشدار را بخواند.
  3. ناوبری فضای کاری : چگونه کاربر در بلوک‌ها، فیلدها، ورودی‌ها و اتصالات مختلف در فضای کاری پیمایش می‌کند.
  4. ظاهر مکان نما : مکان نما و نشانگر چگونه باید باشند.

برای اطلاعات بیشتر در مورد نحوه استفاده از این APIها، لطفاً به آزمایشگاه کد ناوبری صفحه کلید Blockly نگاه کنید.

اگر زمینه های دیگری دارید که می خواهید آن را آزمایش کنید که ممکن است بتوانیم در آن کمک کنیم، لطفاً فرم را پر کنید.

سوالات متداول

س: چرا از کلیدهای پیکان برای پیمایش صفحه کلید استفاده نکردید؟
A: صفحه خوان ها معمولا از کلیدهای جهت دار استفاده می کنند. ما نمی خواستیم در این مورد دخالت کنیم و بنابراین استفاده از کلیدهای WASD را انتخاب کردیم.
با این حال، ما می دانیم که همه نیازهای متفاوتی دارند و بنابراین ما به شدت توصیه می کنیم یک راه آسان برای تغییر نگاشت کلید ایجاد کنید.

س: به نظر بسیار پیچیده است، چرا به لایه های مختلف نیاز داریم؟
پاسخ: هنگامی که به ناوبری صفحه کلید فکر می‌کردیم، به روشی ساختاریافته برای حرکت در بلوک‌ها، اتصالات، فیلدها، ورودی‌ها و مختصات فضای کاری مختلف نیاز داشتیم.
در داخل ما این را با یک درخت نحو انتزاعی (AST) نشان می دهیم. پیاده‌سازی مکان‌نمای پیش‌فرض از این مدل دور نمی‌شود. این عمدی است تا به توسعه‌دهندگان درک بهتری از معماری زیربنایی بدهد. مکان نماهای دیگری نیز وجود دارند که درک آنها برای کاربر نهایی آسان تر است.

محدودیت ها

ما هنوز از پیمایش به اجزای غیر مسدود (مانند سطل زباله، دکمه‌های زوم، و دکمه‌های فلای اوت) پشتیبانی نمی‌کنیم. برای کسب اطلاعات بیشتر در مورد محدودیت‌ها، لطفاً لیست اشکالات پیمایش صفحه کلید باز را ببینید.