Title: List Item Filter
Author: zachwtx
Published: <strong>2016 年 10 月 14 日</strong>
Last modified: 2016 年 12 月 2 日

---

搜索插件

**该插件尚未通过WordPress的最新3个主要版本进行测试**。 当与较新版本的WordPress一起
使用时，可能不再受到维护或支持，并且可能会存在兼容性问题。

![](https://ps.w.org/list-item-filter/assets/icon-256x256.png?rev=1515037)

# List Item Filter

 作者：[zachwtx](https://profiles.wordpress.org/zachwtx/)

[下载](https://downloads.wordpress.org/plugin/list-item-filter.1.4.zip)

 * [详情](https://cn.wordpress.org/plugins/list-item-filter/#description)
 * [评价](https://cn.wordpress.org/plugins/list-item-filter/#reviews)
 *  [安装](https://cn.wordpress.org/plugins/list-item-filter/#installation)
 * [开发进展](https://cn.wordpress.org/plugins/list-item-filter/#developers)

 [支持](https://wordpress.org/support/plugin/list-item-filter/)

## 描述

This plugin provides a shortcode that generates a text input field, which filters
out list items that do not contain that field’s text. Any sibling elements of the
shortcode, or children of those siblings, that are “li” elements will be searched
by the text field it generates. As you type, each word in the text field is matched
against the readable text of the list items (and optionally their title attributes).
Any list items which don’t match that text are hidden.

Example: `[list_item_filter placeholder="Filter this list by terms" searchtitles
="true"]`

Shortcode parameters:

 * **label** (string): Define the search field’s label text. _Default value: Filter
   list items:_
 * **showlabel** (boolean): Determine whether or not the search field’s label is
   visible. _Default value: true_
 * **placeholder** (string): Define the search field’s placeholder text. _Default
   value: Search_
 * **noresultsmsg** (string): Define the message shown when no list items are found.
   Provide an empty string to disable this feature. _Default value: no results_
 * **searchtitles** (bool): Expand text matching to include the first title attribute
   of the list item’s HTML. _Default value: false_
 * **formclass** (string): Define one or more class names for the form. _Default
   value: search-form_
 * **inputclass** (string): Define one or more class names for the search field.
   _Default value: search-field_

If you like this plugin or have a request, let me know!

## 安装

Upload the plugin to your blog, activate it, then use the shortcode in a page or
post!

## 评价

![](https://secure.gravatar.com/avatar/44d246b54cc8b38cc59f183ee903cdbe95c2705c9aaa4aea6ae4a2280eb31abf?
s=60&d=retro&r=g)

### 󠀁[I find it usefull](https://wordpress.org/support/topic/i-find-it-usefull/)󠁿

 [andrew72nd](https://profiles.wordpress.org/andrew72nd/) 2017 年 4 月 21 日

I used it in a internal server webpage to ease the content finding in some long 
lists. One thing I noticed: when I erase the searching key-phrase it shows the full
list. when I click on the x button it shows only the filtered results. I would expect
to show the full list since it erases the key-phrase. but it’s working nce!

 [ 阅读所有1条评价 ](https://wordpress.org/support/plugin/list-item-filter/reviews/)

## 贡献者及开发者

「List Item Filter」是开源软件。 以下人员对此插件做出了贡献。

贡献者

 *   [ zachwtx ](https://profiles.wordpress.org/zachwtx/)

[帮助将「List Item Filter」翻译成简体中文。](https://translate.wordpress.org/projects/wp-plugins/list-item-filter)

### 对开发感兴趣吗?

您可以[浏览代码](https://plugins.trac.wordpress.org/browser/list-item-filter/)，
查看[SVN仓库](https://plugins.svn.wordpress.org/list-item-filter/)，或通过[RSS](https://plugins.trac.wordpress.org/log/list-item-filter/?limit=100&mode=stop_on_copy&format=rss)
订阅[开发日志](https://plugins.trac.wordpress.org/log/list-item-filter/)。

## 更新日志

#### Version 1.4

 * Add label parameter for defining label text
 * Show search field label
 * Add showlabel parameter to allow users to hide the search field label
 * Add magnifying glass icon to search box to improve accessibility
 * Add aria-describedby text to search box to improve accessibility, informing screen
   reader users of what will happen to the page’s content when they type in the 
   box

#### Version 1.3

 * Fix text input case matching issue

#### Version 1.2

 * Add label to search field to improve accessibility
 * Add notes to Javascript
 * Improve readability of documentation
 * Add tags

#### Version 1.1

 * Add message informing users that no items were found that matched their text
 * Add noresultsmsg parameter so users can customize the text displayed when no 
   matching items are found
 * Rename data attribute for searchtitles parameter
 * Add class names to items for show and hide states
 * Change visibility manipulation to remove inline styling in favor of a stylesheet

#### Version 1.0

 * Provide shortcode parameters for class names, placeholder text, and searching
   title attributes
 * Refactor Javascript to allow multiple instances per page
 * Ensure Javascript file is only added to page when shortcode is in use
 * Add support for IE9 placeholder attribute

## 额外信息

 *  版本 **1.4**
 *  最后更新：**10 年前**
 *  活跃安装数量 **10+**
 *  WordPress 版本 ** 2.5 或更高版本 **
 *  已测试的最高版本为 **4.6.30**
 *  语言
 * [English (US)](https://wordpress.org/plugins/list-item-filter/)
 * 标签
 * [filter](https://cn.wordpress.org/plugins/tags/filter/)[javascript](https://cn.wordpress.org/plugins/tags/javascript/)
   [list](https://cn.wordpress.org/plugins/tags/list/)[search](https://cn.wordpress.org/plugins/tags/search/)
   [shortcode](https://cn.wordpress.org/plugins/tags/shortcode/)
 *  [高级视图](https://cn.wordpress.org/plugins/list-item-filter/advanced/)

## 评级

 5 星（最高 5 星）。

 *  [  1 条 5 星评价     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=5)
 *  [  0 条 4 星评价     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=4)
 *  [  0 条 3 星评价     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=3)
 *  [  0 条 2 星评价     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=2)
 *  [  0 条 1 星评价     ](https://wordpress.org/support/plugin/list-item-filter/reviews/?filter=1)

[Your review](https://wordpress.org/support/plugin/list-item-filter/reviews/#new-post)

[查看全部评论](https://wordpress.org/support/plugin/list-item-filter/reviews/)

## 贡献者

 *   [ zachwtx ](https://profiles.wordpress.org/zachwtx/)

## 支持

有话要说吗？是否需要帮助？

 [查看支持论坛](https://wordpress.org/support/plugin/list-item-filter/)