Skip to content

شريط تمرير المدى

اضبط توسيم شريط تمرير المدى بمقبضين في Potato لاختيار مدى عددي بحدود قابلة للتخصيص ومقدار خطوة وتسميات للطرفين.

يوفر مخطط توسيم شريط تمرير المدى شريطاً بمقبضين يتيح للموسِّمين اختيار مدى من القيم بدل قيمة واحدة. وهذا مفيد في المهام التي تكون إجابتها فترة أو مجالاً، مثل تقدير الفئات العمرية أو النوافذ الزمنية أو فترات الثقة.

شريط تمرير المدى بمقبضين في Potato مضبوط على فئة عمرية من 25 إلى 75شريط تمرير المدى في Potato

نظرة عامة

خلافاً لشريط التمرير القياسي الذي يلتقط قيمة واحدة، لشريط تمرير المدى مقبضان قابلان للسحب يمثلان الطرف الأدنى والأعلى للمدى. يسحب الموسِّمون أياً من المقبضين لتحديد الفترة، وتُعرض القيم الحالية بجانب الشريط لضبط الدقة.

البدء السريع

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: age_range
    description: Estimate the age range of the author.
    min_value: 0
    max_value: 100
    step: 1
    left_label: "Young"
    right_label: "Old"

خيارات الإعدادات

الحقلالنوعالافتراضيالوصف
annotation_typestringمطلوبيجب أن يكون "range_slider"
namestringمطلوبمعرّف فريد لهذا المخطط
descriptionstringمطلوبالتعليمات المعروضة للموسِّمين
min_valuenumber0القيمة الدنيا لمقياس الشريط
max_valuenumber100القيمة العليا لمقياس الشريط
stepnumber1مقدار الزيادة بين القيم القابلة للاختيار
left_labelstringالتسمية المعروضة عند الطرف الأيسر (الأدنى) للشريط
right_labelstringالتسمية المعروضة عند الطرف الأيمن (الأعلى) للشريط
show_valuesbooleantrueعرض القيمتين الدنيا والعليا المختارتين حالياً
default_lownumberالموضع الافتراضي للمقبض الأدنى
default_highnumberالموضع الافتراضي للمقبض الأعلى
label_requirement.requiredbooleanfalseهل يجب إتمام التوسيم قبل الانتقال

أمثلة

تقدير الفئة العمرية

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: age_estimate
    description: What age range do you think the author falls in?
    min_value: 13
    max_value: 90
    step: 1
    left_label: "Younger"
    right_label: "Older"

فترة الثقة

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: confidence_interval
    description: Select the range within which you believe the true value falls.
    min_value: 0
    max_value: 100
    step: 5
    left_label: "0%"
    right_label: "100%"
    show_values: true

نافذة زمنية

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: time_window
    description: When during the day is this activity most likely? (hours)
    min_value: 0
    max_value: 24
    step: 0.5
    left_label: "Midnight"
    right_label: "Midnight"

مدى الراحة الحرارية

yaml
annotation_schemes:
  - annotation_type: range_slider
    name: comfort_range
    description: What temperature range (°F) do you find comfortable?
    min_value: 40
    max_value: 110
    step: 1
    left_label: "Cold"
    right_label: "Hot"
    show_values: true

صيغة المخرجات

json
{
  "age_estimate": {
    "labels": {
      "low": 28,
      "high": 42
    }
  }
}

تتضمن المخرجات دائماً قيمتَي low وhigh ضمن المدى المهيّأ بين min_value وmax_value.

أفضل الممارسات

  1. اضبط قيماً افتراضية ذات معنى - استخدم default_low وdefault_high لتفادي تثبيت كل الموسِّمين عند الطرفين
  2. اختر مقدار خطوة مناسباً - خطوات دقيقة (0.1) للمهام الدقيقة، وخطوات أوسع (5 أو 10) للتقديرات التقريبية
  3. أضف تسميات للطرفين - يوفر left_label وright_label سياقاً دلالياً يتجاوز الأرقام المجردة
  4. أبقِ show_values مفعّلة - القراءات الرقمية تساعد الموسِّمين على الاختيار بدقة
  5. استخدمه لمهام المدى الحقيقية - إن كنت تحتاج قيمة واحدة فقط، فاستخدم شريط التمرير القياسي بدلاً منه

قراءة إضافية

للاطلاع على تفاصيل التنفيذ، راجع الوثائق المصدرية.