محتويات مكتبة الأنماط في SharePoint 2010

عناصر تحكم ويب CSS في SharePoint

تتولى عناصر تحكم خادم الويب مسؤولية إدارة وعرض روابط ملفات CSS وأوراق الأنماط. بشكل افتراضي، توجد عناصر تحكم خادم الويب في صفحات SharePoint الرئيسية. للعثور على الصفحات الرئيسية، ابحث في معرض الصفحات الرئيسية وتخطيطات الصفحات، أو في SharePoint Foundation، في معرض الصفحات الرئيسية. المسار النسبي للمعرض هو /_catalogs/masterpage/Forms/AllItems.aspx.

تحديد موقع الصفحة الرئيسية

لفحص عناصر تحكم خادم الويب CSS في SharePoint، يجب عليك الحصول على نسخة من الصفحة الرئيسية المستخدمة في الموقع. ولكن لتنزيل نسخة من الصفحة الرئيسية لموقعك، عليك معرفة الصفحة الرئيسية التي يستخدمها موقعك.

استخدم واحدًا أو أكثر مما يلي لتحديد الصفحة الرئيسية التي يستخدمها موقعك:

• في موقع SharePoint Server 2010 حيث تم تمكين ميزات النشر وتنشيطها، قم بالوصول إلى صفحة إعدادات الصفحة الرئيسية للموقع عبر إجراءات الموقع،  .الصفحة الرئيسية ، انقر على الرابط الشكل والمظهر. وبعد ذلك، ضمن قسم الإعدادات، الموقع

• بدلاً من استخدام القائمة لتحديد موقع صفحة إعدادات الصفحة الرئيسية للموقع، قم بإلحاق مقتطف URL التالي بنهاية عنوان الخادم الخاص بموقعك: /_layouts/ChangeSiteMasterPage.aspx; على سبيل المثال، https://contoso.com/\_ Lays/ChangeSiteMasterPage.aspx

• في موقع SharePoint Foundation، يمكنك استخدام Windows PowerShell لتحديد الصفحة الرئيسية التي يستخدمها الموقع، كما هو موضح في الشكل 4. وفيما يلي مثال لبرنامج نصي.

  بوويرشيل

  $web = get-spweb("https://contoso.com");$web.masterurl

الشكل 4. v4.master على موقع فريق SharePoint

يسرد الجدول 4 كافة عناصر تحكم خادم الويب المرتبطة بـ CSS والمتوفرة في SharePoint Server. يمكنك العثور على عناصر التحكم هذه في مساحة الاسم Microsoft.SharePoint.WebControls، والتي تعد جزءًا من تجميع Microsoft.SharePoint.dll.

الجدول 4. عناصر تحكم خادم الويب CSS في SharePoint 2010

قم بتوسيع الجدول

تصف الأقسام التالية كل عنصر تحكم مدرج في الجدول 4، وتلخص فوائد كل منها.

رابط CSS

يوجد عنصر تحكم ويب CSSLink في صفحات SharePoint الرئيسية وهو مسؤول عن عرض HTML <LINK> عنصر. يعمل عنصر التحكم CSSLink مع عناصر التحكم في تسجيل CSS. إذا كانت هناك عناصر تحكم في تسجيل CSS على الصفحة، فإن عنصر تحكم CSSLink يسجل ويعرض مراجع ملفات CSS الإضافية التي يقوم عنصر تحكم التسجيل بإنشائها.

يحتوي عنصر التحكم CSSLink على الأعضاء التاليين:

• UIVersion (اختياري) — يتيح لمالكي المواقع تغيير شكل وأسلوب عرض موقع SharePoint الذي تمت ترقيته أو ترحيله. تمكين معاينة الموقع في واجهة مستخدم SharePoint أو واجهة مستخدم Microsoft Office SharePoint Server (MOSS) 2007. قم بتعيين القيمة إلى 4 لـ SharePoint وقم بتعيينها إلى 3 لمواقع MOSS 2007.

• الإصدار (اختياري) - يتجاوز إصدار التحكم لفئة SPControl.

