Практическое руководство. Настройка внешнего вида серверных веб-элементов управления SiteMapPath
Обновлен: Ноябрь 2007
Внешний вид элементов управления структуры переходов веб-узла можно настроить, задав атрибуты элемента управления или настроив шаблоны, доступные для этого элемента управления. Шаблоны и стили применяются к ссылкам в соответствии с двумя правилами приоритета, которые описаны в подразделе «Примечания» раздела SiteMapPath.
Также можно применить к элементу управления тему или обложку элемента управления, или же разработать пользовательские элементы управления для структуры переходов веб-узла, удовлетворяющие требованиям, предъявляемым к отрисовке. Дополнительные сведения о применении тем к веб-элементам управления см. в разделе Практическое руководство. Настройка элемента управления CreateUserWizard ASP.NET.
Элемент управления SiteMapPath отображает путь перехода, при котором ссылки отображаются в виде обратного пути с текущей страницы на домашнюю страницу этого веб-узла. На странице ASP.NET элемент управления SiteMapPath отображает примерно следующую информацию:
Домашняя страница > Услуги > Обучение
Элементы управления TreeView и Menu также обеспечивают визуализацию данных карты веб-узла. Кроме того, как и элемент управления SiteMapPath, эти элементы управления можно настраивать, как и большинство других веб-элементов управления. В этом разделе описано, как использовать следующие функции настройки серверного веб-элемента управления SiteMapPath:
Определение знаков или изображений, отображаемых между ссылками.
Изменение направления пути перехода.
Определение числа отображаемых родительских ссылок.
В рамках процедур данного раздела предполагается, что уже была создана карта веб-узла и страница, содержащая элемент управления SiteMapPath. Можно использовать файл Web.sitemap из примера, приведенного в разделе Карты узла ASP.NET.
Настройка свойств стиля ссылок
В код веб-страницы ASP.NET, которая содержит элемент управления SiteMapPath, добавьте к этому элементу управления следующие свойства:
RootNodeStyle-Font-Names="Verdana" RootNodeStyle-ForeColor="Orange" RootNodeStyle-BorderWidth=2
К примеру, код элемента управления SiteMapPath может выглядеть следующим образом:
<asp:SiteMapPath ID="SiteMapPath1" Runat="server" SkipLinkText="Skip Menu" RootNodeStyle-Font-Names="Verdana" RootNodeStyle-ForeColor="Orange" RootNodeStyle-BorderWidth=2 > </asp:SiteMapPath>
Доступна большая часть свойств, описанных в классах Style и FontInfo, включая свойство CssClass.
Если необходимо, чтобы стили каждой из ссылок отличались друг от друга, повторите предыдущие шаги в отношении свойств ParentNodeStyle, CurrentNodeStyle и PathSeperatorStyle элемента управления SiteMapPath.
Примечание. Чтобы повысить производительность, можно использовать шаблон NodeTemplate для настройки стиля всех ссылок сразу. Дополнительные сведения см. в разделе Шаблоны серверных веб-элементов управления ASP.NET.
Настройка знака, отображаемого между ссылками
В код веб-страницы ASP.NET, которая содержит элемент управления SiteMapPath, добавьте к этому элементу управления свойство PathSeparator.
К примеру, код элемента управления SiteMapPath может выглядеть следующим образом:
<asp:SiteMapPath ID="SiteMapPath1" Runat="server" PathSeparator=" :: "> </asp:SiteMapPath>
Элемент управления SiteMapPath будет отображать примерно следующую информацию:
Домашняя страница :: Услуги :: Обучение
Для разделения ссылок можно использовать любую строку, но для того, чтобы использовать для этого изображение, необходимо выполнить следующую процедуру.
Определение изображения, отображаемого между ссылками
В код веб-страницы ASP.NET, которая содержит элемент управления SiteMapPath, добавьте к этому элементу управления следующие строки кода:
<PathSeparatorTemplate> <asp:Image ID="Image1" Runat="Server" Width="20" ImageUrl="Images/PathSeparatorImage.jpg" /> </PathSeparatorTemplate> </PathSeparatorTemplate>
К примеру, код элемента управления SiteMapPath может выглядеть следующим образом:
<asp:SiteMapPath ID="SiteMapPath1" Runat="server" > <PathSeparatorTemplate> <asp:Image ID="Image1" Runat="Server" Width="20" ImageUrl="Images/PathSeparatorImage.jpg" /> </PathSeparatorTemplate> </PathSeparatorTemplate> </asp:SiteMapPath>
Изменение направления пути, отображаемого элементом управления SiteMapPath
В код веб-страницы ASP.NET, которая содержит элемент управления SiteMapPath, добавьте к этому элементу управления свойства PathDirection и PathSeparator.
К примеру, код элемента управления SiteMapPath может выглядеть следующим образом:
<asp:SiteMapPath ID="SiteMapPath1" Runat="server" PathDirection="CurrentToRoot" PathSeparator=" <-- " > </asp:SiteMapPath>
Ограничение числа отображаемых родительских ссылок
В код веб-страницы ASP.NET, которая содержит элемент управления SiteMapPath, добавьте к этому элементу управления свойство ParentLevelsDisplayed.
К примеру, код элемента управления SiteMapPath, который будет отображать не более двух родительских ссылок, может выглядеть следующим образом:
<asp:SiteMapPath ID="SiteMapPath1" Runat="server" ParentLevelsDisplayed="2" > </asp:SiteMapPath>
Специальные возможности
Элементы управления структуры переходов веб-узла обычно используются на каждой странице веб-узла. Средства чтения с экрана и другие вспомогательные устройства читают вслух текст элемента управления переходами во время каждого посещения страницы и после каждой обратной передачи.
Элементы управления SiteMapPath, TreeView, и Menu структуры переходов веб-узла включают свойство SkipLinkText, которое позволяет пропускать повторяющуюся информацию на последующих страницах или на разных представлениях одной и той же страницы.
Использование функции пропуска в составе специальных возможностей
В код веб-страницы ASP.NET, которая содержит элемент управления переходами, добавьте к этому элементу управления следующее свойство:
SkipLinkText="Skipped Menu"
К примеру, код элемента управления SiteMapPath может выглядеть следующим образом:
<asp:SiteMapPath ID="SiteMapPath1" Runat="server" SkipLinkText="Skip Breadcrumb"> </asp:SiteMapPath>
См. также
Задачи
Практическое руководство. Настройка элемента управления CreateUserWizard ASP.NET
Основные понятия
Общие сведения об структуре переходов веб-узла ASP.NET
Шаблоны серверных веб-элементов управления ASP.NET
Общие сведения о серверном веб-элементе управления SiteMapPath
Настройка внешнего вида и поведения серверного веб-элемента управления TreeView
Безопасность системы навигации веб-узла ASP.NET