የፓሌት ንፅፅርን ማረጋገጥ
የፓሌት ንፅፅርን ማረጋገጥ ችሎታ በንድፍ ፓሌትዎ ውስጥ ያሉ የቀለም ጥንዶች ለWCAG (የዌብ ይዘት ተደራሽነት መመሪያዎች) መሟላትን የሚፈትሽ ሲሆን፣ ከዚያም በጉዳዩ ላይ ከመተግበሩ በፊት ያረጋግጣል።
አጠቃላይ እይታ
ይህ ችሎታ የጣቢያዎ የቀለም ስብስብ በጽሑፍ እና በጀርባ ቀለም መካከል ያለውን ንፅፅር ጥምርታ (contrast ratio) በማረጋገጥ፣ ተደራሽነት ደረጃዎችን የሚያሟላ መሆኑን ያረጋግጣል። ይህ ደግሞ የእይታ ችግር ያለባቸው ተጠቃሚዎች በቀላሉ ሊያነቡት የሚቸገሩባቸው የቀለም ጥምርቶችን መከላከል ይረዳል።
የግብዓት ቅርጸት (Input Format)
ይህ ችሎታ የቀለም ፓሌትን እንደ ግብዓት ይቀበላል፦
{
"colors": [
{
"name": "primary",
"hex": "#678233"
},
{
"name": "text",
"hex": "#ffffff"
},
{
"name": "background",
"hex": "#f5f5f5"
}
],
"wcag_level": "AA"
}
መለኪያዎች (Parameters)
| መለኪያ (Parameter) | አይነት (Type) | አስፈላጊ (Required) | መግለጫ (Description) |
|---|---|---|---|
colors | array | አዎ | የname እና hex ባህሪያት ያላቸው የቀለም ዕቃዎች ስብስብ (Array of color objects) |
wcag_level | string | አይ | የWCAG መሟላት ደረጃ፡ "A", "AA" (በቅድፋት)፣ ወይም "AAA" |
pairs_to_check | array | አይ | ሊረጋገጡ የሚፈልጉ የተወሰኑ የቀለም ጥንዶች (ለምሳሌ፡ ["primary-text", "background-text"]) |
በየWCAG ደረጃ የተፈተኑት
ይህ ችሎታ ንፅፅር ጥምርታዎችን በWCAG ደረጃዎች መሠረት ያረጋግጣል፦
| ደረጃ (Level) | መደበኛ ጽሑፍ (Normal Text) | ትልቅ ጽሑፍ (Large Text) | ዝቅተኛ ጥምርታ (Minimum Ratio) |
|---|---|---|---|
| A | 3:1 | 3:1 | 3:1 |
| AA | 4.5:1 | 3:1 | 4.5:1 |
| AAA | 7:1 | 4.5:1 | 7:1 |
- መደበኛ ጽሑፍ — ከ18pt በታች የሆነ ጽሑፍ (ወይም 14pt በደል)
- ትልቅ ጽሑፍ — 18pt ወይም ከዚያ በላይ የሆነ ጽሑፍ (ወይም 14pt በደል ወይም ከዚያ በላይ)
የውጤት ስхема (Output Schema)
ይህ ችሎታ ዝርዝር የማረጋገጫ ሪፖርት ይመልሳል፦
{
"compliant": true,
"wcag_level": "AA",
"pairs": [
{
"pair": "primary-text",
"color1": "#678233",
"color2": "#ffffff",
"contrast_ratio": 5.2,
"wcag_a": true,
"wcag_aa": true,
"wcag_aaa": false,
"status": "pass"
},
{
"pair": "background-text",
"color1": "#f5f5f5",
"color2": "#333333",
"contrast_ratio": 12.1,
"wcag_a": true,
"wcag_aa": true,
"wcag_aaa": true,
"status": "pass"
}
],
"summary": {
"total_pairs": 2,
"passing": 2,
"failing": 0,
"recommendations": []
}
}
የውጤት መስኮች (Output Fields)
| መስክ (Field) | አይነት (Type) | መግለጫ (Description) |
|---|---|---|
compliant | boolean | መላው ፓሌት የተጠቀሰውን የWCAG ደረጃ የሚያሟላ መሆኑን ያመለክታል |
wcag_level | string | የተፈተነው የWCAG ደረጃ |
pairs | array | ለእያንዳንዱ የቀለም ጥንድ ዝርዝር ውጤቶች |
contrast_ratio | number | የተሰላው የንፅፅር ጥምርታ (1:1 እስከ 21:1) |
status | string | ለእያንዳንዱ ጥንድ "pass" ወይም "fail" |
recommendations | array | ያልተሳኩ ጥንዶችን ለማሻሻል የሚረዱ ሀሳቦች |