select files, generated dynamic file selector
selectFile
This control reads the contents (file and directory entries) of a directory and creates a select of the items found. Some examples:
- Directory tree containing only files, with relative paths:
- Directory tree containing only files, with absolute paths:
- Directory tree containing only directories, with relative paths:
There are many options to customize apperance and behaviour like file inclusion/exclusion, display format, recursive traversal settings.
<?php
$config = Array(
'id' => Array(
'type' => 'selectFile',
'displayname' => 'Please select a file',
'directory' => '/home/www/www.example.com/files/',
'tree' => 1 | 0, // default: 1
'includedirs' => 1 | 0, // default: 0
'includefiles' => 1 | 0, // default: 1
// exclusion of specific files:
'exclude' => Array( 'autoexec.bat', 'config.sys' ),
// exlusion using regular expression (preg_match compatible string):
'excludere' => '/\.txt$/i', // matching files will be discarded
// inclusion using regular expression (preg_match compatible string)
'includere' => '/\.xls$/i', // matching files will be included
// ordering the files in the list
'order' => 'name', // default: empty (unordered, as-is)
// ordering options: name, namedesc, size, sizedesc
// display format string (sprintf style) for regular files
'format' => '%1$s (%2$d bytes)',
// %1$s means filename, %2$d is the size
// display format string (sprintf style) for directories
'formatdir' => '%1$s',
// %1$s is the filename, %2$d is the size (omitted by default for dirs)
// show directory paths in filename
'fullpath' => 1 | 0, // default: 0
// include directory path in returned value
'fullpathvalue' => 1 | 0, // default: 0
// should directory names end with /
'trailingslash' => 1 | 0, // default: 1
'values' =>
Array(
'/home/www/www.example.com/' => 'Your home directory',
),
'value' => '/home/www/www.example.com/',
'html' => 'class="inputfieldstyle"',
'help' => 'validation failed for this element',
'rowlayout' => '...%element% %prefix% %postfix% etc...',
'prefix' => 'string to display before element',
'postfix' => 'string to display after element',
'readonly' => 1 | 0,
'display' => 1 | 0,
'htmlid' => 'name1',
)
);
?>
Live examples:
Validators to use together with this element:
form validation for developers!
clonefish is a proven, mature form generator class that helps PHP developers to create, validate and process secure, flexible and easy-to-maintain formslearn more
