انتقل إلى المحتوى الرئيسي

getSingleAttributeByMarkerSet

الحصول على سمة واحدة مع بيانات من مجموعة السمات.

الوصف​

ترجع هذه الطريقة سمة واحدة مع بيانات من مجموعات السمات. ترجع وعدًا (Promise) يتم حله إلى كائن IAttributesSetsEntity.

AttributesSets.getSingleAttributeByMarkerSet(

setMarker*, attributeMarker*, langCode

);

مخطط المعلمات​

المخطط

setMarker(مطلوب): string
معرف نصي (علامة) لمجموعة السمات
مثال: "productAttributes"

attributeMarker(مطلوب): string
معرف نصي (علامة) للسمة في المجموعة
مثال: "color"

langCode: string
رمز اللغة. الافتراضي: "en_US"
مثال: "en_US"

أمثلة​

مثال بسيط​

const response = await AttributesSets.getSingleAttributeByMarkerSet('list1', 'list1');

مثال مع خاصية langCode​

const response = await AttributesSets.getSingleAttributeByMarkerSet('list1', 'list1', 'en_US');

مثال على الاستجابة​

{
  "type": "string",
  "value": {},
  "marker": "admin-text",
  "position": 1,
  "listTitles": [],
  "validators": {},
  "initialValue": null,
  "localizeInfos": {
    "title": "نص الإداريين"
  },
  "additionalFields": []
}

مخطط الاستجابة​

المخطط: IAttributesSetsEntity

type: AttributeType
نوع السمة.
مثال: "string"، "text"، "integer"، "إلخ"

value: any
قيمة السمة، التي يمكن أن تكون من أي نوع.

marker: string
معرف نصي للسمة (علامة).
مثال: "color"، "size"، "إلخ"

position: number
رقم الموضع للفرز.
مثال: 1

listTitles: IListTitle[] | Record<string, any>
مصفوفة من القيم (مع بيانات موسعة) لسمات القائمة و radioButton.
مثال:

[
  {
    "title": "أحمر",
    "value": 1,
    "position": 1,
    "extendedValue": null,
    "extendedValueType": null
  },
  {
    "title": "أصفر",
    "value": 2,
    "position": 2,
    "extendedValue": null,
    "extendedValueType": null
  }
]

listTitles.title: string
العنوان أو الاسم المرتبط بعنصر القائمة.
مثال: "اسم العنصر"

listTitles.value: number | string
قيمة عنصر القائمة، التي يمكن أن تكون إما رقمًا أو نصًا حسب السياق.
مثال: 42

listTitles.position: string | number | null
موضع عنصر القائمة، الذي يمكن تمثيله كنص أو رقم أو null إذا لم يكن ذلك مناسبًا.
مثال: 1

listTitles.extended: object
كائن يحتوي على خصائص إضافية أو بيانات وصفية تتعلق بعنصر القائمة. يمكن أن تشمل أي تفاصيل إضافية تمد المعلومات الأساسية.

listTitles.extended.value: string | null
القيمة الموسعة، التي يمكن أن تكون نصًا أو null.
مثال: "extra_value"

listTitles.extended.type: string | null
نوع القيمة الموسعة، التي يمكن أن تكون نصًا أو null.
مثال: "color"

validators: Record<string, any>
مجموعة من المدققين للتحقق من الصحة.
مثال:

{
  "requiredValidator": {
    "strict": true
  },
  "defaultValueValidator": {
    "fieldDefaultValue": 11
  }
}

localizeInfos: ILocalizeInfo
اسم القالب، مع الأخذ في الاعتبار التوطين.
مثال:

{
  "title": "سميتي"
}

additionalFields: Record<string, any>
حقول إضافية للسمة (اختياري).