SharePoint 2010 中的樣式庫內容

SharePoint 中的 CSS Web 控制項

Web 伺服器控制項負責管理和呈現 CSS 文件連結和樣式表。預設情況下，Web 伺服器控制項位於 SharePoint 母版頁中。若要尋找母版頁，請在 母版頁和頁面版面配置庫中尋找，或在 SharePoint Foundation 中的母版頁庫中尋找。庫的相對路徑是 /_catalogs/masterpage/Forms/AllItems.aspx。

找到母版頁

若要檢查 SharePoint 中的 CSS Web 伺服器控件，您必須取得網站上使用的母版頁的副本。但要下載您網站的母版頁副本，您必須知道您的網站使用哪個母版頁。

使用以下一項或多項來確定您的網站使用的母版頁：

• 在啟用並啟動了發佈功能的SharePoint Server 2010 網站上，透過 網站操作造訪「網站母版頁設定」頁面，  鏈接.母版頁 部分下，點擊 外觀和感覺。然後，在 設定、 網址

• 不要使用選單來尋找「網站母版頁設定」頁面，而是將以下 URL 片段附加到網站伺服器位址的末端：/_layouts/ChangeSiteMasterPage.aspx；例如，https://contoso.com/\_layouts/ChangeSiteMasterPage.aspx

• 在 SharePoint Foundation 網站上，您可以使用 Windows PowerShell 來確定網站使用的母版頁，如圖 4 所示。以下是範例腳本。

  電源外殼

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

圖 4. SharePoint 團隊網站上的 v4.master

表 4 列出了與 CSS 相關且在 SharePoint Server 中可用的所有 Web 伺服器控制項。您可以在 Microsoft.SharePoint.WebControls 命名空間中找到這些控制項，該命名空間是 Microsoft.SharePoint.dll 組件的一部分。

表 4. SharePoint 2010 中的 CSS Web 伺服器控制項

展開表格

以下部分描述了表 4 中列出的每個控制，並總結了每個控制的優點。

CSS連結

CSSLink Web 控制項位於 SharePoint 母版頁中，負責呈現 HTML

CSSLink 控制項有以下成員：

• UIVersion（可選）- 允許網站所有者更改升級或遷移的 SharePoint 網站的外觀和風格。在 SharePoint 使用者介面或 Microsoft Office SharePoint Server (MOSS) 2007 使用者介面中啟用網站預覽。對於 SharePoint，將該值設為 4；對於 MOSS 2007 網站，將該值設為 3。

• 版本（可選）— 覆蓋 SPControl 類別的控製版本。

• 替代（可選）- 標記是否使用其他 CSS 檔案引用呈現核心 CSS（Core.css 或 Corev4.css），或呈現替代 CSS。預設值為 False，指定渲染核心 css（core.css 或 corev4.css）檔案。

• DefaultUrl（可選）— 設定或取得用於 CSS 檔案的預設 URL。

  以下範例顯示了該控制項的呈現方式。

  超文本標記語言

CSSLink 控制項將 ?rev= 查詢字串參數新增到檔案引用中，以控制瀏覽器快取並強制瀏覽器取得檔案的新副本。

CSSLink 控制項也負責下一節中所描述的行為。

CSS註冊

CSSRegistration Web 控制項與 CSSLink 控制項一起使用來註冊 CSS 文件，以便可以在頁面上呈現它們。透過相對或靜態 URL 註冊 CSS 檔案。

CSSRegistration 控制項有下列成員：

• 名稱（必填）— 要註冊的檔案名稱。如果未提供名稱，SharePoint 將引發如圖 5 所示的錯誤。Name 屬性的值應該是檔案名稱或 URL。如果使用檔案名，則 CSS 檔案必須存在於 LAYOUTS Style 資料夾中。

  以下範例示範如何使用上面所引用的並部署至 Styles 資料夾 (C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14\TEMPLATE\LAYOUTS\{Locale- ID}\樣式）。

  XAML

  >

  以下範例顯示 CSSLink 控制項如何呈現 custom.css 註冊。

  超文本標記語言

  除了引用位於 LAYOUTS\{Locale ID}\Styles 目錄中的檔案之外，您還可以使用 URL 註冊檔案。使用標記在 Name 屬性中指定單一 URL。一些著名的 URL 標記是：~site、~sitecollection 和~language。將這些標記與表達式產生器（例如 SPUrl）一起使用。 ~language 標記會對應到語言文化字串，例如 en-us。

  新增類似以下範例的條目...

  XAML

  ” runat="伺服器" >>

  ....產生以下 HTML，如圖 5 所示。

  超文本標記語言

圖 5. SharePoint 頁面錯誤

• 之後（可選）— 指定您正在註冊的 CSS 檔案的渲染順序。例如，如果要渲染一個在 core4.css 之後命名為 custom.css 的自訂樣式表，則可以使用下列程式碼來配置註冊控制項。

  XAML

  ” runat="伺服器"之後=“core4.css” >>

  執行此操作會強制 CSSLink Web 控制項在 core4.css 檔案連結之後呈現您的自訂檔案。

  超文本標記語言

   筆記

  您只能在 SharePoint Server 網站上使用表達式產生器 SPUrl；它在 SharePoint Foundation 中不可用。

• EnableCSSTheming — 標記您是否希望樣式表具有主題功能，這表示它們可以作為自訂 SharePoint 主題的一部分套用。

  • 將 CSSRegistration 控制項的 EnableCSSTheming 屬性設為 true。

  • 為您的 CSS 樣式類別新增主題註解。若要查看一些範例，請檢查隨 SharePoint 安裝的 Themable 目錄 (C:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\14 \ TEMPLATE\LAYOUTS\{Locale-ID}\STYLES\Themable)。

    以下範例顯示了 Themable Corev4.css 中的 ms-toolbar CSS 類別。如果套用主題，則每次使用 ms-toolbar 類別時，主題都會將顏色 #0072BC 替換為主題本身中定義的超連結主題顏色。

    .ms-toolbar{ 字型系列：verdana;字體大小：8pt；文字裝飾：無； /* [ReplaceColor(themeColor:「超連結」)] */ color:#0072BC; }

• ConditionalExpression — 用於指定是否將此樣式表套用至特定的瀏覽器版本。例如，值 IE 9.0 指定註冊適用於 Internet Explorer 版本 9.0。 CSSLink 控制項可偵測該值。

主題

主題 Web 伺服器控制項將主題套用至 SharePoint 網站。有多種工具可用於建立主題；例如 Microsoft Connect 上的主題產生器。建立主題（.thmx 檔案）後，將其上傳到 主題 圖庫，該庫位於「設定」頁面 (/_catalogs/theme/表單/AllItems .aspx）。若要套用主題，請造訪「網站主題」頁面 (/_layouts/themeweb.aspx)。

下面是一個例子。

超文本標記語言

套用主題時，SharePoint 會建立一個新的主題資料夾，其中包含呈現主題所需的所有 CSS 和圖像檔案。新主題資料夾不會出現在 網站設定 或 查看所有內容。透過使用SharePoint Designer，您可以查看主題文件，如圖6所示。

圖 6. SharePoint 主題