• البديل (اختياري) - يشير إلى ما إذا كان CSS الأساسي (Core.css أو Corev4.css) قد تم عرضه مع مراجع ملفات CSS أخرى، أو تم عرض CSS بديل. القيمة الافتراضية هي False، والتي تحدد أنه سيتم عرض ملف css الأساسي (core.css أو corev4.css).

• DefaultUrl (اختياري) — يقوم بتعيين عنوان URL الافتراضي المستخدم لملف CSS أو الحصول عليه.

  يوضح المثال التالي كيفية عرض عنصر التحكم هذا.

  لغة البرمجة

  <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/_layouts/1033/styles/Themable/search.css?rev=Uoc0fsLIo87aYwT%2FGX5UPw%3D%3D"/> <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/_layouts/1033/styles/Themable/wiki.css?rev=9pXM9jgtUVYAHk21JOAbIw%3D%3D"/> <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/_layouts/1033/styles/Themable/corev4.css?rev=iIikGkMuXBs8CWzKDAyjsQ%3D%3D"/>

يضيف عنصر التحكم CSSLink معلمة سلسلة استعلام ?rev= إلى مرجع الملف للتحكم في التخزين المؤقت للمتصفح ولإجبار المتصفح على الحصول على نسخة جديدة من الملف.

يعد عنصر التحكم CSSLink مسؤولاً أيضًا عن السلوكيات الموضحة في القسم التالي.

تسجيل CSS

يتم استخدام عنصر تحكم الويب CSSRegistration مع عنصر تحكم CSSLink لتسجيل ملفات CSS بحيث يمكن عرضها على الصفحة. تسجيل ملفات CSS عن طريق عنوان URL نسبي أو ثابت.

يحتوي عنصر تحكم CSSRegistration على الأعضاء التاليين:

• الاسم (مطلوب) — اسم الملف المراد تسجيله. إذا لم يتم توفير الاسم، فسيظهر SharePoint الخطأ الموضح في الشكل 5. يجب أن تكون قيمة خاصية الاسم اسم ملف أو عنوان URL. إذا تم استخدام اسم ملف، فيجب أن يكون ملف CSS موجودًا في مجلد LAYOUTS Style.

  يوضح المثال التالي كيفية استخدام ملف custom.css الذي تمت الإشارة إليه أعلاه والذي تم نشره في مجلد الأنماط (C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS\{Locale- المعرف}\STYLES).

  XAML

  <SharePoint:CssRegistration runat="الخادم" الاسم="custom.css" />

  يوضح المثال التالي كيف يعرض عنصر التحكم CSSLink تسجيل custom.css.

  لغة البرمجة

  <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/_layouts/1033/styles/custom.css?rev=pFayZ3XaoWhaMymtxOLHNA%3D%3D"/>

  بالإضافة إلى الإشارة إلى ملف موجود في الدليل LAYOUTS\{Locale ID}\Styles، يمكنك تسجيل ملف باستخدام عنوان URL. حدد عنوان URL واحدًا في خاصية الاسم باستخدام الرموز المميزة. بعض الرموز المميزة لعناوين URL المعروفة هي: ~site و~sitecollection و~language. استخدم هذه الرموز المميزة مع منشئ التعبير، مثل SPURl. يتم تعيين رمز اللغة ~ إلى سلسلة ثقافة اللغة، مثل en-us.

  إضافة إدخال مشابه للمثال التالي...

  XAML

  <SharePoint:اسم تسجيل Css=<%$ SPURl:~sitecollection/Style Library/~language/Custom/2ndcustom.css %>" runat="الخادم" />

  …يُنشئ HTML التالي، كما هو موضح في الشكل 5.

  لغة البرمجة

  <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/Style%20Library/en-US/Custom/2ndcustom.css"/>

الشكل 5. خطأ في صفحة SharePoint

