این راهنما بر نحوه استفاده از ناوبری صفحه کلید پیش فرض همانطور که در حال حاضر در Blockly پیاده سازی شده است تمرکز دارد.
با استفاده از پیمایش صفحه کلید
برای موفقیت ناوبری صفحه کلید، کاربر باید بتواند وظایف زیر را انجام دهد:
- در محیط کار حرکت کنید
- بلوک ها را در یک فضای کاری وصل کنید
- یک بلوک به فضای کاری اضافه کنید
- بلوک ها را جدا کنید
- در جعبه ابزار حرکت کنید
- در flyout حرکت کنید
- بلوک ها را از فلای اوت وارد کنید
در زیر توضیح داده می شود که چگونه پیمایش صفحه کلید پیش فرض Blockly این وظایف را انجام می دهد.
فعال کردن پیمایش صفحه کلید
کاربر می تواند با زدن Shift + Ctrl + k، ناوبری صفحه کلید را فعال و غیرفعال کند. هنگامی که ناوبری صفحه کلید برای اولین بار فعال می شود، یک خط قرمز چشمک زن در فضای کاری ظاهر می شود. این مکان نما است. مکان فعلی کاربر و بهروزرسانیها را در حین حرکت کاربر در فضای کاری نشان میدهد.
با زدن Enter یک خط آبی در مکان فعلی ایجاد می شود که نشانگر کاربر را نشان می دهد. یک نشانگر مکان هدف را برای درج بلوک نشان می دهد. با حرکت مکان نما در محیط کار، به روز نمی شود.
با استفاده از مکان نما پیش فرض
فضای کاری از ورودی ها، فیلدها، اتصالات، بلوک ها و مختصات فضای کاری تشکیل شده است. مکاننمای پیشفرض با تقسیم تمام اجزاء به سطوح مختلف در محیط کار حرکت میکند.
برای پیمایش بین سطوح از کلیدهای A و D استفاده کنید. برای حرکت در یک سطح از کلیدهای W و S استفاده کنید.
سطح فضای کاری
با زدن Shift + Ctrl + k وارد حالت ناوبری صفحه کلید شوید. این مکان نما را در فضای کاری یا در اولین بلوک در فضای کاری قرار می دهد. اگر مکان نما روی یک بلوک است، آن را با دو بار فشار دادن A به سطح فضای کاری منتقل کنید. برای حرکت مکان نما در فضای کاری از Shift + WASD استفاده کنید. برای حرکت به سطح پشته از کلید D استفاده کنید.
سطح پشته
در سطح پشته میتوانید با استفاده از کلیدهای W و S بین پشتههای بلوکها در فضای کاری حرکت کنید. در این سطح مکان نما با یک مستطیل قرمز رنگ در اطراف همه بلوک های یک پشته نشان داده می شود. برای رفتن به اولین بلوک در پشته انتخاب شده از کلید D استفاده کنید.
سطح بلوک و اتصالات
این سطح یک بلوک و تمام اتصالات بیرونی بلوک را نگه می دارد. مکان نما پیش فرض تنظیم شده است که در صورت وجود اتصال قبلی یا خروجی، بلوک را رد کند. اگر هیچکدام وجود نداشته باشند، مکان نما مانند شکل زیر به بلوک منتقل می شود.
سه اتصال خارجی ممکن در زیر نشان داده شده است.
در سطح بلوک و اتصال می توانید با استفاده از کلیدهای W و S از طریق اتصالات بیرونی حرکت کنید. در این سطح مکان نما با یک طرح قرمز چشمک زن از اتصال فعلی نشان داده می شود. برای رفتن به اولین فیلد یا ورودی یک بلوک، D را فشار دهید.
فیلدها و سطح ورودی
این سطح تمام فیلدها و ورودی هایی را که روی بلوک هستند را در خود جای می دهد. نمونه هایی از شکل ظاهری فیلدها و ورودی ها در زیر نشان داده شده است.
در این سطح میتوانید با W و S در میان فیلدها و ورودیهای قابل ویرایش بلوک فعلی حرکت کنید. برای یک میدان، مکان نما یک مستطیل قرمز رنگ است. برای ورودی، مکان نما یک قطعه پازل قرمز چشمک زن است. وقتی مکان نما روی یک ورودی است ، D را فشار دهید تا به بلوک متصل بروید.
وقتی مکان نما روی یک فیلد است، Enter را فشار دهید تا آن را ویرایش کنید.
اتصال بلوک ها در فضای کاری
- با استفاده از کلیدهای WASD به اتصال هدف خود بروید
- اتصال را با استفاده از کلید Enter علامت گذاری کنید
- با استفاده از کلیدهای WASD به یک نقطه اتصال معتبر بروید
- دو بلوک را با استفاده از کلید I (برای درج) وصل کنید
حرکت یک بلوک در فضای کاری
به طور معمول در Blockly شما یک بلوک را با برداشتن آن، کشیدن آن به موقعیت مورد نظر و رها کردن آن به فضای کاری منتقل می کنید. با میانبرهای صفحه کلید، مکان مورد نظر خود را علامت گذاری می کنید، به بلوکی که می خواهید منتقل کنید بروید و سپس به آن بگویید که حرکت کند.
- با استفاده از کلیدهای Shift + WASD به یک موقعیت در فضای کاری بروید
- با استفاده از کلید Enter آن مکان را در فضای کاری علامت گذاری کنید
- با استفاده از کلیدهای WASD به بلوکی که می خواهید جابجا کنید بروید
- با استفاده از کلید I بلوک را به محل مشخص شده منتقل کنید
جدا کردن بلوک ها
به طور معمول در Blockly شما دو بلوک را با برداشتن بلوک پایین تر و دور کردن آن از بلوک والد جدا می کنید. با میانبرهای صفحه کلید، بلوک ها را با فشار دادن X با مکان نما روی اتصالی که می خواهید قطع کنید، جدا می کنید.
- با استفاده از کلیدهای WASD به اتصالی که می خواهید قطع کنید بروید
- ارتباط با X را قطع کنید
درج یک بلوک از جعبه ابزار
- کلید T را فشار دهید تا جعبه ابزار باز شود
- از کلیدهای W & S برای حرکت در دسته ها استفاده کنید
- کلید D را فشار دهید تا به بلوک های موجود در پرواز بروید
- با استفاده از کلیدهای W & S در میان بلوک ها حرکت کنید
- کلید Enter را فشار دهید تا یک بلوک از فلای اوت وارد شود
آزمایش
ما معتقدیم چهار زمینه اصلی وجود دارد که افراد ممکن است علاقه مند به آزمایش با آنها باشند:
- نگاشت کلید : چه کلیدهایی باید به چه اقداماتی نگاشت شوند.
- متن برای صفحهخوانها/ ثبتنام/هشدارها : چگونه یک صفحهخوان باید مکانهای مکاننما و همچنین هرگونه خطا یا هشدار را بخواند.
- ناوبری فضای کاری : چگونه کاربر در بلوکها، فیلدها، ورودیها و اتصالات مختلف در فضای کاری پیمایش میکند.
- ظاهر مکان نما : مکان نما و نشانگر چگونه باید باشند.
برای اطلاعات بیشتر در مورد نحوه استفاده از این APIها، لطفاً به آزمایشگاه کد ناوبری صفحه کلید Blockly نگاه کنید.
اگر زمینه های دیگری دارید که می خواهید آن را آزمایش کنید که ممکن است بتوانیم در آن کمک کنیم، لطفاً فرم را پر کنید.
سوالات متداول
س: چرا از کلیدهای پیکان برای پیمایش صفحه کلید استفاده نکردید؟
A: صفحه خوان ها معمولا از کلیدهای جهت دار استفاده می کنند. ما نمی خواستیم در این مورد دخالت کنیم و بنابراین استفاده از کلیدهای WASD را انتخاب کردیم.
با این حال، ما می دانیم که همه نیازهای متفاوتی دارند و بنابراین ما به شدت توصیه می کنیم یک راه آسان برای تغییر نگاشت کلید ایجاد کنید.
س: به نظر بسیار پیچیده است، چرا به لایه های مختلف نیاز داریم؟
پاسخ: هنگامی که به ناوبری صفحه کلید فکر میکردیم، به روشی ساختاریافته برای حرکت در بلوکها، اتصالات، فیلدها، ورودیها و مختصات فضای کاری مختلف نیاز داشتیم.
در داخل ما این را با یک درخت نحو انتزاعی (AST) نشان می دهیم. پیادهسازی مکاننمای پیشفرض از این مدل دور نمیشود. این عمدی است تا به توسعهدهندگان درک بهتری از معماری زیربنایی بدهد. مکان نماهای دیگری نیز وجود دارند که درک آنها برای کاربر نهایی آسان تر است.
محدودیت ها
ما هنوز از پیمایش به اجزای غیر مسدود (مانند سطل زباله، دکمههای زوم، و دکمههای فلای اوت) پشتیبانی نمیکنیم. برای کسب اطلاعات بیشتر در مورد محدودیتها، لطفاً لیست اشکالات پیمایش صفحه کلید باز را ببینید.