TFile

O TFile é um componente de escolha de arquivos (derivado da classe TField), permitindo que o usuário faça upload de arquivos para o servidor.

__construct

Construtor da classe TFile.

Parâmetros:

Exemplo de código:

$arquivo = new TFile('arquivoDocumento');

setSize

Define o tamanho do campo.

Parâmetros:

Exemplo de código:

$arquivo = new TFile('arquivoTamanho');
$arquivo->setSize(500);

setHeight

Define a altura do campo.

Parâmetros:

Exemplo de código:

$arquivo = new TFile('arquivoAltura');
$arquivo->setHeight(50);

setValue

Define o valor do campo.

Parâmetros:

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:

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:

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:

Exemplo de código:

$arquivo = new TFile('arquivoImagem');
$arquivo->setAllowedExtensions(['jpg', 'png']);

setLimitUploadSize

Define o limite de tamanho de upload.

Parâmetros:

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:

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:

Exemplo de código:

$arquivo = new TFile('arquivoModo');
$arquivo->setDisplayMode('file');

setService

Define a classe de serviço para resposta.

Parâmetros:

Exemplo de código:

$arquivo = new TFile('arquivoServico');
$arquivo->setService('ServicoUpload');

enableImageGallery

Ativa a visualização de galeria de imagens.

Parâmetros:

Exemplo de código:

$arquivo = new TFile('galeriaFotos');
$arquivo->enableImageGallery(300, 200);

enablePopover

Ativa uma popover ao passar o mouse.

Parâmetros:

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:

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:

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');
}