• α堆栈 α
  • 应用提供商
  • 自动完成
  • 《阿凡达》
  • 徽章
  • 横幅
  • 流血 α
  • 盒子 α
  • 按钮
  • 按钮组
  • Callout卡
  • 标题 弃用
  • 复选框
  • 选择列表
  • 可折叠的
  • 颜色选择器
  • α
  • 组合框
  • 上下文保存栏
  • 数据表
  • 日期选择器
  • 描述表
  • 显示文本 弃用
  • 降落区
  • 空的状态
  • 例外列表
  • 过滤器
  • 页脚的帮助
  • 形式
  • 表格布局
  • 框架
  • 全屏酒吧
  • 网格 α
  • 标题 弃用
  • 图标
  • 索引表
  • 内联 α
  • 内联错误
  • 键盘键
  • 布局
  • 链接
  • 列表
  • 列表框
  • 加载
  • 媒体卡
  • 模态
  • 导航
  • 选项列表
  • 页面
  • 页面动作
  • 分页
  • 弹出窗口
  • 进度条
  • 单选按钮
  • 滑块范围
  • 资源项目
  • 资源列表
  • 可滚动
  • 选择
  • 设置切换
  • 弃用
  • 正文正文
  • 骨架显示文本
  • 框架页面
  • 骨架的标签
  • 骨架缩略图
  • 微调控制项
  • 堆栈
  • 副标题 弃用
  • 选项卡
  • 标签
  • 文本 β
  • 文本容器
  • 文本字段
  • 文本样式 弃用
  • 缩略图
  • 烤面包
  • 工具提示
  • 窗口的顶部
  • 视频缩略图
  • 视觉上隐藏 弃用
  • 令牌
  • 图标
  • 贡献
  • 沙盒 α
  • 过滤器

    Filters是一个复合组件,用于过滤列表或表中的项。

    进口ChoiceList文本框RangeSliderResourceList过滤器《阿凡达》文本“@shopify /北极星”进口useStateuseCallback“反应”函数ResourceListFiltersExample常量accountStatussetAccountStatususeState常量moneySpentsetMoneySpentuseState常量taggedWithsetTaggedWithuseState常量queryValuesetQueryValueuseState常量handleAccountStatusChangeuseCallback价值= >setAccountStatus价值常量handleMoneySpentChangeuseCallback价值= >setMoneySpent价值常量handleTaggedWithChangeuseCallback价值= >setTaggedWith价值常量handleFiltersQueryChangeuseCallback价值= >setQueryValue价值常量handleAccountStatusRemoveuseCallback= >setAccountStatus常量handleMoneySpentRemoveuseCallback= >setMoneySpent常量handleTaggedWithRemoveuseCallback= >setTaggedWith常量handleQueryValueRemoveuseCallback= >setQueryValue常量handleFiltersClearAlluseCallback= >handleAccountStatusRemovehandleMoneySpentRemovehandleTaggedWithRemovehandleQueryValueRemovehandleAccountStatusRemovehandleMoneySpentRemovehandleQueryValueRemovehandleTaggedWithRemove常量过滤器关键“accountStatus”标签“账户状态”过滤器<ChoiceList标题“账户状态”titleHidden选择标签“启用”价值“启用”标签没有被邀请的价值没有被邀请的标签“邀请”价值“邀请”标签“拒绝”价值“拒绝”选择accountStatus||onChangehandleAccountStatusChangeallowMultiple/>快捷方式真正的关键“taggedWith”标签“标记”过滤器<文本字段标签“标记”价值taggedWithonChangehandleTaggedWithChange自动完成“关闭”labelHidden/>快捷方式真正的关键“moneySpent”标签“花费”过滤器<RangeSlider标签“钱花在了之间”labelHidden价值moneySpent||0500前缀“$”输出最小0马克斯2000一步1onChangehandleMoneySpentChange/>常量appliedFilters如果isEmptyaccountStatus常量关键“accountStatus”appliedFilters关键标签disambiguateLabel关键accountStatusonRemovehandleAccountStatusRemove如果isEmptymoneySpent常量关键“moneySpent”appliedFilters关键标签disambiguateLabel关键moneySpentonRemovehandleMoneySpentRemove如果isEmptytaggedWith常量关键“taggedWith”appliedFilters关键标签disambiguateLabel关键taggedWithonRemovehandleTaggedWithRemove返回<div风格高度“568 px”><><ResourceList resourceName单数“客户”复数“客户”filterControl<过滤器queryValuequeryValue过滤器过滤器appliedFiltersappliedFiltersonQueryChangehandleFiltersQueryChangeonQueryClearhandleQueryValueRemoveonClearAllhandleFiltersClearAll/>项目id341url“客户/ 341”的名字“美Jemison”位置美国迪凯特的id256url“客户/ 256”的名字“艾伦·奥乔亚”位置“美国洛杉矶”renderItem= >常量idurl的名字位置常量媒体<客户规模“媒介”的名字的名字/>返回<ResourceList项ididurlurl媒体媒体accessibilityLabel查看详细信息$ {的名字><文本作为“h3”变体“bodyMd”fontWeight“大胆”>的名字</文本><div>位置</div></ResourceList>/></></div>函数disambiguateLabel关键价值开关关键情况下“moneySpent”返回花的钱在$$ {价值0和$$ {价值1情况下“taggedWith”返回标记$ {价值情况下“accountStatus”返回价值地图瓦尔= >客户$ {瓦尔加入”、“默认的返回价值函数isEmpty价值如果数组isArray价值返回价值长度= = =0其他的返回价值= = =||价值= =

    道具

    想要帮助完善这个功能吗?请<!-- -->分享你的反馈

    接口<!-- --> FiltersProps<!-- -->
    queryValue? 字符串

    查询字段中当前输入的文本。

    queryPlaceholder? 字符串

    查询字段的占位符文本。

    集中? 布尔

    查询字段是否集中。

    过滤器 []

    将可用过滤器添加到工作表中。快捷过滤器暴露在工作表的外部。

    appliedFilters? []

    应用的过滤器被呈现为标签。使用相应的键调用remove回调函数。

    onQueryChange queryValue字符串) = >无效

    当查询字段被更改时返回。

    onQueryClear () = >无效

    当clear按钮被触发时。

    onClearAll () = >无效

    当全部重置按钮被按下时回调。

    onQueryBlur? () = >无效

    当查询字段模糊时返回。

    onQueryFocus? () = >无效

    当查询字段集中时调用。

    孩子们? 反应ReactNode

    要与控件内联显示的内容。

    禁用? 布尔

    禁用所有过滤器。

    helpText? 任何

    要在过滤器下面显示的其他提示文本。

    hideTags? 布尔

    隐藏应用过滤器的标记。

    hideQueryField? 布尔

    隐藏查询字段。

    disableQueryField? 布尔

    禁用查询字段。

    商家使用过滤器:

    • 在列表或表格中查看项目的不同子集
    • 通过输入文本字段进行过滤
    • 通过选择过滤器或提升过滤器进行过滤

    商家与过滤器交互的方式取决于您决定合并的组件。在最简单的形式中,过滤器包括一个文本字段和一组过滤器,它们可以以不同的方式显示。例如,您可以显示提升过滤器和一个More按钮,打开一个包含更多的过滤器。过滤器是什么以及它们如何暴露给商家是灵活的。


    可访问性

    filters组件依赖于多个其他组件的可访问性特性:

    使用自定义功能维护可访问性

    由于自定义HTML可以传递给组件以进行其他操作,因此要确保构建的过滤系统整体上是可访问的。

    所有商户必须:

    • 能够识别和理解所有控件的标签
    • 收到状态更改的通知
    • 能够用键盘完成所有操作

    最佳实践

    filters组件应该:

    • 通过推广最常用的过滤类别,帮助减少商家的工作
    • 包含不超过2到3个推广过滤器
    • 在为每个过滤器和要包含的过滤器总数设计界面时,考虑较小的屏幕尺寸
    • 只对与过滤相关的内容使用子元素

    内容的指导方针

    文本字段

    文本字段应该被清晰地标记,这样商家就可以很明显地进入该字段。

    • 过滤器订单

    • 在这里输入文本

    过滤器徽章

    如果筛选器名称本身的用途很明确,则使用该名称。例如,当您看到一个过滤器徽章,上面写着实现了,很直观地,它属于履行状态类别。

    • 完成,实现

    • 实现:实现,未实现

    如果筛选器名称本身不明确,请添加与状态相关的描述性单词。例如,断章取义是说不通的。添加单词“风险”,这样商家就知道它来自风险类别。

    • 高风险,低风险

    • 高,低

    将来自同一类别的标签分组在一起。

    • (未实现,完成)

    • (未实现)(完成)

    如果所有标签丸都被选中:在中间截断

    • 有报酬,没有报酬

    • 所有支付状态过滤器选择,已支付,未付款…