Документация для разработчиков

InputFile

string
CFile::InputFile(
 string FieldName,
 int field_size,
 int ImageID,
 string ImageStorePath = false,
 int file_max_size = 0,
 string FileType = "IMAGE",
 string field_file = "class=typefile",
 int description_size = 0,
 string field_text = "class=typeinput",
 string field_checkbox = "",
 bool ShowNotes = true,
 bool ShowFilePath = True
)

Метод возвращает HTML код предназначенный для загрузки нового, либо замены существующего файла. Статический метод.

Параметры

ПараметрОписание С версии
FieldName Название поля для ввода файла:
<input type="file" name="input_file_name" ... >
field_size Ширина поля для ввода файла:
<input type="file" size="input_file_width" ... >
ImageID Цифровой идентификатор существующего файла.
ImageStorePath Путь к папке от корня сайта в которой хранятся файлы. Например: "/upload/iblock/".
Необязательный. По умолочанию false - путь берется из настроек системы.
file_max_size Максимальный размер файла (байт):
<input type="hidden" name="MAX_FILE_SIZE" value="file_max_size">
Необязательный. По умолчанию "0" - без ограничений.
FileType Тип файла, если "IMAGE", то в информацию по файлу будет добавлена ширина и высота изображения.
Необязательный. По умолчанию "IMAGE".
3.3.0
field_file Произвольный HTML который будет добавлен в поле для ввода файла:
<input type="file" add_to_input_file ... >
Необязательный. По умолчанию "class=typefile" - стандартный класс для полей ввода файлов в административной части.
3.3.21
description_size Ширина поля ввода для комментария к файлу:
<input type="text" size="input_description_width" ... >
Необязательный. По умолчанию "0" - поле ввода для комментария к файлу не показывать.
3.3.21
field_text Произвольный HTML который будет добавлен в поле ввода для комментария к файлу:
<input type="text" add_to_input_description ... >
Необязательный. По умолчанию "class=typeinput" - стандартный класс для однострочных элементов ввода в административной части.
3.3.21
field_checkbox Произвольный HTML который будет добавлен в поле типа "checkbox" для удаления файла:
<input type="checkbox" name="input_file_name_del" value="Y" add_to_checkbox_delete ... >
Необязательный.
3.3.21
ShowNotes Флаг позволяющий включить, либо отключить показ информации по файлу (размер, ширину, высоту).
Необязательный. По умолчанию - "true" - информацию по файлу показать.
3.3.21
ShowFilePath Флаг позволяющий включить, либо отключить показ пути к файлу.
Необязательный. По умолчанию - "true" - информацию по файлу показать.
12.0.8

См. также

Примеры использования

<tr valign="top">
    <td align="right"><font class="tablefieldtext"><?=GetMessage("VOTE_IMAGE")?></font></td>
    <td><font class="tablebodytext"><?
    echo CFile::InputFile("IMAGE_ID", 20, $str_IMAGE_ID);
    if (strlen($str_IMAGE_ID)>0):
        ?><br><?echo CFile::ShowImage($str_IMAGE_ID, 200, 200, "border=0", "", true);
    endif;
    ?></font>
    </td>
</tr>


© «Битрикс», 2001-2019, «1С-Битрикс», 2019
Наверх