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

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
Наверх