jQuery UI API - Виджет Tabs

Категория

Виджеты

Использование

Описание:Единая область содержимого с несколькими панелями, каждая панель связана с заголовком в списке.

Добавлено в версии:1.0

Вкладки обычно используются для разбиения содержимого на несколько разделов, которые можно переключать для экономии места, во многом как аккордеон.

Вкладки имеют особые требования к разметке, которые необходимо соблюдать, чтобы вкладки работали:

  • Вкладки должны находиться внутри упорядоченного (<ol>) или неупорядоченного (<ul>) списка.
  • "Заголовок" каждой вкладки должен находиться внутри элемента списка (<li>), и должен быть обернут в якорь, имеющийhrefатрибут (<a>).
  • Каждая панель вкладки может быть любым допустимым элементом, но она должна иметь id, соответствующий хешу в якоре связанной вкладки.

Содержимое каждой панели вкладки может быть определено на странице или загружено через Ajax. И то, и другое автоматически обрабатывается на основе связанного с вкладкой якоряhrefобрабатываются автоматически. По умолчанию вкладки активируются по щелчку, но это можно изменить или переопределить с помощьюeventпараметр.

Ниже приведён пример разметки:

<div id="tabs">
  <ul>
    <li><a href="../index.html">一</a></li>
    <li><a href="../index.html">二</a></li>
    <li><a href="../index.html">三</a></li>
  </ul>
  <div id="fragment-1">
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
  </div>
  <div id="fragment-2">
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
  </div>
  <div id="fragment-3">
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
  </div>
</div>

Взаимодействие с клавиатурой

Когда фокус находится на вкладке, доступны следующие клавиатурные команды:

  • UP/LEFT: Перемещает фокус на предыдущую вкладку. Если фокус на первой вкладке, перемещает фокус на последнюю вкладку. Активирует вкладку, находящуюся в фокусе, через короткую задержку.
  • DOWN/RIGHT: Перемещает фокус на следующую вкладку. Если фокус на последней вкладке, перемещает фокус на первую вкладку. Активирует вкладку, находящуюся в фокусе, через короткую задержку.
  • HOME: Перемещает фокус на первую вкладку. Активирует вкладку, находящуюся в фокусе, через короткую задержку.
  • END: Перемещает фокус на последнюю вкладку. Активирует вкладку, находящуюся в фокусе, через короткую задержку.
  • SPACE: Активирует панель, связанную с вкладкой, находящейся в фокусе.
  • ENTER: Активирует или переключает панель, связанную с вкладкой, находящейся в фокусе.
  • ALT+PAGE UP: Перемещает фокус на предыдущую вкладку и сразу активирует её.
  • ALT+PAGE DOWN: Перемещает фокус на следующую вкладку и сразу активирует её.

Когда фокус находится на панели, доступны следующие клавиатурные команды:

  • CTRL+UP: перемещает фокус на связанную вкладку.
  • ALT+PAGE UP: Перемещает фокус на предыдущую вкладку и сразу активирует её.
  • ALT+PAGE DOWN: Перемещает фокус на следующую вкладку и сразу активирует её.

Темы оформления

Виджет вкладок используетjQuery UI CSS Frameworkдля определения стилей внешнего вида и поведения. Если вам нужно использовать стили, специфичные для вкладок, можно использовать следующие имена CSS-классов:

  • ui-tabs: Внешний контейнер вкладок. Когдаcollapsibleопция установлена, этот элемент дополнительно будет иметьui-tabs-collapsible класс.
    • ui-tabs-nav: Список вкладок.
      • Активный элемент списка в навигации будет иметьui-tabs-activeкласс. Элементы списка, содержимое которых загружается через Ajax, будут иметьui-tabs-loading класс.
        • ui-tabs-anchor: Якорь, используемый для переключения панелей.
    • ui-tabs-panel: Панель, связанная с вкладкой. Она видна только тогда, когда соответствующая вкладка активна.

Зависимости

Дополнительные примечания

  • Для этого виджета требуется некоторый функциональный CSS, иначе он не будет работать. Если вы создаёте собственную тему, используйте CSS-файл, специфичный для виджета, в качестве отправной точки.

Примеры

Простой виджет вкладок jQuery UI.

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>标签页部件(Tabs Widget)演示</title>
  <link rel="stylesheet" href="//code.jquery.com/ui/1.10.4/themes/smoothness/jquery-ui.css">
  <script src="//code.jquery.com/jquery-1.10.2.js"></script>
  <script src="//code.jquery.com/ui/1.10.4/jquery-ui.js"></script>
</head>
<body>
 
<div id="tabs">
  <ul>
    <li><a href="../index.html"><span>一</span></a></li>
    <li><a href="../index.html"><span>二</span></a></li>
    <li><a href="../index.html"><span>三</span></a></li>
  </ul>
  <div id="fragment-1">
    <p>第一个标签是默认激活的:</p>
    <code>$( "#tabs" ).tabs(); </code>
  </div>
  <div id="fragment-2">
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
  </div>
  <div id="fragment-3">
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
    Lorem ipsum dolor sit amet, consectetuer adipiscing elit, sed diam nonummy nibh euismod tincidunt ut laoreet dolore magna aliquam erat volutpat.
  </div>
</div>
 
<script>
$( "#tabs" ).tabs();
</script>
 
</body>
</html>

Другие расширения