Detalhes do pacote

@elastic/react-search-ui-views

elastic523.6kApache-2.01.24.1

A collection of React UI components for building search experiences

readme (leia-me)

Elastic Search UI

A JavaScript library for the fast development of modern, engaging search experiences with Elastic. Get up and running quickly without re-inventing the wheel.

Check out the documentation to learn more about setting up and using Search UI.

Features 👍

  • You know, for search - Maintained by Elastic, the team behind Elasticsearch.
  • Speedy Implementation - Build a complete search experience with a few lines of code.
  • Customizable - Tune the components, markup, styles, and behaviors to your liking.
  • Smart URLs - Searches, paging, filtering, and more, are captured in the URL for direct result linking.
  • Flexible front-end - Not just for React. Use with any JavaScript library, even vanilla JavaScript.
  • Flexible back-end - Use it with Elasticsearch, Elastic Enterprise Search, or any other search API.

Live demos 👀

Connectors

Examples

Get started

Installation

npm install @elastic/search-ui @elastic/react-search-ui @elastic/react-search-ui-views
# or
yarn add @elastic/search-ui @elastic/react-search-ui @elastic/react-search-ui-views

Tutorials

To quickly get started with Search UI, follow one of our tutorials:

Contributing

We welcome contributors to the project. Follow our contributing guide to get started.

License 📗

Apache-2.0 © Elastic

Thank you to all the contributors!

changelog (log de mudanças)

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.24.0] - 2025-05-28

✨ Added

  • Replaced Searchkit SDK with a new internal ApiClient architecture for the Elasticsearch Connector. This significantly improves maintainability, customizability, and bundle size. #1143
  • Added support for filters in Autocomplete results. #1150
  • Introduced new advanced query customization options via getQueryFn and interceptSearchRequest, interceptAutocompleteResultsRequest, interceptAutocompleteSuggestionsRequest hooks. #1161
  • Added support for fuzziness: true in searchQuery and autocomplete, enabling typo-tolerant matching. #1159
  • Added support for range filters in the Elasticsearch Connector. #1157
  • Introduced a dedicated entry point for ApiProxyConnector to optimize bundle usage. #1146

🧱 Changed

  • React 19 Support: Upgraded react and react-dom peer dependencies to version 19. #1162

🐛 Fixed

  • Fixed issue where queries with no matches would still return results from filters — filters are now applied in conjunction with matching queries. #1151
  • Fixed incorrect behavior for facet filter types (none, any, all) in the Elasticsearch Connector. #1153

🧹 Removed

  • Fully removed the searchkit dependency from the Elasticsearch Connector. #1143
  • Deprecated postProcessRequestBodyFn in favor of new interceptSearchRequest, interceptAutocompleteResultsRequest, interceptAutocompleteSuggestionsRequest hooks. #1161

🛠 Internal

  • Migrated CI from CircleCI to GitHub Actions.
  • Updated internal dev tooling: TypeScript, Jest, Replaced Enzyme with React Testing Library, ESLint, Prettier. #1162
  • Minified production bundles using tsup, excluded source maps from production output. #1148
  • Improved docs for Elasticsearch Connector, de-emphasized App Search and Workplace Search connectors. #1149

[1.23.0] - 2025-04-01

✨ Added

  • Added the ability to preserve selected filters when performing a new search. This provides more flexibility in managing filter states between queries. #1131
    Related to #89
  • Introduced useSearch hook for React functional components. #1130
  • Added APIProxyConnector to the Elasticsearch Connector to enable server-side integration using Node.js and Express. This enhances security by hiding API keys and other sensitive data. #1126
  • Added TypeScript support to the sandbox example. #1126
  • Updated sandbox structure, React version, and example organization. #1126

🐛 Fixed

  • Fixed export module compatibility issues by introducing bundling using tsup, ensuring correct behavior in both ESM and CommonJS environments. #1114
    Fixes #1046
  • Fixed sorting logic when using sortField and sortDirection in state. Addressed inconsistencies in setSort() behavior. #1112
    Fixes #1109
  • Fixed issue in BooleanFacet for numeric facet values (e.g., 0/1 or true/false), improving compatibility with Elasticsearch Connector. #1111
    Fixes #851

🧹 Removed

  • Removed “Technical preview” label for Elasticsearch Connector as it is now generally available (GA). 🎉 #1125
  • Deprecated @elastic/search-ui-analytics-plugin package. #1120

🛠 Internal

  • Switched to tsup for consistent module bundling across packages. #1114
  • Applied shared TypeScript and bundling configurations across the repo. #1114