Conținutul bibliotecii de stiluri în SharePoint 2010

Controale web CSS în SharePoint

Controalele serverului web sunt responsabile pentru gestionarea și redarea legăturilor la fișiere CSS și a foilor de stil. În mod implicit, controalele serverului web sunt situate în paginile master SharePoint. Pentru a găsi paginile principale, căutați în Pagina principală și Galeria de aspect al paginii sau, în SharePoint Foundation, în galeria paginilor principale. Calea relativă către galerie este /_catalogs/masterpage/Forms/AllItems.aspx.

Localizarea paginii principale

Pentru a examina controalele serverului web CSS în SharePoint, trebuie să obțineți o copie a paginii master care este utilizată pe site. Dar pentru a descărca o copie a paginii master pentru site-ul tău, trebuie să știi ce pagină master folosește site-ul tău.

Utilizați una sau mai multe dintre următoarele pentru a determina ce pagină principală folosește site-ul dvs.:

• Pe un site SharePoint Server 2010 în care funcțiile de publicare sunt activate și activate, accesați pagina Setări pagina principală a site-ului prin Acțiuni site,  .Pagină principală , dați clic pe linkul Aspect și simțire. Apoi, sub secțiunea Setări, Site

• În loc să utilizați meniul pentru a localiza pagina Setări pagina principală a site-ului, adăugați următorul fragment de adresă URL la sfârșitul adresei serverului pentru site-ul dvs.: /_layouts/ChangeSiteMasterPage.aspx; de exemplu, https://contoso.com/\_ layouts/ChangeSiteMasterPage.aspx

• Pe un site SharePoint Foundation, puteți utiliza Windows PowerShell pentru a determina ce pagină principală folosește site-ul, așa cum se arată în Figura 4. Următorul este un exemplu de script.

  PowerShell

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

Figura 4. v4.master pe un site de echipă SharePoint

Tabelul 4 listează toate controalele serverului web care sunt legate de CSS și care sunt disponibile în SharePoint Server. Puteți găsi aceste controale în spațiul de nume Microsoft.SharePoint.WebControls, care face parte din ansamblul Microsoft.SharePoint.dll.

Tabelul 4. Controalele serverului web CSS în SharePoint 2010

Extindeți tabelul

Următoarele secțiuni descriu fiecare control care este listat în Tabelul 4 și rezumă beneficiile fiecăruia.

CSSLink

Controlul web CSSLink se află în paginile master SharePoint și este responsabil pentru redarea codului HTML <LINK> element. Controlul CSSLink funcționează cu controalele CSSRegistration. Dacă există controale CSSRegistration pe pagină, controlul CSSLink înregistrează și redă referințele suplimentare ale fișierelor CSS pe care le face controlul de înregistrare.

Controlul CSSLink are următorii membri:

• UUIVersion (opțional) — Permite proprietarilor de site-uri să schimbe aspectul și aspectul unui site SharePoint actualizat sau migrat. Activează previzualizarea site-ului în interfața de utilizator SharePoint sau în interfața de utilizator Microsoft Office SharePoint Server (MOSS) 2007. Setați valoarea la 4 pentru SharePoint și setați-o la 3 pentru site-urile MOSS 2007.

• Versiune (opțional) — Supliniază versiunea de control a clasei SPControl.

• Alternativ (opțional) — Semnalizează dacă CSS-ul de bază (Core.css sau Corev4.css) este redat cu alte referințe la fișiere CSS sau este redat un CSS alternativ. Valoarea implicită este False, care specifică faptul că fișierul de bază css (core.css sau corev4.css) este randat.

• DefaultUrl (opțional) — Setează sau obține adresa URL implicită care este utilizată pentru fișierul CSS.

  Următorul exemplu arată cum ar putea fi redat acest control.

  HTML

  <link rel="foaia de stil" tip="text/css" href="/_layouts/1033/styles/Themable/search.css?rev=Uoc0fsLIo87aYwT%2FGX5UPw%3D%3D"/> <link rel="foaia de stil" tip="text/css" href="/_layouts/1033/styles/Themable/wiki.css?rev=9pXM9jgtUVYAHk21JOAbIw%3D%3D"/> <link rel="foaia de stil" tip="text/css" href="/_layouts/1033/styles/Themable/corev4.css?rev=iIikGkMuXBs8CWzKDAyjsQ%3D%3D"/>

Controlul CSSLink adaugă un parametru șir de interogare ?rev= la referința fișierului pentru a controla stocarea în cache a browserului și pentru a forța browserul să ia o nouă copie a fișierului.

Controlul CSSLink este, de asemenea, responsabil pentru comportamentele descrise în secțiunea următoare.

Înregistrare CSS

Controlul web CSSRegistration este utilizat cu controlul CSSLink pentru a înregistra fișiere CSS, astfel încât acestea să poată fi redate pe pagină. Înregistrați fișierele CSS după adresa URL relativă sau statică.

Controlul CSSRegistration are următorii membri:

