@10up/component-tabs 中文文档教程

发布于 3年前 浏览 22 项目主页 更新于 3年前

10up Tabs component

选项卡组件基于并扩展了人们在 Simply Accessible 所做的工作。 它是一个精简但仍可访问的 UI 选项卡版本。 它们可通过键盘访问且用户友好,旨在作为您在项目中使用的起点。

Installation

NPM

npm install --save @10up/component-tabs

Standalone

克隆这个 repo 并从 dist 导入 tabs.jstabs.css / 目录。

API

该组件接受两个参数,选项卡容器的选择器和包含可选回调的对象。

Callbacks

  • onCreate: Called after the tabs are initialized on page load
  • onTabChange: Called after a tab has been changed

Usage

Markup

这是组件期望的标记模板。

<div class="tabs">
    <div class="tab-control">
        <ul class="tab-list" role="tablist">
            <li class="tab-item"><button role="tab" aria-controls="js-tab1">View Tab 1</button></li>
            <li class="tab-item"><button role="tab" aria-controls="js-tab2">View Tab 2</button></li>
        </ul>
    </div>
    <div class="tab-group">
        <div class="tab-content" id="js-tab1" role="tabpanel">
            <h2>Tab 1 Content</h2>
            <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
        </div>
        <div class="tab-content" id="js-tab2" role="tabpanel">
            <h2>Tab 2 Content</h2>
            <p>In tincidunt tempor risus gravida tincidunt.</p>
        </div>
    </div>
</div>

CSS

这些样式可以通过使用 PostCSS 导入或通过在您的项目中包含独立的 CSS 文件来导入到您现有的代码库中。

PostCSS Imports

@import "@10up/component-tabs";

Standalone

包含 dist/ 目录中的 tabs.css 文件。

JavaScript

通过提供用于选项卡的选择器和包含任何必要回调函数的对象来创建新实例。

NPM

import Tabs from '@10up/component-tabs';

new Tabs( '.tabs', {
    onCreate: function() {
        console.log( 'onCreate callback' );
    },
    onTabChange: function() {
        console.log( 'onTabChange callback' );
    }
} );

Standalone

<script src="unpkg.com/@10up/component-tabs@2.0.0/index.umd.js"></script>
let myTabs = new TenUp.tabs( '.tabs', {
    onCreate: function() {
        console.log( 'onCreate callback' );
    },
    onTabChange: function() {
        console.log( 'onTabChange callback' );
    }
} );

Demo

可以在 demo 目录中找到示例实现。

Support Level

活跃:10up 正在为此积极努力,我们希望在可预见的未来继续努力,包括保持对最新版本 WordPress 的测试。 欢迎错误报告、功能请求、问题和请求请求。

Like what you see?

10up 与我们一起工作

10up Tabs component

The tabs component is based on and extended from work done by the folks over at Simply Accessible. It is a stripped down, but still accessible version of UI tabs. They are keyboard accessible and user friendly and are meant to be a starting point for you to use on a project.

Installation

NPM

npm install --save @10up/component-tabs

Standalone

Clone this repo and import tabs.js and tabs.css from the dist/ directory.

API

This component accepts two arguments, the selector for the tab container and an object containing optional callbacks.

Callbacks

  • onCreate: Called after the tabs are initialized on page load
  • onTabChange: Called after a tab has been changed

Usage

Markup

This is the markup template expected by the component.

<div class="tabs">
    <div class="tab-control">
        <ul class="tab-list" role="tablist">
            <li class="tab-item"><button role="tab" aria-controls="js-tab1">View Tab 1</button></li>
            <li class="tab-item"><button role="tab" aria-controls="js-tab2">View Tab 2</button></li>
        </ul>
    </div>
    <div class="tab-group">
        <div class="tab-content" id="js-tab1" role="tabpanel">
            <h2>Tab 1 Content</h2>
            <p>Lorem ipsum dolor sit amet, consectetur adipiscing elit.</p>
        </div>
        <div class="tab-content" id="js-tab2" role="tabpanel">
            <h2>Tab 2 Content</h2>
            <p>In tincidunt tempor risus gravida tincidunt.</p>
        </div>
    </div>
</div>

CSS

The styles can be imported into your existing codebase by using PostCSS imports, or by including the standalone CSS file in your project.

PostCSS Imports

@import "@10up/component-tabs";

Standalone

Include the tabs.css file from the dist/ directory.

JavaScript

Create a new instance by supplying the selector to use for the tabs and an object containing any necessary callback functions.

NPM

import Tabs from '@10up/component-tabs';

new Tabs( '.tabs', {
    onCreate: function() {
        console.log( 'onCreate callback' );
    },
    onTabChange: function() {
        console.log( 'onTabChange callback' );
    }
} );

Standalone

<script src="unpkg.com/@10up/component-tabs@2.0.0/index.umd.js"></script>
let myTabs = new TenUp.tabs( '.tabs', {
    onCreate: function() {
        console.log( 'onCreate callback' );
    },
    onTabChange: function() {
        console.log( 'onTabChange callback' );
    }
} );

Demo

Example implementations can be found in the demo directory.

Support Level

Active: 10up is actively working on this, and we expect to continue work for the foreseeable future including keeping tested up to the most recent version of WordPress. Bug reports, feature requests, questions, and pull requests are welcome.

Like what you see?

Work with us at 10up

    我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
    原文