Съдържание на библиотеката за стилове в 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/\_ layouts/ChangeSiteMasterPage.aspx

• На сайт на SharePoint Foundation можете да използвате Windows PowerShell, за да определите каква главна страница използва сайтът, както е показано на Фигура 4. Следното е примерен скрипт.

  PowerShell

  $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, и обобщават предимствата на всяка.

CSSLink

Уеб контролата CSSLink е в главните страници на SharePoint и отговаря за изобразяването на HTML <LINK> елемент. Контролата CSSLink работи с контролите CSSRegistration. Ако на страницата има контроли CSSRegistration, контролата 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 файла.

  Следващият пример показва как тази контрола може да се визуализира.

  HTML

  <link rel="stylesheet" тип="текст/css" href="/_layouts/1033/styles/Themable/search.css?rev=Uoc0fsLIo87aYwT%2FGX5UPw%3D%3D"/> <link rel="stylesheet" тип="текст/css" href="/_layouts/1033/styles/Themable/wiki.css?rev=9pXM9jgtUVYAHk21JOAbIw%3D%3D"/> <link rel="stylesheet" тип="текст/css" href="/_layouts/1033/styles/Themable/corev4.css?rev=iIikGkMuXBs8CWzKDAyjsQ%3D%3D"/>

Контролата CSSLink добавя параметър на низ на заявка ?rev= към препратката към файла, за да контролира кеширането на браузъра и да принуди браузъра да вземе ново копие на файла.

Контролата CSSLink също е отговорна за поведението, описано в следващия раздел.

CSSReгистрация

Уеб контролата CSSRegistration се използва с контролата CSSLink за регистриране на CSS файлове, така че да могат да бъдат изобразени на страницата. Регистрирайте CSS файлове по относителен или статичен URL адрес.

Контролът на CSSRegistration има следните членове:

• Име (задължително) — Името на файла за регистриране. Ако името не е предоставено, SharePoint извежда грешката, показана на фигура 5. Стойността на свойството Name трябва да бъде име на файл или URL адрес. Ако се използва име на файл, CSS файлът трябва да съществува в папката LAYOUTS Style.

  Следващият пример показва как да използвате файла custom.css, който е споменат по-горе и който е внедрен в папката Styles (C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS\{Locale- ID}\СТИЛОВЕ).

  XAML

  <SharePoint:CssRegistration runat="сървър" Име="custom.css" />

  Следващият пример показва как контролата CSSLink изобразява custom.css регистрацията.

  HTML

  <link rel="stylesheet" тип="текст/css" href="/_layouts/1033/styles/custom.css?rev=pFayZ3XaoWhaMymtxOLHNA%3D%3D"/>

  В допълнение към препратката към файл, който се намира в директорията LAYOUTS\{Locale ID}\Styles, можете да регистрирате файл, като използвате URL. Посочете един URL адрес в свойството Name, като използвате токени. Някои добре познати URL токени са: ~site, ~sitecollection и ~language. Използвайте тези токени заедно със създател на изрази, като например SPUrl. Токенът ~language се преобразува в низ за езикова култура, като en-us.

  Добавяне на запис, подобен на следния пример...

  XAML

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

  ... генерира следния HTML, както е показано на фигура 5.

  HTML

  <link rel="stylesheet" тип="текст/css" href="/Style%20Library/en-US/Custom/2ndcustom.css"/>

Фигура 5. Грешка в страницата на SharePoint

• След (по избор) — Указва реда на изобразяване на CSS файла, който регистрирате. Например, ако искате да изобразите персонализиран стилов лист, който е наречен custom.css след core4.css, вие използвате следния код, за да конфигурирате контрола за регистрация.

  XAML

  <SharePoint:CssRegistration Name="<%$ SPUrl:~sitecollection/Style Library/~language/Custom/2ndcustom.css %>" runat="сървър" След="core4.css" />

  Правейки това, принуждава уеб контролата на CSSLink да изобрази персонализирания ви файл след връзката към файла core4.css.

  HTML

  <link rel="stylesheet" тип="текст/css" href="/_layouts/1033/styles/Themable/corev4.css?rev=iIikGkMuXBs8CWzKDAyjsQ%3D%3D"/> <link rel="stylesheet" тип="текст/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).

    Следващият пример показва CSS класа ms-toolbar в Themable Corev4.css. Ако приложите тема, всеки път, когато се използва класът ms-toolbar, темата замества цвета #0072BC с цвета на темата за хипервръзка, който е дефиниран в самата тема.

    .ms-toolbar{ font-family:verdana; размер на шрифта:8pt; текст-декорация:няма; /* [ReplaceColor(themeColor:"Hyperlink")] */ цвят:#0072BC; }

• ConditionalExpression — Използва се за указване дали да се приложи този стилов лист за конкретна версия на браузъра. Например стойност на IE 9.0 указва, че регистрацията се прилага за Internet Explorer версия 9.0. Контролата CSSLink открива стойността.

Тема

Контролата на уеб сървъра на темата прилага тема към сайт на SharePoint. Има няколко налични инструмента, които можете да използвате за създаване на теми; например Theme Builder в Microsoft Connect. След като създадете тема (.thmx файлове), вие я качвате в галерията Теми , която се намира на страницата с настройки (/_catalogs/theme/ Forms/AllItems.aspx). За да приложите тема, отворете страницата за тема на сайта (/_layouts/themeweb.aspx).

Следното е пример.

HTML

<link rel="stylesheet" тип="текст/css" href="/_catalogs/theme/Themed/54E2D43/search-7E1AFF02.css?ctag=1"/> <link rel="stylesheet" тип="текст/css" href="/_catalogs/theme/Themed/54E2D43/wiki-ECF524AA.css?ctag=1"/> <link rel="stylesheet" тип="текст/css" href="/_catalogs/theme/Themed/54E2D43/corev4-8A0ABD2F.css?ctag=1"/>

Когато приложите тема, SharePoint създава нова папка с тема, която включва всички CSS и файлове с изображения, необходими за изобразяване на темата. Папката с новата тема не се показва в Настройки на сайта или в Преглед на цялото съдържание. Като използвате SharePoint Designer, можете да преглеждате файлове с теми, както е показано на фигура 6.

Фигура 6. Теми на SharePoint