react filter search
1.0.0
这是一个小型、不显眼的 React 组件,用于过滤客户端应用程序数据。
npm i react-filter-search
yarn add react-filter-search
React Filter Search 只是一个需要应用程序状态数据的组件(需要是一个object
array
和一个输入值。反过来,你会得到......
该数据以renderResults
的形式回流,这是一个返回上述内容之一的渲染道具。因此,您将负责设置传入数据和输入值。
通过这种方式,React Filter Search 对于如何存储数据以及如何处理应用程序中的用户输入没有任何意见。 ?
//
/*-Other Imports-*/
//
import FilterResults from 'react-filter-search' ;
class App extends Component {
constructor ( props ) {
super ( props ) ;
this . state = {
data : [ ] ,
value : ''
} ;
}
componentWillMount ( ) {
fetch ( 'https://jsonplaceholder.typicode.com/users' )
. then ( response => response . json ( ) )
. then ( json => this . setState ( { data : json } ) ) ;
}
handleChange = event => {
const { value } = event . target ;
this . setState ( { value } ) ;
} ;
render ( ) {
const { data , value } = this . state ;
return (
< div >
< input type = "text" value = { value } onChange = { this . handleChange } / >
< SearchResults
value = { value }
data = { data }
renderResults = { results => (
< div >
{ results . map ( el => (
< div >
< span > { el . name } < / span >
< span > { el . email } < / span >
< / div >
) ) }
< / div >
) }
/ >
< / div >
) ;
}
}
神奇的事情发生在renderResults
中,它返回一个对象数组。您的数据要么已根据用户输入进行过滤,要么没有过滤。
过滤逻辑将迭代数据结构中任何级别的嵌套。这意味着对此的一个很好的建议是诸如用户数据或待办事项之类的内容,这些内容在许多级别上都没有大量嵌套。
如果您希望仅使用某些属性进行过滤,那么您可以使用可选的pick
属性。
// if each object is of the form
var obj = { name : "Leanne Graham" , username : "Bret" , email : "[email protected]" , company : { "name" : "Romaguera-Crona" } }
< SearchResults
. . .
pick = { [ 'username' , 'company.name' ] }
...
/ >
// your objects will be filtered only with the name and company.name fields
// but you can still render other values like username and email
要渲染数据,只需使用 .map() 渲染到视图 - 数据保留在相同的结构中。返回一些内联 JSX,或者将每个元素输入到呈现一些 UI 的无状态 React 组件中。
props
姓名 | 类型 | 必需的? |
---|---|---|
value | string | true |
data | object array s | true |
renderResults | func | true |
pick | string s 的array | false |
阅读CONTRIBUTING.md
并加入其中! ?