API jQuery UI - Widget Tabs
Catégorie
Utilisation
Description :Une seule zone de contenu avec plusieurs panneaux, chaque panneau étant associé à un en-tête dans une liste.
Version ajoutée :1.0
Les onglets sont généralement utilisés pour diviser le contenu en plusieurs sections pouvant être permutées afin d'économiser de l'espace, un peu comme un accordéon.
Les onglets ont une exigence de balisage spécifique qui doit être respectée pour que les onglets fonctionnent :
- Les onglets doivent se trouver dans une liste ordonnée (
<ol>) ou non ordonnée (<ul>). - Le "titre" de chaque onglet doit être à l'intérieur d'un élément de liste (
<li>), et doit être enveloppé avec une ancre ayant unhrefattribut (<a>). - Chaque panneau d'onglet peut être n'importe quel élément valide, mais il doit avoir un id qui correspond au hash dans l'ancre de l'onglet associé.
Le contenu de chaque onglet peut être défini dans la page, ou chargé via Ajax. Ces deux cas sont automatiquement gérés en fonction de l'ancre associée à l'onglethrefsont gérés automatiquement. Par défaut, les onglets sont activés au clic, mais cela peut être modifié ou remplacé via leeventoption.
Voici un exemple de balisage :
<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>
Interaction au clavier
Lorsque le focus est sur un onglet, les commandes clavier suivantes sont disponibles :
- UP/LEFT : déplace le focus vers l’onglet précédent. Si le focus est sur le premier onglet, le déplace vers le dernier onglet. Active l’onglet ayant le focus après un court délai.
- DOWN/RIGHT : déplace le focus vers l’onglet suivant. Si le focus est sur le dernier onglet, le déplace vers le premier onglet. Active l’onglet ayant le focus après un court délai.
- HOME : déplace le focus vers le premier onglet. Active l’onglet ayant le focus après un court délai.
- END : déplace le focus vers le dernier onglet. Active l’onglet ayant le focus après un court délai.
- SPACE : active le panneau associé à l’onglet ayant le focus.
- ENTER : active ou bascule le panneau associé à l’onglet ayant le focus.
- ALT+PAGE UP : déplace le focus vers l’onglet précédent et l’active immédiatement.
- ALT+PAGE DOWN : déplace le focus vers l’onglet suivant et l’active immédiatement.
Lorsque le focus est sur un panneau, les commandes clavier suivantes sont disponibles :
- CTRL+UP : déplace le focus vers l'onglet associé.
- ALT+PAGE UP : déplace le focus vers l’onglet précédent et l’active immédiatement.
- ALT+PAGE DOWN : déplace le focus vers l’onglet suivant et l’active immédiatement.
Thèmes
Le widget Tabs utilise lejQuery UI CSS Frameworkpour définir ses styles d'apparence et de convivialité. Si vous devez utiliser des styles spécifiques aux onglets, les noms de classes CSS suivants peuvent être utilisés :
ui-tabs: Le conteneur externe des onglets. Lorsque l'collapsibleoption est définie, cet élément aura en plus unui-tabs-collapsibleclasse。ui-tabs-nav: La liste des onglets.- L'élément de liste actif dans la navigation aura une
ui-tabs-activeclasse. Les éléments de liste dont le contenu est chargé via Ajax auront uneui-tabs-loadingclasse。ui-tabs-anchor: L'ancre utilisée pour basculer entre les panneaux.
- L'élément de liste actif dans la navigation aura une
ui-tabs-panel: Le panneau associé à l'onglet. Il n'est visible que lorsque son onglet correspondant est actif.
Dépendances
- Noyau UI
- Fabrique de widgets
- Effects Core(facultatif ; lorsqu'il est utilisé avec le
showethideoption)
Notes supplémentaires
- Ce widget nécessite du CSS fonctionnel, sinon il ne fonctionnera pas. Si vous créez un thème personnalisé, utilisez le fichier CSS spécifique au widget comme point de départ.
Exemples
Un simple composant à onglets 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>
Autres extensions