opichon/autotabs

JQuery 插件,用于从页面标记中生成标签页

安装: 57

依赖关系: 0

建议者: 0

安全性: 0

星标: 3

关注者: 2

分支: 1

开放问题: 0

语言:JavaScript

类型:jquery-plugin

2.1.3 2015-10-20 04:21 UTC

This package is auto-updated.

Last update: 2024-08-29 03:57:59 UTC


README

jquery.autotabs.js 会自动根据应用到的 DOM 元素中的标记生成标签页。

为指定元素中的每个子元素创建一个标签页。可以自定义用于生成标签页的子元素。

向页面添加一组可导航的标签页。标签页的位置可自定义。

每个标签页可以包含静态或动态内容。

请参阅 docs/index.html 中的演示/文档。

要求

  • jQuery >= 1.9.1

如果您希望 autotabs 记住标签页的状态,您还需要 jQuery.cookie 插件

  • jquery.cookie.js: >= 1.4

安装

通过 bower 安装

将以下行添加到您的 bower.json 配置文件中

  "dependencies": {
    "autotabs": "~2.0",
  }

下载

或者从以下地址下载

设置

javascripts

    <script src="../dist/js/jquery.js"></script>
    <script src="../dist/js/jquery.cookie.js"></script>    <!-- optional -->
    <script src="../dist/js/jquery.autotabs.min.js"></script>

stylesheets

    <link rel="stylesheet" type="text/css" href="../dist/css/jquery.autotabs.min.css" />

对于垂直标签页,请包含提供的自定义样式表

    <link rel="stylesheet" type="text/css" href="../dist/css/jquery.autotabs.vertical.min.css" />

将以下逻辑添加到您的页面或添加到页面中的插件

$( "#mytabs" ).autotabs(/* { options } */));

标记选项

可以在标记中直接配置标签页设置。以下属性被支持

data-autotabs-label

标签页标签。

data-autotabs-url

标签页内容的远程 URL。

title

标签页标签。

此属性已被 data-autotabs-label 属性取代,可能在未来的版本中删除。

rel (已弃用)

标签页内容的远程 URL。

此属性已被 data-autotabs-url 属性取代,可能在未来的版本中删除。

如何使用

通过 AJAX 动态加载标签页内容

只需将标签页内容的 URL 设置为 data-autotabs-url 属性。

使用 Bootstrap 样式化标签页

要使用 Bootstrap 样式表样式标签页,请使用以下选项

tabs_class: "nav nav-tabs",
tab_class: null,
active_class: "active"

将标签页样式化为药丸形状

tabs_class: "nav nav-pills",
tab_class: null,
active_class: "active"

插件选项

tab_pane_selector

定义用于标识标签页的选择器。

默认值: div, section, .tab-pane

tab_label_selector

定义用于从标签页元素的元素中标识标签标签/标题的选择器。

默认值: h1, h2, h3, h4

tabs_class

为生成的标签元素设置 CSS 类。

默认值: autotabs

tab_class

为每个生成的标签元素设置 CSS 类。

默认值: autotab

tabs_selector

用于标识生成的标签应附加到的元素的选择器。

默认值: none

active_class

为当前选定的标签添加 CSS 类。

默认值: current

active_tab

插件加载时设置为活动的标签的索引。

默认值: null

cookie_name

在其中存储标签页状态的 cookie 的名称。此选项需要 jQuery.cookie.js 插件。

默认值: active_tab

cookie_path

设置 cookie 的路径。此选项需要 jQuery.cookie.js 插件。

默认值: /

force_refresh

在点击时强制刷新每个标签。

默认值: false

tab_orphans

是否将单个(孤立)的 tab-pane 作为标签处理。

默认值: false

loading_icon

包含加载图标元素的 selector。

默认值: #loading

tab_id

一个负责在标记中未提供时生成标签ID的函数。

默认值

function( id ) { return "__" + id; }

tab_label

一个负责在标记中未提供时生成每个标签的函数。

默认值

function( index ) { return "Tab " + ( index + 1 ); },

tab_pane_id

一个负责在标记中未提供时生成每个标签面板ID的函数。

默认值

function( index ) { return "___" + ( index + 1 ); },

vertical

是否垂直对齐标签。

默认值:false

success

定义当点击标签时应用的回调函数。此选项可以是

  • 一个函数,在这种情况下,它应用于所有标签
  • 一个对象,其中属性是标签的ID,值是作为该标签回调函数的函数。

所有函数都应用于标签面板元素。因此,this 指的是标签面板元素。