@emcsistemas/native-ui
v1.1.22
Published
Biblioteca de componentes react native
Downloads
103
Readme
📱 Native UI
Biblioteca de componentes react native para construção e estilização de interfaces
1. Pré-requisitos
- React Native
- Expo
- React Navigation
2. Dependências (outras bibliotecas)
- expo-font
- @expo-google-fonts/roboto (Roboto_400Regular, Roboto_500Medium e Roboto_700Bold)
- expo-haptics
- react-native-safe-area-context
- react-native-calendars
- date-fns
- react-native-root-toast
- react-native-reanimated
- react-native-gesture-handler
- lottie-react-native
3. Instalação das dependências
npm i @emcsistemas/native-ui react-native-calendars date-fns react-native-root-toast
npx expo install expo-font @expo-google-fonts/roboto expo-haptics react-native-safe-area-context
npx expo install react-native-reanimated react-native-gesture-handler lottie-react-native
- Incluir a linha
react-native-reanimated/plugin
nos plugins do arquivobabel.config.js
4. O que está incluído?
- EMCHeader: cabeçalho padrão com logomarca utilizado geralmente na tela
Home
- EMCHeaderSimple: cabeçalho padrão simplificado sem logomarca utilizado geralmente nas demais telas
- EMCHeaderResponse: cabeçalho utilizado em telas exibidas após um envio de documento fiscal ao backend
- EMCBox: implementa uma
View
nativa - EMCBoxSafe: implementa uma
View
nativa dentro de umaSafeAreaView
- EMCVStack: implementa uma
View
nativa - EMCVStackSafe: implementa uma
View
nativa dentro de umaSafeAreaView
- EMCHStack: implementa uma
View
nativa com orientação horizontal - EMCHStackSafe: implementa uma
View
nativa com orientação horizontal dentro de umaSafeAreaView
- EMCCenter: implementa uma
View
com orientação centralizada - EMCCenterSafe: implementa uma
View
com orientação centralizada dentro de umaSafeAreaView
- EMCDivider: linha fina horizontal para divisão de itens na tela
- EMCButton: implementa um
Pressed
nativo com propriedades personalizadas - EMCBoletoButton: exibe um botão personalido para visualização de arquivo de boletos bancários
- EMCWhatsAppButton: exibe um botão personalido para envio de mensagem por whatsapp
- EMCButtonMenu: botão padrão de opções utilizado geralmente na tela
Home
dos apps - EMCWhatsAppNumber: exibe um caixa de diálogo para informar o número de telefone do whatsapp de destino
- EMCCircularButton: botão circular flutuante com ícone
- EMCScrollView: implementa uma
ScrollView
nativa sem barra de rolagem na vertical - EMCText: implementa um
Text
nativo - EMCHeadText: Exibe um texto em negrito utilizado geralmente em telas de login
- EMCTextArea: implementa um
TextInput
nativo com suporte a múltiplas linhas - EMCTextInput: implementa um
TextInput
nativo - EMCFakeInput: componente que imita um
TextInput
desabilitado. Somente para exibição de informação. - EMCIcon: exibe na tela um ícone de qualquer família de ícones da biblioteca
@expo/vector-icons
- EMCInputSelectors: input de texto para conteúdo numérico com seletores nas laterais
- EMCMaskedInput: implementa um
TextInput
nativo com máscara automática - EMCMessage: exibe uma mensagem ao usuário utilizando a função nativa
Alert.alert
- EMCDialog: exibe uma caixa de mensagem com a opção de incluir um campo para solicitação de dados
- EMCSpinner: implementa um
ActivityIndicator
nativo - EMCSafeArea: implementa uma
SafeAreaView
- EMCDecimalKeyboard: teclado customizado para digitação de valores numéricos
- EMCBackground: background utilizado em todas as telas
- EMCCalendar: calendário estilizado utilizando a lib
react-native-calendars
- showToast: função que mostra uma mensagem temporária no formato
Toast
- EMCToastModal: componente que exibe um toast como na função
showToast
para utilização em modals sem transparência - EMCDropDown: exibe um fake dropdown (deve ser implementado um modal para exibir a lista de itens)
- EMCAvatar: exibe uma view de avatar em formato circular com a imagem passada
- EMCLogo: exibe uma logomarca passada como parâmetro (base64) ou a logo da EMC Sistemas caso a base64 não seja passada
- EMCSwitch: implementa um
Switch
nativo - EMCDiscountSwitch: exibe um switch personalizado para seleção do tipo de desconto (percentual ou valor)
- EMCWait: exibe um modal com fundo escuro e semi-transparente para indicar processamento de alguma operação
- EMCBannerDemo: banner que é exibido ao entrar no app quando se trata de um cliente de demonstração
5. Tema
- Colors: padrão de cores utilizado pela empresa
- FontSizes: configurações de tamanhos de fontes utilizadas pela empresa
- Sizes: definições de tamanhos utilizados pela empresa
6. Contribuição
Sinta-se à vontade para enviar um PR se quiser ajudar!
7. Licença
Licenciado sob a licença MIT, Copyright © 2023 EMC Sistemas Ltda. Veja LICENÇA para mais informações.