• Nume (obligatoriu) — Numele fișierului de înregistrat. Dacă numele nu este furnizat, SharePoint afișează eroarea prezentată în Figura 5. Valoarea proprietății Nume ar trebui să fie un nume de fișier sau o adresă URL. Dacă se folosește un nume de fișier, fișierul CSS trebuie să existe în folderul LAYOUTS Style.

  Următorul exemplu arată cum să utilizați fișierul custom.css care a fost menționat mai sus și care a fost implementat în folderul Stiluri (C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS\{Locale- ID}\STYLES).

  XAML

  <SharePoint:CssRegistration runat="server" Name="custom.css" />

  Următorul exemplu arată modul în care controlul CSSLink redă înregistrarea custom.css.

  HTML

  <link rel="foaia de stil" tip="text/css" href="/_layouts/1033/styles/custom.css?rev=pFayZ3XaoWhaMymtxOLHNA%3D%3D"/>

  Pe lângă referirea la un fișier care se află în directorul LAYOUTS\{Locale ID}\Styles, puteți înregistra un fișier utilizând o adresă URL. Specificați o singură adresă URL în proprietatea Nume utilizând simboluri. Unele indicative URL binecunoscute sunt: ​​~site, ~sitecollection și ~language. Utilizați aceste jetoane împreună cu un generator de expresii, cum ar fi SPUrl. Indicatorul ~language se mapează la un șir de cultură de limbă, cum ar fi en-us.

  Adăugarea unei intrări similare cu exemplul următor...

  XAML

  <SharePoint:CssRegistration Name="<%$ SPUrl:~sitecollection/Style Library/~language/Custom/2ndcustom.css %>" runat="server" />

  … generează următorul HTML, așa cum se arată în Figura 5.

  HTML

  <link rel="foaia de stil" tip="text/css" href="/Style%20Library/en-US/Custom/2ndcustom.css"/>

Figura 5. Eroare de pagină SharePoint

• După (opțional) — Specifică ordinea de redare a fișierului CSS pe care îl înregistrați. De exemplu, dacă doriți să randați o foaie de stil personalizată care este numită custom.css după core4.css, utilizați următorul cod pentru a configura controlul de înregistrare.

  XAML

  <SharePoint:CssRegistration Name="<%$ SPUrl:~sitecollection/Style Library/~language/Custom/2ndcustom.css %>" runat="server" După="core4.css" />

  Făcând acest lucru, forțează controlul web CSSLink să redeze fișierul personalizat după linkul fișierului core4.css.

  HTML

  <link rel="foaia de stil" tip="text/css" href="/_layouts/1033/styles/Themable/corev4.css?rev=iIikGkMuXBs8CWzKDAyjsQ%3D%3D"/> <link rel="foaia de stil" tip="text/css" href="/Style%20Library/en-US/Custom/2ndcustom.css"/>

   Notă

  Puteți utiliza generatorul de expresii SPUrl numai pe site-urile SharePoint Server; nu este disponibil în SharePoint Foundation.

• EnableCSSSTheming — Semnalizează dacă doriți ca foile dvs. de stil să fie tematice, ceea ce înseamnă că pot fi aplicate ca parte a temelor SharePoint personalizate.

  • Setați proprietatea EnableCSSSTheming a controlului CSSRegistration la true.

  • Adăugați comentarii tematice la clasele dvs. de stil CSS. Pentru a vedea câteva exemple, examinați directorul Tematic care este instalat cu SharePoint (C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14 \TEMPLATE\LAYOUTS\{Locale-ID}\STYLES\Themable).

    Următorul exemplu arată clasa CSS ms-toolbar în Themable Corev4.css. Dacă aplicați o temă, de fiecare dată când este utilizată clasa ms-toolbar, tema înlocuiește culoarea #0072BC cu culoarea temei Hyperlink care este definită în tema însăși.

    .ms-toolbar{ font-family:verdana; dimensiunea fontului: 8pt; text-decor:niciuna; /* [ÎnlocuieșteColor(themeColor:"Hyperlink")] */ color:#0072BC; }

• ConditionalExpression — Folosit pentru a specifica dacă se aplică această foaie de stil pentru o anumită versiune de browser. De exemplu, o valoare a IE 9.0 specifică faptul că înregistrarea este aplicată pentru versiunea 9.0 a Internet Explorer. Controlul CSSLink detectează valoarea.

Temă

Controlul serverului web Temă aplică o temă unui site SharePoint. Există mai multe instrumente disponibile pe care le puteți folosi pentru a crea teme; de exemplu Theme Builder pe Microsoft Connect. După ce creați o temă (fișiere .thmx), o încărcați în galeria Teme , care se află pe pagina Setări (/_catalogs/theme/ Forms/AllItems.aspx). Pentru a aplica o temă, accesați pagina Tema site-ului (/_layouts/themeweb.aspx).

Următorul este un exemplu.

HTML

<link rel="foaia de stil" tip="text/css" href="/_catalogs/theme/Themed/54E2D43/search-7E1AFF02.css?ctag=1"/> <link rel="foaia de stil" tip="text/css" href="/_catalogs/theme/Themed/54E2D43/wiki-ECF524AA.css?ctag=1"/> <link rel="foaia de stil" tip="text/css" href="/_catalogs/theme/Themed/54E2D43/corev4-8A0ABD2F.css?ctag=1"/>

Atunci când aplicați o temă, SharePoint creează un nou folder de temă care include toate fișierele CSS și imagine necesare pentru redarea temei. Noul dosar cu teme nu apare în Setări site sau în Vedeți tot conținutul. Folosind SharePoint Designer, puteți vizualiza fișierele cu teme, așa cum se arată în Figura 6.

Figura 6. Teme SharePoint