跳至主要内容
版本: v8

ion-item-sliding

滑动项目包含一个可以拖动的项目,以显示选项按钮。它需要一个 项目 组件作为子项。要显示的所有选项应放置在 项目选项 元素中。

基本用法

滑动项目选项默认放置在项目的 "end" 侧。这意味着当项目从末尾到开头滑动时,选项会显示,即在 LTR 中从右到左滑动,但在 RTL 中从左到右滑动。要将它们放置在相反的一侧,以便它们在向相反方向滑动时显示,请在 项目选项 元素上将 side 属性设置为 "start"。为了根据滑动方向显示两组不同的选项,最多可以使用两个项目选项。

图标选项

当图标与 项目选项 中的文本并排放置时,默认情况下它会将图标显示在文本上方。可以将图标上的插槽更改为任何可用的 项目选项插槽 以更改其位置。

可扩展选项

如果您滑动超过一定点,选项可以扩展以占据父 ion-item 的全部宽度。这可以与 项目选项 上的 ionSwipe 事件结合使用,以便在项目完全滑动时调用方法。

接口

ItemSlidingCustomEvent

虽然不是必需的,但此接口可用于代替 CustomEvent 接口,以实现从该组件发出的 Ionic 事件的更强类型。

interface ItemSlidingCustomEvent extends CustomEvent {
target: HTMLIonItemSlidingElement;
}

属性

disabled

描述如果为 true,则用户无法与滑动项目进行交互。
属性disabled
类型boolean
默认false

事件

名称描述冒泡
ionDrag滑动位置发生变化时发出。true

方法

close

描述关闭滑动项目。也可以从 列表 关闭项目。
签名close() => Promise<void>

closeOpened

描述关闭列表中的所有滑动项目。也可以从 列表 关闭项目。
签名closeOpened() => Promise<boolean>

getOpenAmount

描述获取项目以像素为单位的打开量。
签名getOpenAmount() => Promise<number>

getSlidingRatio

描述获取项目打开量与选项宽度的比率。如果返回的数字为正,则右侧的选项处于打开状态。如果返回的数字为负,则左侧的选项处于打开状态。如果数字的绝对值大于 1,则项目打开的程度超过选项的宽度。
签名getSlidingRatio() => Promise<number>

open

描述打开滑动项目。
签名open(side: Side | undefined) => Promise<void>

CSS 阴影部分

此组件没有可用的 CSS 阴影部分。

CSS 自定义属性

此组件没有可用的 CSS 自定义属性。

插槽

此组件没有可用的插槽。