توثيق القالب[عرض] [عدّل] [تاريخ] [محو الاختزان] [استخدامات]ينشئ هذا القالب زرًا لاستخدامه مع أدوات {{حاسبة}}. يتطلب تمكين أداة الآلة الحاسبة.
الاستخدام
عند النقر على الزر، يقوم الزر بتقييم معامل formula الخاص به وإدراج النتائج في الحقل المحدد بواسطة معامل for. يمكنك فصل عدة قيم للـ for/formula باستخدام الفاصلة المنقوطة.
على سبيل المثال:
{{calculator button|contents=إضافة 1|for=x|formula=x+1|type=plain}}. X = {{حاسبة|type=plain|id=x|default=0}}
يُنتج
يجب أن يحتوي محتوى الزر فقط على نصوص غير تفاعلية (لا روابط، ولا عناصر <div>).
أنواع ألايقونات
هناك العديد من الأنواع المختلفة من الأزرار التي يمكنك إنشاؤها. للحصول على أزرار بأسلوب Codex، راجع [1] للحصول على أفضل الممارسات حول كيفية استخدامها. لاحظ أن القيمة "default" تشير إلى أنماط Codex "الافتراضية"، ولكنها ليست الخيار الافتراضي. قد يختلف نمط الأزرار العادية (plain) بين الأشكال المختلفة وأنظمة التشغيل.
| النوع | عادي | أساسي | هادئ | معطل |
| عادي (ليس Codex) | ||||
| default / افتراضي | ||||
| progressive / تدريجي | ||||
| destructive / تدميري | ||||
يوجد أيضًا دعم لمعامل الحجم (size) الذي يقبل القيم "medium" أو "large". يُوصى باستخدام "medium" ما لم يكن الزر عبارة عن أيقونة صغيرة فقط. كما يوجد معامل alt لتوفير نص بديل لقارئات الشاشة، ومع ذلك يجب استخدامه فقط إذا لم يكن محتوى النص الخاص بالزر يوضح الغرض منه. في معظم الأحيان، من الأفضل جعل محتوى الزر نفسه وصفيًا.
بيانات القالب
بيانات قالب: «Calculator button»
إنشاء عنصر زر يمكنه التأثير على عنصر واجهة مستخدم من القالب:حاسبة
| وسيط | وصف | نوع | حالة | |
|---|---|---|---|---|
| for | for | معرّف حقل الآلة الحاسبة المستهدف بواسطة هذا الزر | نص | مطلوب |
| formula | formula | الصيغة لتحديد قيمة الحقل المشار إليه بواسطة المعامل for
| نص | مطلوب |
| contents | contents 1 | محتوى الزر
| محتوى | مطلوب |
| type | type | نمط الزر. default هو "plain". القيمة "default" تعني زر Codex default، وهو ليس default لهذا القالب
| نص | مقترح |
| alt | alt | string بديل للزر لقارئات الشاشة. استخدمه فقط إذا كان النص الموجود على الزر غير واضح لقارئات الشاشة | نص | اختياري |
| class | class | فئات CSS إضافية تُضاف إلى الزر. إذا كنت تريد تنسيقه كزر حتى عند تعطيل الأداة، أضف "cdx-button cdx-button--fake-button cdx-button--fake-button--enabled" | نص | اختياري |
| class-live | class-live | فئات CSS إضافية تُضاف فقط إذا كانت أداة الآلة الحاسبة مفعلة | نص | اختياري |
| disabled | disabled | وضع علامة على الزر كمعطل. | بولياني | اختياري |
| id | id | معرّف عنصر الزر | نص | اختياري |
| size | size | حجم الزر. default هو medium
| نص | اختياري |
| style | style | أنماط CSS إضافية للزر | نص | اختياري |
| title | title | تلميح أداة للزر | نص | اختياري |
| weight | weight | وزن الزر (يتم تجاهله للأزرار العادية)
| نص | اختياري |