• بعد (اختياري) — يحدد ترتيب العرض لملف CSS الذي تقوم بتسجيله. على سبيل المثال، إذا كنت تريد عرض ورقة أنماط مخصصة تسمى custom.css بعد core4.css، يمكنك استخدام التعليمة البرمجية التالية لتكوين عنصر التحكم في التسجيل.

  XAML

  <SharePoint:اسم تسجيل Css=<%$ SPURl:~sitecollection/Style Library/~language/Custom/2ndcustom.css %>" runat="الخادم" بعد="core4.css" />

  يؤدي القيام بذلك إلى إجبار عنصر تحكم الويب CSSLink على عرض ملفك المخصص بعد رابط الملف core4.css.

  لغة البرمجة

  <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/_layouts/1033/styles/Themable/corev4.css?rev=iIikGkMuXBs8CWzKDAyjsQ%3D%3D"/> <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/Style%20Library/en-US/Custom/2ndcustom.css"/>

   ملحوظة

  يمكنك استخدام منشئ التعبير SPURl فقط على مواقع SharePoint Server؛ وهو غير متوفر في SharePoint Foundation.

• EnableCSSTheming — يحدد ما إذا كنت تريد أن تكون أوراق الأنماط الخاصة بك قابلة للتخصيص، مما يعني أنه يمكن تطبيقها كجزء من سمات SharePoint المخصصة.

  • قم بتعيين الخاصية EnableCSSTheming لعنصر التحكم CSSRegistration على القيمة true.

  • أضف تعليقات السمات إلى فئات أنماط CSS الخاصة بك. للاطلاع على بعض الأمثلة، افحص الدليل Themable المثبت مع SharePoint (C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14 \TEMPLATE\LAYOUTS\{Locale-ID}\STYLES\Themable).

    يوضح المثال التالي فئة ms-toolbar CSS في Themable Corev4.css. إذا قمت بتطبيق سمة، في كل مرة يتم فيها استخدام فئة ms-toolbar، تستبدل السمة اللون #0072BC بلون سمة الارتباط التشعبي الذي تم تحديده في السمة نفسها.

    .ms-toolbar{ الخط-family:verdana; حجم الخط: 8pt؛ زخرفة النص: لا شيء؛ /* [ReplaceColor(themeColor:"Hyperlink")] */ color:#0072BC; }

• ConditionalExpression - يستخدم لتحديد ما إذا كان سيتم تطبيق ورقة الأنماط هذه على إصدار متصفح معين. على سبيل المثال، تحدد قيمة IE 9.0 أن التسجيل مطبق على الإصدار 9.0 من Internet Explorer. يكتشف عنصر التحكم CSSLink القيمة.

سمة

يطبق عنصر تحكم خادم الويب الخاص بالسمة سمة على موقع SharePoint. هناك العديد من الأدوات المتاحة التي يمكنك استخدامها لإنشاء السمات؛ على سبيل المثال Theme Builder على Microsoft Connect. بعد إنشاء سمة (ملفات .thmx)، يمكنك تحميلها إلى معرض السمات الموجود في صفحة الإعدادات (/_catalogs/theme/ النماذج/AllItems.aspx). لتطبيق سمة، قم بالوصول إلى صفحة سمة الموقع (/_layouts/themeweb.aspx).

وفيما يلي مثال على ذلك.

لغة البرمجة

<الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/_catalogs/theme/Themed/54E2D43/search-7E1AFF02.css?ctag=1"/> <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/_catalogs/theme/Themed/54E2D43/wiki-ECF524AA.css?ctag=1"/> <الرابط rel="ورقة الأنماط" اكتب="نص/css" href="/_catalogs/theme/Themed/54E2D43/corev4-8A0ABD2F.css?ctag=1"/>

عند تطبيق سمة، يقوم SharePoint بإنشاء مجلد سمة جديد يتضمن كافة ملفات CSS والصور المطلوبة لعرض السمة. لا يظهر مجلد السمات الجديد في إعدادات الموقع أو في عرض المحتوى بالكامل. باستخدام SharePoint Designer، يمكنك عرض ملفات السمات، كما هو موضح في الشكل 6.

الشكل 6. سمات SharePoint