Download the PHP package agenciamaior/bootstrap_forms without Composer
On this page you can find all versions of the php package agenciamaior/bootstrap_forms. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download agenciamaior/bootstrap_forms
More information about agenciamaior/bootstrap_forms
Files in agenciamaior/bootstrap_forms
Package bootstrap_forms
Short Description Biblioteca para gerar formulários estilizados com bootstrap e Laravel Forms
License
Informations about the package bootstrap_forms
BootstrapForms
Biblioteca que gera tags HTML de formulários e campos com estilos do Bootstrap 4.
- Dependências
- Instalação
- Utilização
- bsText
- bsSelect
- bsFile
- bsCheckbox
- bsRadio
- bsTextarea
- bsSubmit
- Formulário
- restForm
- deleteLink
Dependências
Instalação
Esse pacote instala automaticamente a biblioteca Laravel Forms. Nenhuma configuração adicional é necessária.
Utilização
bsText
Campos | Obrigatório | Descrição |
---|---|---|
name | Sim | Atributo name do input. Caso $attributes['id'] não seja especificado, esse valor também será usado para o id |
label | Sim | Label do campo |
attributes | Não | Array com atributos que podem ser alterados/adicionados ao input, como class, id, data, etc. |
Exemplo
Exemplo com atributos
Observações:
- O atributo default preenche o campo com um valor padrão.
- O atributo class adiciona classes novas ao campo, porém, a classe form-control sempre vai estar presente.
Campo sem label
Label com HTML
Variações
bsSelect
Campos | Obrigatório | Descrição |
---|---|---|
name | Sim | Atributo name do input. Caso $attributes['id'] não seja especificado, esse valor também será usado para o id |
label | Sim | Label do campo |
values | Sim | Array no estilo key => value que vai compor as opções do select |
attributes | Não | Array com atributos que podem ser alterados/adicionados ao input, como class, id, data, etc. |
Exemplo
Exemplo com atributos
Sem placeholder
bsFile
Campos | Obrigatório | Descrição |
---|---|---|
name | Sim | Atributo name do input. Caso $attributes['id'] não seja especificado, esse valor também será usado para o id |
label | Sim | Label do campo |
attributes | Não | Array com atributos que podem ser alterados/adicionados ao input, como class, id, data, etc. |
Exemplo
Exemplo com atributos
Imagem padrão
bsCheckbox
Campos | Obrigatório | Descrição |
---|---|---|
name | Sim | Atributo name do input. Caso $attributes['id'] não seja especificado, esse valor também será usado para o id |
label | Sim | Label do campo |
value | Sim | Value associado ao checkbox |
attributes | Não | Array com atributos que podem ser alterados/adicionados ao input, como class, id, data, etc. |
Exemplo
Exemplo com atributos
Múltiplos
bsRadio
Campos | Obrigatório | Descrição |
---|---|---|
name | Sim | Atributo name do input. Caso $attributes['id'] não seja especificado, o valor para o atributo id será composto de name-value |
label | Sim | Label do campo |
value | Sim | Value associado ao radio |
attributes | Não | Array com atributos que podem ser alterados/adicionados ao input, como class, id, data, etc. |
Exemplo
Observação: Para que o campo funcione corretamente com mais de um, o name de todos os radios deve ser igual.
bsTextarea
Campos | Obrigatório | Descrição |
---|---|---|
name | Sim | Atributo name do input. Caso $attributes['id'] não seja especificado, esse valor também será usado para o id |
label | Sim | Label do campo |
attributes | Não | Array com atributos que podem ser alterados/adicionados ao input, como class, id, data, etc. |
Exemplo
Exemplo com atributos
bsSubmit
Campos | Obrigatório | Descrição |
---|---|---|
text | Sim | Texto do botão |
attributes | Não | Atributos que podem ser alterados dentro do botão |
Exemplo
Exemplo com atributos
Trocar o ícone
Sem ícone
Formulário
Formulário comum
Exemplo
Mudar o método
Formulário para usar com o bsFile
restForm
Exemplo com Insert
Suponha um model Pedido com o seguinte Controller PedidosController.php:
E sua respectiva view pedidos/create.blade.php:
Ao identificar a variável $pedido como um novo Model, a função restForm vai tentar procurar dentro do arquivo routes/web.php por uma rota com o name pedidos.store, por isso, devemos criar essa rota dentro desse arquivo, por exemplo:
HTML gerado pela função
A função restForm vai tentar utilizar o nome da variável para buscar as rotas. No nosso exemplo, a variável é $pedido (no singular) e o prefixo da rota seria pedidos (no plural). Você pode alterar esse prefixo através do atributo route_prefix. Exemplo:
routes/web.php
Exemplo com Update
Suponha um model Pedido com o seguinte Controller PedidosController.php:
E sua respectiva view pedidos/edit.blade.php:
Ao identificar a variável $pedido como registro existente, a função restForm vai tentar procurar dentro do arquivo routes/web.php por uma rota com um name pedidos.update e com um parâmetro pedido, por isso, devemos criar essa rota dentro desse arquivo, por exemplo:
Diferente do Insert, que utilizar o método POST, a função vai usar o método PUT nas rotas para realizar o update.
HTML gerado pela função
A função vai gerar um campo do tipo hidden com valor do ID do registro selecionado.
A função restForm vai tentar utilizar o nome da variável para buscar as rotas. No nosso exemplo, a variável é $pedido (no singular) e o prefixo da rota seria pedidos (no plural). Você pode alterar esse prefixo através do atributo route_prefix. Exemplo:
routes/web.php
Assim como o prefixo das rotas vai tentar utilizar o nome no plural da variável. O parâmetro da rota vai tentar utilizar o nome no singular da variável. Você pode alterar o nome desse parâmetro através do atributo route_param_name. Exemplo:
routes/web.php
deleteLink
Campos | Obrigatório | Descrição |
---|---|---|
text | Sim | Texto do link |
route | Sim | Caminho para onde o link leva |
attributes | Não | Atributos que podem ser alterados dentro do link |
O padrão REST do Laravel recomenda que qualquer função destrutiva, como excluir um registro, seja chamada através de um método DELETE ao invés do GET padrão que os links utilizam. Essa função simula um link com uma requisição DELETE através de um formulário: