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

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-2024, «1С-Битрикс», 2024