التعريف
- الرابط يتألف من مجموعة محدودة من الأحرف: الحروف والأرقام وبضعة رموز (RFC 3986، القسم 2). وما سواها يُكتب ترميزاً بالنسبة المئوية: علامة
%يليها رقمان ستة عشريان لكل بايت (القسم 2.1). - الأحرف التي لا تحتاج ترميزاً هي الحروف اللاتينية والأرقام والشرطة
-والنقطة.والشرطة السفلية_والعلامة~(القسم 2.3). أما الأحرف المحجوزة، مثل/و?و#و&، فينبغي ترميزها إذا كانت جزءاً من البيانات لا من بنية الرابط (القسم 2.2). - تحوّل مواصفة الرابط من WHATWG كل حرف فوق
U+007Fإلى بايتات UTF-8 مرمّزة بالنسبة المئوية. فالحرف ق (U+0642) بايتاهD9 82، ويُكتب%D9%82. وكلمة قهوة تصير%D9%82%D9%87%D9%88%D8%A9: أربعة حروف عربية، كل منها 6 رموز. - علامة
%نفسها إذا كانت بيانات تُرمَّز%25(القسم 2.4 من RFC 3986). وتوصي RFC 3986 بأن يكتب المنتجون الأرقام الستة عشرية بحروف كبيرة، وإن كانت الصغيرة تكافئها.
لماذا يهم
- الرابط
/products/%D9%82%D9%87%D9%88%D8%A9هو نفسه الرابط الذي جزؤه الأخير قهوة: صيغتان للعنوان نفسه، إحداهما كما يُرسل والأخرى كما يُقرأ. ويعرض مولّد جزء العنوان في Arablyzer الصيغتين. - تقول Google في دليل بنية العناوين إن الأحرف غير ASCII ينبغي أن تُرمَّز بالنسبة المئوية في الخاصية
href، وتمثّل لذلك بكلمات عربية: الصيغةhttps://example.com/%D9%86%D8%B9%D9%86%D8%A7%D8%B9/%D8%A8%D9%82%D8%A7%D9%84%D8%A9موصى بها، وhttps://example.com/نعناعغير موصى بها. - يقرأ الزاحف كل فرق في العنوان على أنه صفحة أخرى، كما تشرح قاعدة
url-slug-invalid. فاختر صيغة واحدة للعنوان المرجعي (canonical) واستعملها في كل مكان. - الترميز السليم هو UTF-8 دائماً. فالبايتات من ترميز آخر، مثل Windows-1256 في
%C7%E1، لا تُقرأ UTF-8 صالحاً، فتصل الرسالة أو العنوان مشوّهين أو تُرفض. - الترميز مرتين يفسد العربية: تصير
%الأولى%25، فيجد المستقبِل بعد فك الترميز مرة واحدة نص%D9%85لا الحرف. - تفحص قاعدة
url-slug-invalidجزء العنوان كما يقرؤه الناس بعد فك الترميز، وتفحص قاعدةwhatsapp-text-encodingالرسالة التي في رابط واتساب.
مثال
في جافاسكربت:
js
encodeURIComponent('قهوة')
// '%D9%82%D9%87%D9%88%D8%A9'
new URL('https://shop.example/products/قهوة-عربية-2026').pathname
// '/products/%D9%82%D9%87%D9%88%D8%A9-%D8%B9%D8%B1%D8%A8%D9%8A%D8%A9-2026'
// مرمَّزة مرتين:
encodeURIComponent(encodeURIComponent('قهوة'))
// '%25D9%2582%25D9%2587%25D9%2588%25D8%25A9'الدالة encodeURIComponent تترك الحروف اللاتينية والأرقام و- _ . ! ~ * ' ( ) كما هي (MDN)، فتبقى -2026 في الجزء كما كتبتها.
أخطاء شائعة
- ترميز النص مرتين، كأن يرمّزه القالب ثم تضيف إضافة ترميزاً ثانياً: تظهر
%D9%85…للزائر بدل العربية. - تمرير الرابط كله إلى
encodeURIComponent: تقول MDN إنها ترمّز أكثر منencodeURI، بما فيها رموز بنية الرابط، فتُرمَّز:و/و?ويتعطل الرابط. رمّز القيمة وحدها، ثم ركّب الرابط. - ترك
#أو&خاماً في قيمة: تنتهي سلسلة الاستعلام عند أول#(RFC 3986، القسم 3.4)، ويبدأ بعدها جزء الوسم، وتفصل&بين المعاملات. اكتبهما%23و%26. - كتابة المسافة
+في غير نماذج الويب: علامة+للمسافة خاصة بصيغةapplication/x-www-form-urlencodedالتي تستعملها النماذج (WHATWG)، أما في المسار والاستعلام العاديين فالمسافة%20. - ترميز الرابط بغير UTF-8 لأن صفحة المصدر محفوظة بترميز آخر: تقول HTML إن النماذج وترميز الروابط يستعملان ترميز المستند افتراضياً.