رفتارهای پویا با پارامترها

پارامترها بلوک اصلی ساخت و ساز در دستور زبان تعامل Vega-Lite هستند. پارامترها می توانند متغیرهای ساده یا انتخاب های پیچیده تری باشند که ورودی کاربر (به عنوان مثال ، کلیک ماوس و کشیدن) را به نمایش داده های داده نقشه می کند. پارامترها را می توان در طول باقیمانده مشخصات نمودار برای تعیین قوانین رمزگذاری ، نقاط داده فیلتر ، تعیین میزان داده ها یا در رشته های بیان استفاده کرد. آنها همچنین می توانند به صورت اختیاری به ابزارک های ورودی (به عنوان مثال ، کشویی یا منوهای کشویی) محدود شوند.

بررسی اجمالی مستندات

تعریف یک پارامتر

هر دو پارامتر متغیر و انتخاب از خصوصیات زیر پشتیبانی می کنند:

ضروری. یک نام منحصر به فرد برای پارامتر متغیر. نام پارامترها باید شناسه های JavaScript معتبر باشند: آنها فقط باید دارای شخصیت های الفبایی (یا "$" یا "_") باشند و ممکن است با یک رقم شروع نشوند. کلمات کلیدی رزرو شده که ممکن است به عنوان نام پارامترها مورد استفاده قرار نگیرد عبارتند از "Datum" ، "Event" ، "Attem" و "والدین".

مقدار اولیه پارامتر.

مقدار پیش فرض: تعریف نشده

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

پارامترهای متغیر

متغیرها ساده ترین فرم هستند که یک پارامتر می تواند از آن استفاده کند. پارامترهای متغیر اجازه می دهند تا یک مقدار یک بار تعریف شود و سپس در طول بقیه مشخصات دوباره استفاده شود. به عنوان مثال ، در اینجا ما یک پارامتر CoerRadius را تعریف می کنیم:

همانطور که از نام آن پیداست ، مقادیر متغیر را می توان به صورت پویا اصلاح کرد ، یا با اتصال متغیر به ابزارک های ورودی (به عنوان مثال ، کشویی یا منوهای کشویی) یا با اصلاح سیگنال زیرین در یک API Vega View. به عنوان مثال ، در اینجا ما ابزارک هایی را برای سفارشی کردن شعاع گوشه نوار مارک شامل می کنیم:

اصطلاح

علاوه بر تنظیم مقدار اولیه ، می توانید با استفاده از یک عبارت (EXPR) یک پارامتر ایجاد کنید.

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

به عنوان مثال ، در اینجا ما میله های داخلی را در یک نمودار گلوله قرار می دهیم به ارتفاع نمودار بستگی دارد.

توجه: ارتفاع یک پارامتر داخلی است ، همانطور که در بخش بعدی توضیح داده شده است.

پارامترهای متغیر داخلی

چند نام پارامتر به طور خودکار پردازش و/یا رزرو می شوند:

• پارامترهای عرض مشخصات ، ارتفاع ، بالشتک ، خودکار سازی و خصوصیات پس زمینه به طور خودکار تعریف می شوند. مشخصات ممکن است شامل تعاریف مربوط به این پارامترها در آرایه پارامترهای سطح بالا باشد ، در این صورت تعاریف با هر مقادیر خاصیت مشخصات سطح بالا ادغام می شوند ، با تقدم به خواص تعریف شده در آرایه پارامترها.
• نام پارامترها داده های داده ، مورد ، رویداد ، والدین برای متغیرهای سطح بالا در عبارات محفوظ است. مشخصات ممکن است پارامترهای با نام Datum ، مورد ، رویداد یا والدین را تعریف نکنند.
• اگر پارامتری به نام مکان نما را تعریف کنید ، مقدار آن به طور خودکار مکان نما CSS Mouse را برای نمای Vega-Lite هدایت می کند. برای اطلاعات بیشتر در مورد پارامتر مکان نما ، به اسناد VEGA برای سیگنال مکان نما زیرین مراجعه کنید.

پارامترهای انتخابی

از طرف دیگر ، پارامترهای انتخاب ، نمایش داده های داده ای را که توسط ورودی کاربر دستکاری مستقیم هدایت می شوند (به عنوان مثال ، کلیک ماوس یا کشیدن) را تعریف کنید. هنگامی که ویژگی SELECT مشخص شد ، یک پارامتر انتخاب می شود. این ویژگی خصوصیات یک انتخاب از جمله نوع آن (نقطه یا بازه) را مشخص می کند ، که وقایع پیش فرض را که باعث انتخاب و پرس و جو داده حاصل می شود ، تعیین می کند.

ضروری. پردازش پیش فرض رویداد و پرس و جو داده برای انتخاب را تعیین می کند. Vega-Lite در حال حاضر از دو نوع انتخاب پشتیبانی می کند:

• "نقطه" - برای انتخاب چندین مقادیر داده گسسته. مقدار اول بر روی کلیک انتخاب شده و مقادیر اضافی روی Shift-Click قرار می گیرد.
• "فاصله" - برای انتخاب طیف مداوم مقادیر داده در کشیدن.

به عنوان مثال ، دو نوع را در برابر انتخاب مثال (به نام PTS) در زیر امتحان کنید :.

در حالی که انواع انتخاب پیش فرض های مفیدی را ارائه می دهند ، می توانید یک تعریف انتخاب را برای نادیده گرفتن رفتارهای انتخاب پیش فرض و سفارشی کردن طراحی تعامل انتخاب کنید. برای اطلاعات بیشتر در مورد تعریف انتخاب ، به مستندات انتخاب مراجعه کنید.

با استفاده از پارامترها

در رشته های بیان

نام پارامترها را می توان مستقیماً در رشته های بیان استفاده کرد. برای پارامترهای انتخاب ، نام پارامتر یک شیء را با خصوصیات مربوط به قسمتهای داده که در انتخاب شرکت می کنند (مشخص شده توسط رمزگذاری یا ویژگی های فیلدها) ارجاع می دهد.

به عنوان مثال ، در مثال زیر ، Opacity of the Point Marks توسط یک پارامتر متغیر محدود هدایت می شود ، و اندازه آنها توسط یک نقطه کلیک شده Miles_per_gallon تعیین می شود.

همانطور که پیش بینی می شود

Predicates are functions that retu a boolean true or false value. While predicates can be explicitly written as expression strings (for example, opacityVar == 25 or sel.Miles_per_Gallon>75) ، اغلب مناسب تر است که یک پارامتر را به عنوان یک محمول مستقیم درمان کنید. هنگامی که از پارامترهای متغیر به عنوان پیش بینی استفاده می شود ، مقادیر آنها به دنبال کنوانسیون های JavaScript به Booleans مجبور می شوند. برای پارامترهای انتخاب ، محمول زمانی که نقطه داده مربوطه در انتخاب قرار می گیرد ، به درستی ارزیابی می شود و در غیر این صورت نادرست است.

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

برای اطلاعات بیشتر به مستندات شرط مراجعه کنید.

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

داده ها

پارامترهای انتخاب علاوه بر این می توانند برای تعریف دو نوع از داده ها استفاده شوند: منطق خطوط یا حوزه های مقیاس. بیایید به دو نمونه از یک روش تعامل به نام اجمالی+جزئیات نگاه کنیم.

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

مشخصات زیر دارای یک تنظیم مشابه است. با این حال ، در این حالت ، قلم مو در نمای پایین دامنه مقیاس X Plot را هدایت می کند تا آن را تنها فاصله انتخابی نشان دهد.

یک روش متناوب برای ساخت هر یک از این مثالها این است که ابتدا داده های ورودی را با استفاده از انتخاب مانند SO فیلتر کنید:

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

اگر انتخاب در چندین زمینه یا رمزگذاری پیش بینی شده باشد ، باید به بخشی از تعریف وسعت داده ها داده شود. Vega-Lite به طور خودکار در صورتی که انتخاب فقط در یک قسمت واحد یا رمزگذاری پیش بینی شده باشد ، به طور خودکار از این ویژگی استفاده می کند. بنابراین ، با مثال فوق ، دامنه مقیاس می تواند صریح تر به عنوان:

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

پیکربندی انتخاب

ویژگی انتخاب شیء پیکربندی خصوصیات پیش فرض و تحولات اعمال شده در دو نوع پارامتر انتخاب را تعیین می کند. پیکربندی انتخاب می تواند حاوی خصوصیات زیر باشد:

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

به عنوان مثال ، تنظیم امتیاز به انتخاب های نقطه به طور پیش فرض بر روی دو بار کلیک کنید.

تعریف پیش فرض برای انتخاب فاصله. کلیه خصوصیات و تحولات برای تعریف انتخاب فاصله (به جز نوع) ممکن است در اینجا مشخص شود.

به عنوان مثال ، تنظیم فاصله برای غیرفعال کردن توانایی حرکت انتخاب های بازه به طور پیش فرض.