Skip to main content

__construct

Construtor da classe TFile. Parâmetros:
$nome
mixed
required
Nome do campo que será utilizado no formulário.
Exemplo de código:
$arquivo = new TFile('arquivoDocumento');

setSize

Define o tamanho do campo. Parâmetros:
$largura
mixed
required
Largura do campo.
$altura
mixed
default:"NULL"
(Opcional) Altura do campo.
Exemplo de código:
$arquivo = new TFile('arquivoTamanho');
$arquivo->setSize(500);

setHeight

Define a altura do campo. Parâmetros:
$altura
mixed
required
Altura do campo.
Exemplo de código:
$arquivo = new TFile('arquivoAltura');
$arquivo->setHeight(50);

setValue

Define o valor do campo. Parâmetros:
$valor
mixed
required
Um valor string contendo o valor do campo.
Exemplo de código:
$arquivo = new TFile('arquivoDocumento');
$arquivo->setValue('documento.pdf');

setCompleteAction

Define a ação a ser executada quando o upload é concluído. Parâmetros:
$action
mixed
required
Objeto TAction.
Exemplo de código:
$arquivo = new TFile('arquivoUpload');
$arquivo->setCompleteAction(new TAction(['NomeClasseDeControle', 'onUploadComplete']));
Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).
public static function onUploadComplete($param = null)
{
    new TMessage('info', 'O upload foi realizado com sucesso!');
}

setErrorAction

Define a ação a ser executada quando ocorre algum erro. Parâmetros:
$action
mixed
required
Objeto TAction.
Exemplo de código:
$arquivo = new TFile('arquivoErro');
$arquivo->setErrorAction(new TAction(['NomeClasseDeControle', 'onUploadError']));
Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).
public static function onUploadError($param = null)
{
    new TMessage('info', 'O upload falhou!');
}

setAllowedExtensions

Define as extensões permitidas para o upload. Parâmetros:
$extensoes
mixed
required
Array de extensões permitidas.
Exemplo de código:
$arquivo = new TFile('arquivoImagem');
$arquivo->setAllowedExtensions(['jpg', 'png']);

setLimitUploadSize

Define o limite de tamanho de upload. Parâmetros:
$limite
mixed
required
Limite do tamanho do arquivo em MBs.
Exemplo de código:
$arquivo = new TFile('arquivoLimite');
$arquivo->setLimitUploadSize(10); // Limite de 10 MB

enablePHPFileUploadLimit

Habilita o limite de upload de arquivo baseado na configuração do PHP. Exemplo de código:
$arquivo = new TFile('arquivoPHP');
$arquivo->enablePHPFileUploadLimit();

enableFileHandling

Habilita o manuseio de arquivo. Exemplo de código:
$arquivo = new TFile('arquivoManuseio');
$arquivo->enableFileHandling();

disableFileHandling

Desabilita o manuseio de arquivo. Exemplo de código:
$arquivo = new TFile('arquivoDesabilitarManuseio');
$arquivo->enableFileHandling();
$arquivo->disableFileHandling();

setPlaceHolder

Define o placeholder para o campo. Parâmetros:
$widget
TElement
required
Elemento que será usado como placeholder.
Exemplo de código:
$placeholder = new TElement('placeholder');
$placeholder->add('Selecione um arquivo');

$arquivo = new TFile('arquivoPlaceholder');
$arquivo->setPlaceHolder($placeholder);

setDisplayMode

Define o modo de exibição do campo. Parâmetros:
$modo
mixed
required
Modo de exibição (ex: ‘file’).
Exemplo de código:
$arquivo = new TFile('arquivoModo');
$arquivo->setDisplayMode('file');

setService

Define a classe de serviço para resposta. Parâmetros:
$servico
mixed
required
Classe de serviço.
Exemplo de código:
$arquivo = new TFile('arquivoServico');
$arquivo->setService('ServicoUpload');

enableImageGallery

Ativa a visualização de galeria de imagens. Parâmetros:
$largura
mixed
default:"null"
(Opcional) Largura da galeria.
$altura
mixed
default:"100"
(Opcional) Altura da galeria.
Exemplo de código:
$arquivo = new TFile('galeriaFotos');
$arquivo->enableImageGallery(300, 200);

enablePopover

Ativa uma popover ao passar o mouse. Parâmetros:
$titulo
mixed
default:"null"
(Opcional) Título da popover.
$conteudo
mixed
default:"''"
(Opcional) Conteúdo da popover.
Exemplo de código:
$arquivo = new TFile('arquivoPopover');
$arquivo->enablePopover('Informação', 'Detalhes do arquivo');

getPostData

Obtém os dados enviados pelo formulário. Exemplo de código:
$arquivo = new TFile('arquivoPost');
$dadosPostados = $arquivo->getPostData();

enableField e disableField

(Método estático) Habilita e desabilita o campo no formulário. Parâmetros:
$form_name
mixed
required
Nome do formulário.
$field
mixed
required
Nome do campo.
Exemplo de código:
$arquivo = new TFile('arquivo');

$btnHabilitar = new TButton('btnEnableField');
$btnHabilitar->addStyleClass('btn-default');
$btnHabilitar->setImage('far:circle #000000');
$btnHabilitar->setAction(new TAction([$this, 'habilitarCampo']), 'Habilitar Upload de Arquivos');

$btnDesabilitar = new TButton('btnDisableField');
$btnDesabilitar->addStyleClass('btn-default');
$btnDesabilitar->setImage('far:circle #000000');
$btnDesabilitar->setAction(new TAction([$this, 'desabilitarCampo']), 'Desabilitar Upload de Arquivos');
Código de exemplo das funções a serem chamadas, lembrando que essas funções precisam ser estáticas (static function).
public static function habilitarCampo($param = null)
{
    TFile::enableField('nomeForm', 'arquivo');
}

public static function desabilitarCampo($param = null)
{
    TFile::disableField('nomeForm', 'arquivo');
}

clearField

(Método estático) Limpa o campo no formulário. Parâmetros:
$form_name
mixed
required
Nome do formulário.
$field
mixed
required
Nome do campo.
Exemplo de código:
$arquivo = new TFile('arquivo');

$btnLimpar = new TButton('btnClearField');
$btnLimpar->addStyleClass('btn-default');
$btnLimpar->setImage('far:circle #000000');
$btnLimpar->setAction(new TAction([$this, 'limparCampo']), 'Remover Uploads');
Código de exemplo da função a ser chamada, lembrando que essa função precisa ser estática (static function).
public static function limparCampo($param = null)
{
    TFile::clearField('nomeForm', 'arquivo');
}