Skip to content

SortButton 排序按钮

用于展示排序按钮,支持升序、降序、重置三种状态。

组件类型

基本用法

使用 v-model 绑定当前排序状态,取值为 -101,分别表示降序、重置状态、升序。

html
<wd-sort-button v-model="value" title="价格" @change="handleChange" />
ts
const value = ref(0)

function handleChange({ value }) {
  console.log(value)
}

组件变体

允许重置

设置 allow-reset 后,排序按钮可回到重置状态。

html
<wd-sort-button v-model="value" title="价格" allow-reset />

优先切换为降序

设置 desc-first 后,首次切换优先进入降序。

html
<wd-sort-button v-model="value" title="价格" desc-first />

组件样式

显示下划线

设置 line 显示下划线。

html
<wd-sort-button v-model="value" title="价格" line />

Attributes

参数说明类型默认值
model-value / v-model当前排序方向值,1 表示升序,0 表示重置状态,-1 表示降序SortButtonValue0
title排序按钮文案string''
allow-reset是否允许重置为未选中状态booleanfalse
desc-first是否优先切换为降序booleanfalse
line是否显示下划线booleanfalse
custom-class根节点自定义类名string''
custom-style根节点自定义样式string''

Events

事件名称说明参数
change排序方向变化时触发{ value }

主题定制

CSS 变量

组件提供了下列 CSS 变量,可用于自定义样式,使用方法请参考 ConfigProvider 全局配置

名称默认值描述
--wot-sort-button-height$n-48组件高度
--wot-sort-button-text-font-size$typography-body-size-main文字字号
--wot-sort-button-text-line-height$typography-body-line--height-size-main文字行高
--wot-sort-button-arrow-icon-size$n-24箭头图标尺寸
--wot-sort-button-right-size$n-16右侧区域尺寸
--wot-sort-button-icon-color$icon-auxiliary图标颜色
--wot-sort-button-icon-color-active$primary-6图标激活颜色
--wot-sort-button-color$text-secondary文字颜色
--wot-sort-button-color-active$text-main文字激活颜色
--wot-sort-button-font-weight-active$font-weight-medium文字激活字重
--wot-sort-button-line-width$n-24下划线宽度
--wot-sort-button-line-height$n-4下划线高度
--wot-sort-button-line-color$primary-6下划线颜色
--wot-sort-button-line-bottom$spacing-ultra-tight下划线底部距离
--wot-sort-button-right-spacing-left$spacing-extra-tight右侧区域左间距
--wot-sort-button-sort-spacing$spacing-ultra-tight排序图标纵向间距

源代码

文档
组件

Released under the MIT License.

Released under the MIT License.