Share via

عناصر CreateUiDefinition

  • مقالة

توضح هذه المقالة مخطط وخصائص جميع العناصر المعتمدة من CreateUiDefinition.

المخطط

مخطط معظم العناصر كما يلي:

{
  "name": "element1",
  "type": "Microsoft.Common.TextBox",
  "label": "Some text box",
  "defaultValue": "my value",
  "toolTip": "Provide a descriptive name.",
  "constraints": {},
  "options": {},
  "visible": true
}
الخاصية مطلوب الوصف
الاسم نعم معرّف داخلي للإشارة إلى مثيل محدد لعنصر. الاستخدام الأكثر شيوعاً لاسم العنصر هو في outputs، حيث يتم تعيين قيم مخرجات العناصر المحددة إلى معلمات القالب. يمكنك أيضاً استخدامه لربط قيمة مخرجات عنصر ما بـ defaultValue لعنصر آخر.
النوع نعم عنصر تحكم واجهة المستخدم المراد عرضه للعنصر. للحصول على قائمة بالأنواع المدعومة، راجع العناصر.
label نعم نص العرض للعنصر. تحتوي بعض أنواع العناصر على تسميات متعددة، لذلك يمكن أن تكون القيمة عنصراً يحتوي على سلاسل متعددة.
القيمة الافتراضية لا القيمة الافتراضية للعنصر. تدعم بعض أنواع العناصر القيم الافتراضية المعقدة؛ لذلك يمكن أن تكون القيمة عنصراً.
تلميح لا النص المراد عرضه في تلميح الأداة الخاص بالعنصر. على غرار label، تدعم بعض العناصر سلاسل متعددة لتلميحات الأدوات. يمكن تضمين الروابط المضمنة باستخدام صيغة Markdown.
القيود لا واحدة أو أكثر من الخصائص المستخدمة لتخصيص سلوك التحقق من صحة العنصر. تختلف الخصائص المدعومة للقيود حسب نوع العنصر. لا تدعم بعض أنواع العناصر تخصيص سلوك التحقق، وبالتالي لا تحتوي على خاصية قيود.
الخيارات لا الخصائص الإضافية التي تخصص سلوك العنصر. على غرار constraints، تختلف الخصائص المدعومة حسب نوع العنصر.
مرئي لا يشير إلى ما إذا كان العنصر معروضاً أم لا. إذا كان true، يتم عرض العنصر والعناصر التابعة القابلة للتطبيق. القيمة الافتراضية هي true. استخدم الدالات المنطقية للتحكم ديناميكياً في قيمة هذه الخاصية.

العناصر

تحتوي الوثائق الخاصة بكل عنصر على نموذج لواجهة المستخدم، ومخطط، وملاحظات حول سلوك العنصر (عادةً ما يتعلق بالتحقق من الصحة والتخصيص المدعوم) وعينة الإخراج.

الخطوات التالية

للحصول على مقدمة حول إنشاء تعريفات واجهة المستخدم، راجع Getting started withCreateUiDefinition.