diff --git a/packages/devui-vue/docs/components/carousel/index.md b/packages/devui-vue/docs/components/carousel/index.md index ad99fbec7e541aaacd77c9e2e9b0b18564cd9250..c1f645078840da51f8b7ca494f2237527bec32da 100644 --- a/packages/devui-vue/docs/components/carousel/index.md +++ b/packages/devui-vue/docs/components/carousel/index.md @@ -7,116 +7,128 @@ 1. 用于展示图片或者卡片。 ### 基本用法 - - {{ item }} - - -```html - - {{ item }} - -``` -```css + +:::demo + +```vue + + + ``` + +::: + ### 指示器&切换箭头 -arrowTrigger设为always可以使箭头永久显示,dotTrigger设为hover可以使hover到点上就切换。 - - {{ item }} - +arrowTrigger 设为 always 可以使箭头永久显示,dotTrigger 设为 hover 可以使 hover 到点上就切换。 -```html - - {{ item }} - -``` -### 自动轮播 - - {{ item }} - - -```html - - {{ item }} - -``` -### 自定义操作 - - {{ item }} - - - -```html - - {{ item }} - - -``` -```css -.carousel-demo-operate{ - margin-top: 10px; +:::demo - display: flex; - align-items: center; +```vue + + + ``` -### API -#### 参数 +::: -| 参数 | 类型 | 默认值 | 描述 | 跳转 Demo | -| :----------: | :--------------------------: | :------: | :---------------------------------------------- | ------------------------------------------------ | -| arrowTrigger | `'hover'\|'never'\|'always'` | 'hover' | 可选,指定切换箭头显示方式 | [指示器&切换箭头](#指示器切换箭头) | -| autoplay | `boolean` | false | 可选,是否自动轮播 | [自动轮播](#自动轮播) | -| autoplaySpeed | `number` | 3000 | 可选,配合`autoplay`使用,自动轮播速度,单位 ms | [自动轮播](#自动轮播) | -| height | `string` | '100%' | 可选,轮播容器高度 | [基本用法](#基本用法) | -| showDots | `boolean` | true | 可选,是否显示面板指示器 | [自动轮播](#自动轮播) | -| dotPosition | `'top'\|'bottom'` | 'bottom' | 可选,面板指示器位置 | [指示器&切换箭头](#指示器切换箭头) | -| dotTrigger | `'click'\|'hover'` | 'click' | 可选,指示器触发轮播方式 | [指示器&切换箭头](#指示器切换箭头) | -| activeIndex | `number` | 0 | 可选,初始化激活卡片索引,从 0 开始,支持`[(activeIndex)]`双向绑定 | [基本用法](#基本用法) | +### 自动轮播 -#### 事件 +:::demo -| 事件 | 类型 | 描述 | 跳转 Demo | -| :----------------: | :---------------------: | :-----------------------------------------: | ------------------------------------------------- | -| activeIndexChange | `EventEmitter` | 卡片切换时,返回当前卡片的索引,从0开始 | [基本用法](#基本用法) | +```vue + + + +``` -| 方法 | 描述 | 跳转 Demo | -| :---------: | :---------------------------------- | :----------------------------- | -| prev() | 切换到上一张卡片 | [自定义操作](#自定义操作) | -| next() | 切换到下一张卡片 | [自定义操作](#自定义操作) | -| goTo(index) | 切换到指定索引的卡片,索引从 0 开始 | [自定义操作](#自定义操作) | +::: +### 自定义操作 +:::demo + +```vue + - +``` - display: flex; - align-items: center; +::: - > * { - margin-right: 20px; - } -} - \ No newline at end of file +### API + +#### 参数 + +| 参数 | 类型 | 默认值 | 描述 | 跳转 Demo | +| :-----------: | :--------------------------: | :------: | :----------------------------------------------------------------- | ----------------------------------- | +| arrowTrigger | `'hover'\|'never'\|'always'` | 'hover' | 可选,指定切换箭头显示方式 | [指示器&切换箭头](#指示器-切换箭头) | +| autoplay | `boolean` | false | 可选,是否自动轮播 | [自动轮播](#自动轮播) | +| autoplaySpeed | `number` | 3000 | 可选,配合`autoplay`使用,自动轮播速度,单位 ms | [自动轮播](#自动轮播) | +| height | `string` | '100%' | 可选,轮播容器高度 | [基本用法](#基本用法) | +| showDots | `boolean` | true | 可选,是否显示面板指示器 | [自动轮播](#自动轮播) | +| dotPosition | `'top'\|'bottom'` | 'bottom' | 可选,面板指示器位置 | [指示器&切换箭头](#指示器-切换箭头) | +| dotTrigger | `'click'\|'hover'` | 'click' | 可选,指示器触发轮播方式 | [指示器&切换箭头](#指示器-切换箭头) | +| activeIndex | `number` | 0 | 可选,初始化激活卡片索引,从 0 开始,支持`[(activeIndex)]`双向绑定 | [基本用法](#基本用法) | + +#### 事件 + +| 事件 | 类型 | 描述 | 跳转 Demo | +| :---------------: | :--------------------: | :---------------------------------------: | --------------------- | +| activeIndexChange | `EventEmitter` | 卡片切换时,返回当前卡片的索引,从 0 开始 | [基本用法](#基本用法) | + +#### 方法 + +| 方法 | 描述 | 跳转 Demo | +| :---------: | :---------------------------------- | :------------------------ | +| prev() | 切换到上一张卡片 | [自定义操作](#自定义操作) | +| next() | 切换到下一张卡片 | [自定义操作](#自定义操作) | +| goTo(index) | 切换到指定索引的卡片,索引从 0 开始 | [自定义操作](#自定义操作) |