Documentation
Feedback
Guides
API Reference

Guides
Search
Search Control – fulltextSearchBox
Search Control – fulltextSearchBox

VTEX has two search options - VTEX search and VTEX Intelligent Search. This article refers to the VTEX search. To learn more about the VTEX Intelligent Search application, see this track. The <vtex.cmc:fullTextSearchBox /> control is responsible for generating the search box. Besides the search filed, the control renders a combo for restricting a search in one department. Below we have an example of the control with no application of CSS:

{"base64":"  ","img":{"width":341,"height":105,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":4646,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/docs/guides/Search/controle-busca-cru.png"}}

Search is a functionality that must be available on all the pages of a store. That is why it is suggested inserting the control inside a subtemplate. The search control is used within the subtemplate of the store header.

HTML rendered by the control


_13
<fieldset class="busca">
_13
<legend>Buscar no site</legend>
_13
<label>Buscar</label>
_13
<select id="ftDept4aceafb578de4c7caf31e06bcc8d45b9">
_13
<option value="">Todo o site</option>
_13
<option value="1000000">Integracao</option>
_13
<option value="1">Eletrodomésticos</option>
_13
<option value="3">Moda</option>
_13
</select>
_13
<input type="hidden" id=ftIdx4aceafb578de4c7caf31e06bcc8d45b9 value="" />
_13
<input id="ftBox4aceafb578de4c7caf31e06bcc8d45b9" class="fulltext-search-box" type="text" size="20" accesskey="b" />
_13
<input id="ftBtn4aceafb578de4c7caf31e06bcc8d45b9" type="button" value="Buscar" class="btn-buscar" />
_13
</fieldset>

The autocomplete functionality is already provided for in this control, and it is only necessary to customize its CSS. Autocomplete is activated as soon as a client inputs three characters in the search field. Below is the html generated by the autocomplete:


_23
<ul class="ui-autocomplete ui-menu ui-widget ui-widget-content ui-corner-all" role="listbox" aria-activedescendant="ui-active-menuitem" style="z-index: 10; top: -3334px; left: 667.5px; display: none; position: relative; width: 507px;">
_23
<li class="ui-menu-item" role="menuitem"><a class="ui-corner-all" tabindex="-1">adidas em Modelos</a></li>
_23
<li class="ui-menu-item" role="menuitem"><a class="ui-corner-all" tabindex="-1">adidas em Tênis</a></li>
_23
<li class="ui-menu-item" role="menuitem"><a class="ui-corner-all" tabindex="-1">adidas em Lançamentos</a></li>
_23
<li class="ui-menu-item" role="menuitem"><a class="ui-corner-all" tabindex="-1">adidas em Masculino</a></li>
_23
<li class="ui-menu-item" role="menuitem">
_23
<a class="ui-corner-all" tabindex="-1">
_23
<img src="http://www.authenticfeet.com.br/arquivos/ids/188460-25-25/Mini-Bola-Brazuca-WC-14-Glider.jpg" width="25" height="25" alt="Mini-Bola-Brazuca-WC-14-Glider" /> minibola adidas brazuca glider - copa do mundo
_23
</a>
_23
</li>
_23
<li class="ui-menu-item" role="menuitem">
_23
<a class="ui-corner-all" tabindex="-1">
_23
<img src="http://www.authenticfeet.com.br/arquivos/ids/189014-25-25/Tenis-adidas-Springblade-Feminino.jpg" width="25" height="25" alt="Tenis-adidas-Springblade-Feminino" />
_23
tênis adidas springblade feminino
_23
</a>
_23
</li>
_23
<li class="ui-menu-item" role="menuitem">
_23
<a class="ui-corner-all" tabindex="-1">
_23
<img src="http://www.authenticfeet.com.br/arquivos/ids/188855-25-25/Tenis-adidas-Dynamic-Fusion-50-Feminino.jpg" width="25" height="25" alt="Tenis-adidas-Dynamic-Fusion-50-Feminino" />
_23
tênis adidas dynamic fusion 50 feminino
_23
</a>
_23
</li>
_23
</ul>

Examples of how the control can be customized

Example 1

{"base64":"  ","img":{"width":560,"height":318,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":169791,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/docs/guides/Search/controle-busca-autocomplete-560x318.png"}}

Example 2

{"base64":"  ","img":{"width":560,"height":43,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":10212,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/docs/guides/Search/controle-busca-exemplo-560x43.png"}}

Example 3

{"base64":"  ","img":{"width":518,"height":69,"type":"png","mime":"image/png","wUnits":"px","hUnits":"px","length":4109,"url":"https://cdn.jsdelivr.net/gh/vtexdocs/dev-portal-content@main/docs/guides/Search/controle-busca-exemplo1.png"}}

Contributors
1
Photo of the contributor
+ 1 contributors
Was this helpful?
Yes
No
Suggest Edits (GitHub)
Contributors
1
Photo of the contributor
+ 1 contributors
On this page