基本用法

u-tabs 是一个选项卡组件,通过在 <u-tabs> 标签中插入多个 <u-tab> 标签来实现多个选项卡之间的切换。每个 <u-tab> 标签作为一个选项卡,可以设置标题和对应的内容。

下面是一个基本的示例:

<u-tabs :current="currentTab" @change="tabChange">
  <u-tab title="Tab 1">Content 1</u-tab>
  <u-tab title="Tab 2">Content 2</u-tab>
  <u-tab title="Tab 3">Content 3</u-tab>
</u-tabs>

在这个示例中,currentTab 是当前选中的选项卡索引值,通过 @change 事件监听选项卡的切换。

属性讲解

1. current

  • 类型:Number
  • 默认值:0

该属性指定当前选中的选项卡的索引值,可以使用 v-model 进行双向绑定。

2. duration

  • 类型:Number
  • 默认值:300

该属性设置选项卡切换动画的时长,单位为毫秒。

3. easing-function

  • 类型:String
  • 默认值:"ease-out"

该属性设置选项卡切换动画的缓动函数,可选的值包括 "linear"、"ease"、"ease-in"、"ease-out"、"ease-in-out" 等。

4. swipeable

  • 类型:Boolean
  • 默认值:true

该属性指定是否启用滑动切换选项卡的功能。当设置为 true 时,用户可以通过左右滑动手势来切换选项卡。

5. animation

  • 类型:String
  • 默认值:无

该属性配置选项卡切换的动画效果。可以设置为 "slide"(左右滑动切换)、"fade"(淡入淡出切换)或自定义动画名称(需要在全局样式中定义)。

事件讲解

1. @change

该事件在选项卡切换时触发。通过回调函数的参数可以获取当前选中的选项卡索引值。

<u-tabs :current="currentTab" @change="tabChange">
  <!-- ... -->
</u-tabs>
methods: {
  tabChange(index) {
    console.log('当前选中的选项卡索引:', index);
  }
}

Slot 插槽

1. u-tab

用于放置单个选项卡的内容,可以在 <u-tab> 标签内部插入任意内容。

<u-tabs :current="currentTab">
  <u-tab title="Tab 1">
    <div>Content 1</div>
    <p>More content...</p>
  </u-tab>
  <u-tab title="Tab 2">
    <!-- Content for Tab 2 -->
  </u-tab>
</u-tabs>

2. u-tabs-left

在左侧插入额外的内容。可以在 <u-tabs-left> 标签内部插入其他组件或标签。

<u-tabs :current="currentTab">
  <u-tabs-left>
    <!-- Insert additional content on the left -->
  </u-tabs-left>
  <u-tab title="Tab 1">Content 1</u-tab>
  <u-tab title="Tab 2">Content 2</u-tab>
</u-tabs>

3. u-tabs-right

在右侧插入额外的内容。可以在 <u-tabs-right> 标签内部插入其他组件或标签。

<u-tabs :current="currentTab">
  <u-tab title="Tab 1">Content 1</u-tab>
  <u-tab title="Tab 2">Content 2</u-tab>
  <u-tabs-right>
    <!-- Insert additional content on the right -->
  </u-tabs-right>
</u-tabs>

以上是对于 UniApp 组件 u-tabs 的详细讲解。通过使用 u-tabs 组件,您可以轻松地创建具有选项卡切换功能的界面。

Logo

旨在为数千万中国开发者提供一个无缝且高效的云端环境,以支持学习、使用和贡献开源项目。

更多推荐