دليل الاستخدام — CSS StylEditor

تحصل كل خاصية على عنصر تحكم مناسب لنوع قيمتها: حقل رقمي مع اختيار الوحدة، قائمة قيم للاختيار منها، منتقي ألوان مع الشفافية، بناء قيمة دالة من معاملات، أو مربع اختيار لتفعيل/إلغاء كلمة مفتاحية.

يؤدي النقر بزر الماوس الأيمن على اسم الخاصية إلى فتح قائمة تتضمن خيار حذف الخاصية من القاعدة. بعد الحذف، يتم تحديث القائمة.

من نفس قائمة النقر بزر الماوس الأيمن، يمكنك التبديل من التحرير المُقسَّم (حسب النوع) إلى تحرير القيمة كنص حر، والعودة منه إلى التحرير المُقسَّم.

إذا كانت القيمة المضبوطة فعليًا في المتصفح مختلفة عن القيمة المُدخَلة في عنصر التحكم (مثل قيمة غير صالحة يرفضها المتصفح، أو لون يُحسب بشكل مختلف) - يظهر أسفل الخاصية سطر أخضر صغير يعرض القيمة المسجَّلة فعليًا في ورقة الأنماط. عند عدم وجود اختلاف، لا يظهر هذا السطر إطلاقًا.

في أسفل اللوحة، يظهر سطر يلخّص بنية الجملة الكاملة للقاعدة المحددة، ويتحدث فورًا مع كل تغيير في الخصائص - كما سُجِّلت فعليًا في ورقة أنماط المتصفح.

من قائمة النقر بزر الماوس الأيمن، يمكنك أيضًا استعادة خاصية إلى القيمة التي كانت عليها عند تحميل اللوحة، وفتح صفحات معلومات عامة حول الأداة وحول الخاصية المحددة.

شجرة منظَّمة حسب بادئة الاسم (على سبيل المثال، تُجمَّع معًا جميع الخصائص التي تبدأ بـ border)، للتصفح التدريجي بين المجموعات.

قائمة مسطّحة مع حقل بحث وإكمال تلقائي حسب اسم الخاصية المطلوبة.

إذا فشل الحفظ فعليًا من جانب الخادم — مثل مشكلة مصادقة، أو مسار غير مصرَّح به، أو ملف غير موجود — ستظهر رسالة خطأ مفصَّلة تشرح ما حدث، وليس مجرد إشعار فشل عام.

تُستخدم الشارة الرقمية في شريط الأدوات أيضًا كمؤشر بصري: عند وجود اختلافات بين المتصفح والملف المحفوظ (كما تظهر في لوحة Diffs)، تتحول الشارة إلى خلفية حمراء بنص أبيض — علامة على وجود تغييرات لم تُحفظ بعد.

عند التحديد، تُعرض اللوحة بشفافية جزئية طالما لم يمر الماوس فوقها، وتعود إلى الوضوح الكامل عند وجود الماوس فوقها.

عند التحديد، يُحفظ موضع اللوحة على الشاشة ويُعاد تحميله في المرة القادمة. بدون التحديد، تعود اللوحة إلى الموضع الافتراضي عند كل تحميل.

يحدد كيفية كتابة CSS في الملف عند الحفظ: متعدد الأسطر (كل خاصية في سطر منفصل) أو سطر واحد متواصل لكل قاعدة.

عنوان الخادم الذي يُرسَل إليه محتوى الملف عند النقر على Save. بدون تحديد عنوان، لن يتم الحفظ وستظهر رسالة خطأ.

زوج من الحقول (اسم وقيمة) يُرسلان مع طلب الحفظ، في حال طلب الخادم مصادقة قبل قبول تحديث الملف.

يحدّد الإعدادات الخاصة بالخادم التي يقرأها se5-save.php: وضع "تجربة جافة" (dry run) للاختبار دون كتابة الملفات فعليًا، وقائمة أنماط مسارات مسموح بتحديثها (regex)، وزوج مفتاح/قيمة للمصادقة - يختلف بين الطلبات القادمة من الخادم نفسه والطلبات الخارجية - وبادئة عنوان اختيارية تُحذف عند تحويل عنوان الصفحة الكامل إلى مسار نسبي على القرص.

هذا هو الملف الذي يُدخَل عنوانه في إعداد "Save address" في الإضافة. يستقبل طلب POST بجسم JSON:

{
  "apiVersion": number,
  "check"?: true,               // ping only, to confirm the endpoint is reachable
  "href": string,                 // full page URL (location.href) the CSS belongs to
  "pageBase"?: string,              // the page's <base> URL, if it has one
  "content": string,                 // full CSS file content to write
  "<authKeyName>": "<authValue>"  // must match SE_AUTH_KEY / SE_AUTH_VAL
}

يحوّل href إلى مسار نسبي ضمن جذر مستندات الخادم، ويتحقق من أن المسار ملف .css ويطابق نمطًا مسموحًا به، ثم - ما لم يكن وضع dry-run مفعّلًا - يكتب content إلى ذلك الملف. يمكن وضع الملفين في أي مكان يمكن الوصول إليه على الخادم، طالما بقيا معًا في المجلد نفسه.

يكتب السكربت النموذجي فوق الملف مباشرة ولا يحتفظ بأي سجل. يمكن لمن يرغب توسيعه - قبل كتابة المحتوى الجديد، بنسخ المحتوى الحالي للملف إلى مجلد نسخ احتياطي/إصدارات منفصل، للاحتفاظ بسجل للحفظات السابقة.