Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs-fw.madbuilder.com.br/llms.txt

Use this file to discover all available pages before exploring further.

​
__construct

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

​
setSize

Define o tamanho do campo. Parâmetros:
​
$width
mixed
required
Largura do campo.
​
$height
mixed
default:"NULL"
(Opcional) Altura do campo.
 Exemplo de código: 
$arquivos = new TMultiFile('tamanhoCampo');
$arquivos->setSize(400, 75);

​
setHeight

Define a altura do campo. Parâmetros:
​
$height
mixed
required
Altura do campo em pixels.
 Exemplo de código: 
$arquivos = new TMultiFile('alturaCampo');
$arquivos->setHeight(100);

​
setValue

Define o valor do campo. Parâmetros:
​
$value
mixed
required
Array de strings com os caminhos dos arquivos.
 Exemplo de código: 
$arquivos = new TMultiFile('arquivos');
$arquivos->setValue(['arquivo1.txt', 'arquivo2.txt']);

​
setCompleteAction

Define a ação a ser executada ao completar o upload de um arquivo. Parâmetros:
​
$action
TAction
required
Objeto TAction.
 Exemplo de código: 
$arquivos = new TMultiFile('uploadCompleto');
$arquivos->setCompleteAction(new TAction(['NomeClasseDeControle', 'onCompleteUpload']));
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!');
}

​
setAllowedExtensions

Define as extensões permitidas para o upload de arquivos. Parâmetros:
​
$extensions
mixed
required
Array de extensões permitidas.
 Exemplo de código: 
$arquivos = new TMultiFile('arquivosImagens');
$arquivos->setAllowedExtensions(['jpg', 'jpeg', 'png']);

​
setLimitUploadSize

Define o limite de tamanho para o upload de arquivos. Parâmetros:
​
$limit
mixed
required
Tamanho máximo do arquivo em MBs.
 Exemplo de código: 
$arquivos = new TMultiFile('limiteUpload');
$arquivos->setLimitUploadSize(5); // Limite de 5 MB

​
enablePHPFileUploadLimit

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

​
enableFileHandling

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

​
disableFileHandling

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

​
enableImageGallery

Habilita a visualização dos arquivos como uma galeria de imagens. Parâmetros:
​
$width
mixed
default:"null"
(Opcional) Largura da galeria (padrão: null).
​
$height
mixed
default:"100"
(Opcional) Altura da galeria.
 Exemplo de código: 
$arquivos = new TMultiFile('galeriaImagens');
$arquivos->enableImageGallery(300, 150);

​
enablePopover

Habilita um popover nos arquivos da galeria. Parâmetros:
​
$title
mixed
default:"null"
(Opcional) Título do popover.
​
$content
mixed
default:""
(Opcional) Conteúdo do popover.
 Exemplo de código: 
$arquivos = new TMultiFile('documentos');
$arquivos->enablePopover('Detalhes', 'Mais informações sobre o arquivo.');

​
setService

Define a classe de serviço para manipulação dos arquivos. Parâmetros:
​
$service
mixed
required
Nome da classe de serviço.
 Exemplo de código: 
$arquivos = new TMultiFile('servicoArquivos');
$arquivos->setService('ServicoDeUploadCustomizado');

​
getPostData

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

​
enableField e disableField

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

$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)
{
    TMultiFile::enableField('nomeForm', 'arquivos');
}

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

​
clearField

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

$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)
{
    TMultiFile::clearField('nomeForm', 'arquivos');
}