Pular para o conteúdo principal

SearchInput

O componente SearchInput é um campo de pesquisa especializado que facilita a implementação de funcionalidades de busca em aplicações mobile.

Importação

import { SearchInput } from '@platformbuilders/fluid-react-native';

Exemplo Básico

<SearchInput
accessibility="campo-pesquisa"
placeholder="Pesquisar..."
onChange={(value) => console.log('Pesquisando por:', value)}
/>

Exemplos

Com ícones personalizados

<SearchInput
accessibility="campo-pesquisa"
leftIconName="search"
rightIconName="times"
onChange={(value) => console.log('Pesquisando por:', value)}
onRightIconPress={() => console.log('Limpar pesquisa')}
/>

Com foco automático

<SearchInput
accessibility="campo-pesquisa"
autoFocus
onChange={(value) => console.log('Pesquisando por:', value)}
/>

Com estilo personalizado

<SearchInput
accessibility="campo-pesquisa"
containerStyle={{ backgroundColor: '#f0f0f0', borderRadius: 8 }}
textStyle={{ color: '#333' }}
inputStyle={{ fontSize: 16 }}
onChange={(value) => console.log('Pesquisando por:', value)}
/>

Com sombra

<SearchInput
accessibility="campo-pesquisa"
hasShadow
onChange={(value) => console.log('Pesquisando por:', value)}
/>

API

Props

PropTipoPadrãoDescrição
accessibilitystring-Identificador de acessibilidade (obrigatório)
idstring-ID opcional para o componente
onChange(value: string) => void-Callback chamado quando o texto é alterado
onClear() => void() => nullCallback chamado quando o campo é limpo
onFocus() => void() => nullCallback chamado quando o campo recebe foco
onBlur() => void() => nullCallback chamado quando o campo perde foco
onSubmit() => void() => nullCallback chamado ao submeter a pesquisa
onIconPress() => void-Callback chamado ao pressionar o ícone principal
onRightIconPress() => void-Callback chamado ao pressionar o ícone direito
placeholderstring'Pesquise aqui'Texto de placeholder
iconColorstring-Cor do ícone
wrapperHeightnumber56Altura do componente
inputPaddingnumber-Padding interno do input
iconSizenumber26Tamanho do ícone
hasShadowbooleanfalseSe deve apresentar sombra
textStyleStyleProp<TextStyle>-Estilo para o texto
inputStyleStyleProp<TextStyle>-Estilo para o input
containerStyleStyleProp<ViewStyle>-Estilo para o container
placeholderTextColorstring-Cor do texto de placeholder
autoFocusbooleanfalseSe o campo deve receber foco automaticamente
rightIconNamestring-Nome do ícone direito
leftIconNamestring-Nome do ícone esquerdo
inputRefRefObject<TextInput>-Ref para acessar o componente input

Notas de uso

  • O componente SearchInput é construído sobre o componente TextInput, herdando suas propriedades básicas
  • A presença de ícones é controlada pelas props leftIconName e rightIconName
  • O comportamento de limpar o campo é implementado automaticamente