In-Portal Developers Guide

This is a wiki-based Developers Guide for In-Portal Open Source CMS. The purpose of this guide is to provide advanced users, web developers and programmers with documentation on how to expand, customize and improve the functionality and the code the In-Portal software. Please consider contributing to our documentation writing effort.

K4:Элементы ввода данных на формах

From In-Portal Developers Guide

Jump to: navigation, search
Current revision (05:28, 28 November 2010) (view source)
(Side-box)
 
(2 intermediate revisions not shown.)
Line 1: Line 1:
{{toc | category = Работа с формами | sortkey = 001.001}}
{{toc | category = Работа с формами | sortkey = 001.001}}
<!-- Пишите ПОСЛЕ этой строки, пожалуйста. Ничего не стирать! -->
<!-- Пишите ПОСЛЕ этой строки, пожалуйста. Ничего не стирать! -->
-
On each form used in the administrative console are elements for entering information. Elements for entering information are one of the main ways to edit records in the [[K4:Работа с базой данных|database]]. All elements for entering formation mentioned in this article are defined in the template "<code>incs/form_blocks.tpl</code>" (in platform, this template has been replaced with the template "<code>proj-base/incs/form_blocks.tpl</code>"). Each element is made up of '''2 parts''' - left and right. The left part contains:
+
На каждой, использующейся в административной консоли, форме встречаются элементы ввода. Элементы ввода являются одним из основных способов редактирования записей из [[K4:Работа с базой данных|базы данных]]. Все упомянутые в данной статье элементы ввода объявлены в шаблоне "<code>incs/form_blocks.tpl</code>". Каждый элемент состоит из '''2 частей''' - левой и правой. В левой части находиться:
-
* Name of the field;
+
* название поля;
-
* Indicator whether field is required;
+
* пометка о том, что поле является обязательным к заполнению;
-
* Additional buttons (for example, to open <code>FCKEditor</code>);
+
* дополнительные кнопки (напр. открытия <code>FCKEditor</code>);
-
The actual element for entering information is in the right side. Since there can be a lot of elements and ways to enter information, a separate block is created for each of them. In general form, all blocks like this are called "<code>inp_edit_<type></code>", where <code><type></code> is a word by which it's possible to tell what kind of block will be drawn.
+
В правой части находиться сам элемент ввода. Т.к. элементов и способов ввода информации может быть много, то на каждый из них создан отдельный блок. В общей форме все такого рода блоки называются "<code>inp_edit_<type></code>", где <code><type></code> - это слово, по которому можно узнать, что за блок будет нарисован.
-
Each of the below listed blocks has several general parameters that will be listed further down.
+
У всех, из ниже перечисленных блоков есть несколько общих параметров, которые будут перечислены далее.
{| class="prettytable"
{| class="prettytable"
-
! Parameter || Description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|prefix|string}} || In this parameter, the [[K4:Unit Configs#Prefix|prefix]] of the [[K4:Unit Configs|unit config]] is set, whose record will be edited on the form.
+
| {{ConfigProperty|prefix|string}} || В данном параметре задаётся [[K4:Unit Configs#Prefix|префикс]] того [[K4:Unit Configs|unit config]], чья запись будет редактироваться на форме.
|-
|-
-
| {{ConfigProperty|field|string}} || Name of the field (from the [[K4:Работа с базой данных|database]] or [[K4:Unit Configs#VirtualFields|virtual field]]), the value of which will be shown or edited in this block.
+
| {{ConfigProperty|field|string}} || Название поля (из [[K4:Работа с базой данных|базы данных]] или [[K4:Unit Configs#VirtualFields|виртуального]]), значение которого будет показано или будет редактироваться в этом блоке.
|-
|-
-
| {{ConfigProperty|title|string}} || Name of the phrase whose translation will be shown in the left part of the block as the name of the field for the user. In accordance with [[K4:Назначение имён|naming conventions]] the name of the phrase must start with "<code>la_fld_</code>".
+
| {{ConfigProperty|title|string}} || Название фразы, перевод которой будет отображён в левой части блока в качестве названия поля для пользователей. Согласно [[K4:Назначение имён|правилам назначения имён]] название фразы должно начинаться с "<code>la_fld_</code>".
|-
|-
-
| {{ConfigProperty|is_last|int}} || This parameter makes it possible to indicate that this form element is the last one in the form. Usually such elements are formatted in a special way.
+
| {{ConfigProperty|is_last|int}} || Данный параметр позволяет указать, что этот элемент на форме является последним. Обычно такие элементы оформляются специальным образом.
|}
|}
== inp_label ==
== inp_label ==
-
This block is meant for displaying the value of a field in a form without the ability to edit it.{{clear}}
+
Данный блок предназначен для вывода значения какого либо поля, без возможности его редактирования на форме.{{clear}}
{| class="prettytable"
{| class="prettytable"
-
! Parameter || Description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|hint_label|string}} || The name of the phrase, the translation of which should be shown as a hint to the right of an input field.
+
| {{ConfigProperty|hint_label|string}} || Название фразы, перевод которой должен быть показан в качестве подсказки справа от поля ввода.
|-
|-
-
| {{ConfigProperty|as_label|int}} || If this parameter is set, then the value in the field will be interpreted as the name of the phrase and will be translated before being displayed on the form.
+
| {{ConfigProperty|as_label|int}} || Если данный параметр установлен, то значение в поле будет интерпретировано как название фразы и будет переведено перед отображением на форме.
|-
|-
-
| {{ConfigProperty|currency|string}} || For fields that contain a [K4:ProductsPricing#Price|price]] it's possible to indicate the [[K4:Currencies#ISO|currency's <code>ISO</code> code]], in which you want to show the value of the indicated field (the value gets automatically converted from the indicated currency to the site's [[K4:Currencies#IsPrimary|primary currency]]). It's also possible to pass the value of "<code>selected</code>, which will result in the pricing being displayed in the currency chosen by the user. For example, "<code>USD 15.11</code>" will be displayed, when the value in the database is "<code>15.11</code>".  
+
| {{ConfigProperty|currency|string}} || Для полей, содержащих [[K4:ProductsPricing#Price|цену]] позволяет задать [[K4:Currencies#ISO|<code>ISO</code> код валюты]], в которой нужно показывать значение данного поля (значение автоматически пересчитывается в зависимости от куса указанной валюты к курсу [[K4:Currencies#IsPrimary|основной валюты]] сайта). Также можно передать значение "<code>selected</code>", что приведёт к тому, что цена будет выводиться в валюте, которую выбрал пользователь. Например будет выведено "<code>USD 15.11</code>", когда в базе данных будет значение "<code>15.11</code>".
|-
|-
-
| {{ConfigProperty|style|string}} || Styling a field using standard styles ([http://www.w3.org/TR/html401/present/styles.html#adef-style HTML element]).
+
| {{ConfigProperty|style|string}} || Оформление поля с помощью стандартных стилей ([http://manual.prod.intechnic.lv/html4/present/styles.html#adef-style HTML элемент]).
|-
|-
-
| {{ConfigProperty|format|string}} || This option lets you specify a different output format for outputting data in a field. The format indicated in this block has a higher priority than the format indicated in the [[K4:Unit Configs#Fields|unit config]].
+
| {{ConfigProperty|format|string}} || Данный параметр позволяет задать другой формат вывода данных для поля. Формат, переданный в блоке, является более приоритетным, чем формат указанный в [[K4:Unit Configs#Fields|unit config]].
 +
|-
 +
| {{ConfigProperty|nl2br|int}} || При передаче данного параметра на выводимое значение будет применена функция [http://php.prod.intechnic.lv/manual/en/function.nl2br.php nl2br].
 +
 
|-
|-
-
| {{ConfigProperty|nl2br|int}} || When passing this parameter to the value being displayed, the [http://www.php.net/manual/en/function.nl2br.php nl2br] function will be used.
+
| {{ConfigProperty|no_special|int}} || При передаче данного параметра на выводимое значение не будет применена функция [http://php.prod.intechnic.lv/manual/en/function.htmlspecialchars.php htmlspecialchars]. Параметр добавлен начиная с [[K4:Core v 5.0.0|Core v 5.0.0]].
|}
|}
== inp_id_label ==
== inp_id_label ==
-
This block is almost identical in functionality to the [[#inp_label|inp_label]], but the result of its processing will only be visible in a form when the field contains a value. This block is usually used to display the value of the primary key of a database table.
+
Данный блок полностью идентичен функциональности блоку [[#inp_label|inp_label]], но результат работы блока будет виден на форме только тогда, когда в поле будет значение. Этот блок обычно используется для отображения значения основного поля (primary key) таблицы.
== inp_edit_box ==
== inp_edit_box ==
-
[[Image:Inp_edit_box.jpg|thumb|left|]] Simple edit box (<code><input type="text"></code>).{{clear}}
+
[[Image:Inp_edit_box.jpg|thumb|left|]] Простой edit box (<code><input type="text"></code>).{{clear}}
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|subfield|string}} || Can be used for processing an array that's stored in the database in serialized format. For example, if a form contains several [[#inp_edit_box|inp_edit_box]] elements but with different values of this parameter. Having written the corresponding method for processing these fields, the results of processing the fields on the form can be stored in one field in the database. An example can be found in In-Portal, in the section "<code>Configuration -> Stylesheets -> Edit</code>".
+
| {{ConfigProperty|subfield|string}} || Может служить для обработки массива хранящегося в базе данных в сериализованного виде. Например на форме ввода находиться несколько [[#inp_edit_box|inp_edit_box]] но с разными значениям данного параметра. Написав соответствующий метод для обработки полей, результат ввода данных можно будет сохранить в одном поле базы данных. Пример можно найти в In-Portal в секции "<code>Configuration -> Stylesheets -> Edit</code>".
|-
|-
-
| {{ConfigProperty|class|string}} || Where the style class is indicated for styling the input field([http://www.w3.org/TR/html401/struct/global.html#h-7.5.2 HTML element]).
+
| {{ConfigProperty|class|string}} || Указывается стилевой класс для отображения поля ввода ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
|-
|-
-
| {{ConfigProperty|format|string}} || The parameter lets you indicate a different format for displaying data for a field. The format passed in this black is higher priority than the format indicated in the [[K4:Unit Configs#Fields|unit config]].
+
| {{ConfigProperty|format|string}} || Данный параметр позволяет задать другой формат вывода данных для поля. Формат, переданный в блоке, является более приоритетным, чем формат указанный в [[K4:Unit Configs#Fields|unit config]].
|-
|-
-
| {{ConfigProperty|maxlength|int}} || The maximum number of characters that can be entered in a text field ([http://www.w3.org/TR/html401/interact/forms.html#adef-maxlength HTML элемент]). Not set by default.
+
| {{ConfigProperty|maxlength|int}} || Максимальное количество символов, вводимых в текстовом поле ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-maxlength HTML элемент]). По умолчанию не задано.
|-
|-
-
| {{ConfigProperty|onblur|string}} || Allows setting the event handler "<code>onblur</code>"([http://www.w3.org/TR/html401/interact/scripts.html#adef-onblur HTML элемент]).
+
| {{ConfigProperty|onblur|string}} || Позволяет задать обработчик события "<code>onblur</code>" ([http://manual.prod.intechnic.lv/html4/interact/scripts.html#adef-onblur HTML элемент]).
|-
|-
-
| {{ConfigProperty|size|int}} || Length of field in characters ([http://www.w3.org/TR/html401/interact/forms.html#adef-size-INPUT HTML элемент]).
+
| {{ConfigProperty|size|int}} || Ширина поля ввода в символах ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-size-INPUT HTML элемент]).
|-
|-
-
| {{ConfigProperty|onkeyup|string}} || Allows setting the event handler "<code>onkeyup</code>" ([http://www.w3.org/TR/html401/interact/scripts.html#adef-onkeyup HTML элемент]).
+
| {{ConfigProperty|onkeyup|string}} || Позволяет задать обработчик события "<code>onkeyup</code>" ([http://manual.prod.intechnic.lv/html4/interact/scripts.html#adef-onkeyup HTML элемент]).
|-
|-
-
| {{ConfigProperty|onchange|string}} || Allows setting the event handler "<code>onchange</code>" ([http://www.w3.org/TR/html401/interact/scripts.html#adef-onchange HTML элемент]).
+
| {{ConfigProperty|onchange|string}} || Позволяет задать обработчик события "<code>onchange</code>" ([http://manual.prod.intechnic.lv/html4/interact/scripts.html#adef-onchange HTML элемент]).
|-
|-
-
| {{ConfigProperty|style|string}} || Styling a field with standard styles ([http://www.w3.org/TR/html401/present/styles.html#adef-style HTML элемент]).
+
| {{ConfigProperty|style|string}} || Оформление поля с помощью стандартных стилей ([http://manual.prod.intechnic.lv/html4/present/styles.html#adef-style HTML элемент]).
|-
|-
-
| {{ConfigProperty|hint_label|string}} || The name of the phrase, the translation of which is shown as a hint to the right of an input field.
+
| {{ConfigProperty|hint_label|string}} || Название фразы, перевод которой должен быть показан в качестве подсказки справа от поля ввода.
|}
|}
== inp_edit_box_ml ==
== inp_edit_box_ml ==
-
[[Image:Inp_edit_box_ml.jpg|thumb|left|]] Regular edit box, except with a button that opens a pop-up, on which can be entered a value for the field in a different language. Used for multilingual sites (<code><input type="text"></code>).{{clear}}
+
[[Image:Inp_edit_box_ml.jpg|thumb|left|]] Простой edit box, но с кнопкой открытия всплывающего окна (<code>popup</code>) для ввода значения поля на других языках. Используется для многоязычных сайтов (<code><input type="text"></code>).{{clear}}
 +
 
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|class|string}} || Style class for the style of the input field ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
+
| {{ConfigProperty|class|string}} || Указывается стилевой класс для отображения поля ввода ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
|-
|-
-
| {{ConfigProperty|size|int}} || Character width of the input field ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-size-INPUT HTML элемент]).
+
| {{ConfigProperty|size|int}} || Ширина поля ввода в символах ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-size-INPUT HTML элемент]).
|-
|-
-
| {{ConfigProperty|maxlength|int}} || Maximum number of characters that can be entered in a text field ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-maxlength HTML элемент]). Not set by default.
+
| {{ConfigProperty|maxlength|int}} || Максимальное количество символов, вводимых в текстовом поле ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-maxlength HTML элемент]). По умолчанию не задано.
|-
|-
-
| {{ConfigProperty|style|string}} || Styling the field with standard styles ([http://manual.prod.intechnic.lv/html4/present/styles.html#adef-style HTML элемент]).
+
| {{ConfigProperty|style|string}} || Оформление поля с помощью стандартных стилей ([http://manual.prod.intechnic.lv/html4/present/styles.html#adef-style HTML элемент]).
|-
|-
-
| {{ConfigProperty|onblur|string}} || Allows setting the event handler "<code>onblur</code>" ([http://manual.prod.intechnic.lv/html4/interact/scripts.html#adef-onblur HTML element]).
+
| {{ConfigProperty|onblur|string}} || Позволяет задать обработчик события "<code>onblur</code>" ([http://manual.prod.intechnic.lv/html4/interact/scripts.html#adef-onblur HTML элемент]).
|}
|}
== inp_edit_password ==
== inp_edit_password ==
-
[[Image:Inp_edit_box.jpg|thumb|left|]] Password field (<code><input type="password"></code>).{{clear}}
+
[[Image:Inp_edit_box.jpg|thumb|left|]] Поле для ввода пароля (<code><input type="password"></code>).{{clear}}
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|class|string}} || Style class for styling the input field ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
+
| {{ConfigProperty|class|string}} || Указывается стилевой класс для отображения поля ввода ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
|-
|-
-
| {{ConfigProperty|size|int}} || Character width of input field ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-size-INPUT HTML элемент]).
+
| {{ConfigProperty|size|int}} || Ширина поля ввода в символах ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-size-INPUT HTML элемент]).
|-
|-
-
| {{ConfigProperty|style|string}} || Styling a field with standard styles ([http://manual.prod.intechnic.lv/html4/present/styles.html#adef-style HTML элемент]).
+
| {{ConfigProperty|style|string}} || Оформление поля с помощью стандартных стилей ([http://manual.prod.intechnic.lv/html4/present/styles.html#adef-style HTML элемент]).
|-
|-
-
| {{ConfigProperty|hint_label|string}} || The name of the phrase, the translation of which is shown as a hint to the right of the input field.
+
| {{ConfigProperty|hint_label|string}} || Название фразы, перевод которой должен быть показан в качестве подсказки справа от поля ввода.
|}
|}
== inp_edit_upload ==
== inp_edit_upload ==
-
[[Image:Inp_edit_upload.jpg|thumb|left|]] Used for (<code>uploading</code>) one file (<code><input type="file"></code>).{{clear}}
+
[[Image:Inp_edit_upload.jpg|thumb|left|]] Используется для загрузки (<code>upload</code>) одного файла (<code><input type="file"></code>).{{clear}}
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|class|string}} || Indicates style class for an input field ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML element]).
+
| {{ConfigProperty|class|string}} || Указывается стилевой класс для отображения поля ввода ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
|-
|-
-
| {{ConfigProperty|size|int}} || Width of field in characters ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-size-INPUT HTML element]).
+
| {{ConfigProperty|size|int}} || Ширина поля ввода в символах ([http://manual.prod.intechnic.lv/html4/interact/forms.html#adef-size-INPUT HTML элемент]).
 +
|-
 +
| {{ConfigProperty|style|string}} || Оформление поля с помощью стандартных стилей ([http://manual.prod.intechnic.lv/html4/present/styles.html#adef-style HTML элемент]). Для данного блока по умолчанию равно "<code>width: 100%; height: 45px;</code>".
|-
|-
-
| {{ConfigProperty|style|string}} || Formatting a field using standard styles ([http://manual.prod.intechnic.lv/html4/present/styles.html#adef-style HTML element]). By default, set to "<code>width: 100%; height: 45px;</code>".
+
| {{ConfigProperty|thumbnail|bool}} || Показывать пиктограмму загруженного изображения. Параметр имеет смысл использовать, когда заранее известно, что в поле будут загружаться изображения. Доступен начиная с [[K4:Core v 5.0.0|Core v 5.0.0]].
|}
|}
Line 119: Line 125:
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|db|int}} || If this field is passed, then the value of the field won't be processed with a [[K4:Formatters|formatter]] before being displayed on the screen.
+
| {{ConfigProperty|db|int}} || Если данный параметр передан, то значение в поле не будет обработано [[K4:Formatters|форматером]] перед выводом на экран.
|}
|}
== inp_edit_date ==
== inp_edit_date ==
-
[[Image:Inp_edit_date.jpg|thumb|left|]] Used for entering the date in the field in the format indicated during setup, (<code><input type="text"></code>).{{clear}}
+
[[Image:Inp_edit_date.jpg|thumb|left|]] Используется для ввода даты, в указанном при настройке поля, формате (<code><input type="text"></code>).{{clear}}
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|class|string}} || Sets style class of the input type ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
+
| {{ConfigProperty|class|string}} || Указывается стилевой класс для отображения поля ввода ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
|}
|}
== inp_edit_time ==
== inp_edit_time ==
-
[[Image:Inp_edit_time.jpg|thumb|left|]] Used for entering the date in the field in the format indicated during setup, (<code><input type="text"></code>).{{clear}}
+
[[Image:Inp_edit_time.jpg|thumb|left|]] Используется для ввода времени, в указанном при настройке поля, формате (<code><input type="text"></code>).{{clear}}
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|class|string}} || Sets style class of the input type ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
+
| {{ConfigProperty|class|string}} || Указывается стилевой класс для отображения поля ввода ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
|}
|}
== inp_edit_date_time ==
== inp_edit_date_time ==
-
[[Image:Inp_edit_date_time.jpg|thumb|left|]] Used for entering the date in the field in the format indicated during setup, (<code><input type="text"></code>).{{clear}}
+
[[Image:Inp_edit_date_time.jpg|thumb|left|]] Используется для ввода даты и времени, в указанном при настройке поля, формате (<code><input type="text"></code>).{{clear}}
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|class|string}} || Sets style class of the input type ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
+
| {{ConfigProperty|class|string}} || Указывается стилевой класс для отображения поля ввода ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
|}
|}
== inp_edit_textarea ==
== inp_edit_textarea ==
-
[[Image:Inp_edit_textarea.jpg|thumb|left|]] Used for entering a (<code><textarea> </textarea></code>).{{clear}}
+
[[Image:Inp_edit_textarea.jpg|thumb|left|]] Используется для ввода (<code><textarea> </textarea></code>).{{clear}}
{| class="prettytable"
{| class="prettytable"
-
! parameter || description
+
! параметр || описание
|-
|-
-
| {{ConfigProperty|class|string}} || Sets style class of the input type ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
+
| {{ConfigProperty|class|string}} || Указывается стилевой класс для отображения поля ввода ([http://manual.prod.intechnic.lv/html4/struct/global.html#h-7.5.2 HTML элемент]).
|-
|-
-
| {{ConfigProperty|format|string}} || The parameter allows indicating a different format for displaying data in a field. The format passed in this block is higher priority than the one set in the[[K4:Unit Configs#Fields|unit config]].
+
| {{ConfigProperty|format|string}} || Данный параметр позволяет задать другой формат вывода данных для поля. Формат, переданный в блоке, является более приоритетным, чем формат указанный в [[K4:Unit Configs#Fields|unit config]].
|-
|-
-
| {{ConfigProperty|edit_template|string}} || This parameter allows setting the template used for editing a field. By default, set to "<code>popups/editor</code>", in other words the location of the <code>FCKEditor</code>. Available since [[K4:Core v 4.3.1|Core v 4.3.1]].
+
| {{ConfigProperty|edit_template|string}} || Данный параметр позволяет задавать шаблон, используемый для редактирования данного поля. По умолчанию равен "<code>popups/editor</code>", т.е. где находиться <code>FCKEditor</code>. Доступен начиная с [[K4:Core v 4.3.1|Core v 4.3.1]].
|-
|-
| {{ConfigProperty|allow_html|string}} || Если значение данного параметра будет равно "<code>allow_html</code>" (что является значением по умолчанию), то слева от поля будет показана специальная пиктограмма. При нажатии на данную пиктограмму во всплывающем окне (<code>popup</code>) будет открыт <code>FCKEditor</code>.
| {{ConfigProperty|allow_html|string}} || Если значение данного параметра будет равно "<code>allow_html</code>" (что является значением по умолчанию), то слева от поля будет показана специальная пиктограмма. При нажатии на данную пиктограмму во всплывающем окне (<code>popup</code>) будет открыт <code>FCKEditor</code>.
Line 365: Line 371:
| {{ConfigProperty|control_options|string}} || Данный параметр позволяет задать минимальную и максималную высоту (в пикселях) для данного элемента в виде <code>JavaScript</code> объекта, напр. "<code>{min_height: 200, max_height: 300}</code>". В последсвии это значение будет использоваться при изменении размера (<code>resize</code>) формы. Данный параметр доступен только начиная с [[K4:Core v 4.2.0|Core v 4.2.0]].
| {{ConfigProperty|control_options|string}} || Данный параметр позволяет задать минимальную и максималную высоту (в пикселях) для данного элемента в виде <code>JavaScript</code> объекта, напр. "<code>{min_height: 200, max_height: 300}</code>". В последсвии это значение будет использоваться при изменении размера (<code>resize</code>) формы. Данный параметр доступен только начиная с [[K4:Core v 4.2.0|Core v 4.2.0]].
|}
|}
 +
 +
[[ru:{{FULLPAGENAME}}]]
 +
[[en:K4:Input Elements on Forms]]

Current revision

Работа с формами Работа с формами
Статьи в этой категории

На каждой, использующейся в административной консоли, форме встречаются элементы ввода. Элементы ввода являются одним из основных способов редактирования записей из базы данных. Все упомянутые в данной статье элементы ввода объявлены в шаблоне "incs/form_blocks.tpl". Каждый элемент состоит из 2 частей - левой и правой. В левой части находиться:

  • название поля;
  • пометка о том, что поле является обязательным к заполнению;
  • дополнительные кнопки (напр. открытия FCKEditor);

В правой части находиться сам элемент ввода. Т.к. элементов и способов ввода информации может быть много, то на каждый из них создан отдельный блок. В общей форме все такого рода блоки называются "inp_edit_<type>", где <type> - это слово, по которому можно узнать, что за блок будет нарисован.

У всех, из ниже перечисленных блоков есть несколько общих параметров, которые будут перечислены далее.

параметр описание
prefix (string) В данном параметре задаётся префикс того unit config, чья запись будет редактироваться на форме.
field (string) Название поля (из базы данных или виртуального), значение которого будет показано или будет редактироваться в этом блоке.
title (string) Название фразы, перевод которой будет отображён в левой части блока в качестве названия поля для пользователей. Согласно правилам назначения имён название фразы должно начинаться с "la_fld_".
is_last (int) Данный параметр позволяет указать, что этот элемент на форме является последним. Обычно такие элементы оформляются специальным образом.

Contents

inp_label

Данный блок предназначен для вывода значения какого либо поля, без возможности его редактирования на форме.

параметр описание
hint_label (string) Название фразы, перевод которой должен быть показан в качестве подсказки справа от поля ввода.
as_label (int) Если данный параметр установлен, то значение в поле будет интерпретировано как название фразы и будет переведено перед отображением на форме.
currency (string) Для полей, содержащих цену позволяет задать ISO код валюты, в которой нужно показывать значение данного поля (значение автоматически пересчитывается в зависимости от куса указанной валюты к курсу основной валюты сайта). Также можно передать значение "selected", что приведёт к тому, что цена будет выводиться в валюте, которую выбрал пользователь. Например будет выведено "USD 15.11", когда в базе данных будет значение "15.11".
style (string) Оформление поля с помощью стандартных стилей (HTML элемент).
format (string) Данный параметр позволяет задать другой формат вывода данных для поля. Формат, переданный в блоке, является более приоритетным, чем формат указанный в unit config.
nl2br (int) При передаче данного параметра на выводимое значение будет применена функция nl2br.
no_special (int) При передаче данного параметра на выводимое значение не будет применена функция htmlspecialchars. Параметр добавлен начиная с Core v 5.0.0.

inp_id_label

Данный блок полностью идентичен функциональности блоку inp_label, но результат работы блока будет виден на форме только тогда, когда в поле будет значение. Этот блок обычно используется для отображения значения основного поля (primary key) таблицы.

inp_edit_box

Простой edit box (<input type="text">).
параметр описание
subfield (string) Может служить для обработки массива хранящегося в базе данных в сериализованного виде. Например на форме ввода находиться несколько inp_edit_box но с разными значениям данного параметра. Написав соответствующий метод для обработки полей, результат ввода данных можно будет сохранить в одном поле базы данных. Пример можно найти в In-Portal в секции "Configuration -> Stylesheets -> Edit".
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).
format (string) Данный параметр позволяет задать другой формат вывода данных для поля. Формат, переданный в блоке, является более приоритетным, чем формат указанный в unit config.
maxlength (int) Максимальное количество символов, вводимых в текстовом поле (HTML элемент). По умолчанию не задано.
onblur (string) Позволяет задать обработчик события "onblur" (HTML элемент).
size (int) Ширина поля ввода в символах (HTML элемент).
onkeyup (string) Позволяет задать обработчик события "onkeyup" (HTML элемент).
onchange (string) Позволяет задать обработчик события "onchange" (HTML элемент).
style (string) Оформление поля с помощью стандартных стилей (HTML элемент).
hint_label (string) Название фразы, перевод которой должен быть показан в качестве подсказки справа от поля ввода.

inp_edit_box_ml

Простой edit box, но с кнопкой открытия всплывающего окна (popup) для ввода значения поля на других языках. Используется для многоязычных сайтов (<input type="text">).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).
size (int) Ширина поля ввода в символах (HTML элемент).
maxlength (int) Максимальное количество символов, вводимых в текстовом поле (HTML элемент). По умолчанию не задано.
style (string) Оформление поля с помощью стандартных стилей (HTML элемент).
onblur (string) Позволяет задать обработчик события "onblur" (HTML элемент).

inp_edit_password

Поле для ввода пароля (<input type="password">).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).
size (int) Ширина поля ввода в символах (HTML элемент).
style (string) Оформление поля с помощью стандартных стилей (HTML элемент).
hint_label (string) Название фразы, перевод которой должен быть показан в качестве подсказки справа от поля ввода.

inp_edit_upload

Используется для загрузки (upload) одного файла (<input type="file">).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).
size (int) Ширина поля ввода в символах (HTML элемент).
style (string) Оформление поля с помощью стандартных стилей (HTML элемент). Для данного блока по умолчанию равно "width: 100%; height: 45px;".
thumbnail (bool) Показывать пиктограмму загруженного изображения. Параметр имеет смысл использовать, когда заранее известно, что в поле будут загружаться изображения. Доступен начиная с Core v 5.0.0.

inp_edit_hidden

(<input type="hidden">)

параметр описание
db (int) Если данный параметр передан, то значение в поле не будет обработано форматером перед выводом на экран.

inp_edit_date

Используется для ввода даты, в указанном при настройке поля, формате (<input type="text">).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).

inp_edit_time

Используется для ввода времени, в указанном при настройке поля, формате (<input type="text">).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).

inp_edit_date_time

Используется для ввода даты и времени, в указанном при настройке поля, формате (<input type="text">).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).

inp_edit_textarea

Используется для ввода (<textarea> </textarea>).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).
format (string) Данный параметр позволяет задать другой формат вывода данных для поля. Формат, переданный в блоке, является более приоритетным, чем формат указанный в unit config.
edit_template (string) Данный параметр позволяет задавать шаблон, используемый для редактирования данного поля. По умолчанию равен "popups/editor", т.е. где находиться FCKEditor. Доступен начиная с Core v 4.3.1.
allow_html (string) Если значение данного параметра будет равно "allow_html" (что является значением по умолчанию), то слева от поля будет показана специальная пиктограмма. При нажатии на данную пиктограмму во всплывающем окне (popup) будет открыт FCKEditor.
style (string) Оформление поля с помощью стандартных стилей (HTML элемент). Для данного блока по умолчанию равно "width: 100%; height: 45px;".
control_options (string) Данный параметр позволяет задать минимальную и максималную высоту (в пикселях) для данного элемента в виде JavaScript объекта, напр. "{min_height: 200, max_height: 300}". В последсвии это значение будет использоваться при изменении размера (resize) формы. Данный параметр доступен только начиная с Core v 4.2.0.

inp_edit_textarea_ml

Используется для ввода текста, но с кнопкой открытия всплывающего окна (popup) для ввода значения поля на других языках. Используется для многоязычных сайтов (<textarea> </textarea>).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).
format (string) Данный параметр позволяет задать другой формат вывода данных для поля. Формат, переданный в блоке, является более приоритетным, чем формат указанный в unit config.
allow_html (string) Если значение данного параметра будет равно "allow_html" (что является значением по умолчанию), то слева от поля будет показана специальная пиктограмма. При нажатии на данную пиктограмму во всплывающем окне (popup) будет открыт FCKEditor.
style (string) Оформление поля с помощью стандартных стилей (HTML элемент). Для данного блока по умолчанию равно "width: 100%; height: 45px;".
control_options (string) Данный параметр позволяет задать минимальную и максимальную высоту (в пикселях) для данного элемента в виде JavaScript объекта, напр. "{min_height: 200, max_height: 300}". В последсвии это значение будет использоваться при изменении размера (resize) формы. Данный параметр доступен только начиная с Core v 4.2.0.
cols (int) Позволяет задать количество столбцов в элементе (HTML элемент).
rows (int) Позволяет задать количество строк в элементе (HTML элемент).

inp_edit_fck

Поле редактируемое с помощью интегрированного FCKEditor.
параметр описание
bgcolor (string) Данный параметр позволяет задать цвет фона окна редактирования в FCKEditor.
control_options (string) Данный параметр позволяет задать минимальную и максимальную высоту (в пикселях) для данного элемента в виде JavaScript объекта, напр. "{min_height: 200, max_height: 300}". В последсвии это значение будет использоваться при изменении размера (resize) формы. Данный параметр доступен только начиная с Core v 4.2.0.

inp_edit_user

Используется для выбора пользователя (в базе будет храниться его ID). Рядом находящаяся кнопка открывает список пользователей, в котором выбирается требуемый (<input type="text">).
параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).
onkeyup (string) Позволяет задать обработчик события "onkeyup" (HTML элемент).
size (int) Ширина поля ввода в символах (HTML элемент).

inp_edit_category

Данный блок позволяет выбрать категорию, используя всплывающее окно (popup) со списком категорий. В результате в качестве значения поля будет ID выбранной категории, но на форме будет показываться путь к ней.

inp_edit_options

DropDown (<select> </select>).
параметр описание
onchange (string) Позволяет задать обработчик события "onchange" (HTML элемент).
has_empty (int) Если задан, то данный параметр говорит о том, что перед списком опций будет автоматически добавлена пустая опция.
empty_value (int) Данный параметр позволяет задать значение (value) пустой опции, в случае, когда она будет автоматически добавлена.
style (string) Оформление поля с помощью стандартных стилей (HTML элемент).

inp_edit_multioptions

Multiple DropDown (<select multiple> </select>).
параметр описание
onchange (string) Позволяет задать обработчик события "onchange" (HTML элемент).
has_empty (int) Если задан, то данный параметр говорит о том, что перед списком опций будет автоматически добавлена пустая опция.
empty_value (int) Данный параметр позволяет задать значение (value) пустой опции, в случае, когда она будет автоматически добавлена.
style (string) Оформление поля с помощью стандартных стилей (HTML элемент).

inp_edit_radio

Дает возможность сделать выбор значения с помощью Radio Buttons (<input type="radio">).
параметр описание
onchange (string) Позволяет задать обработчик события "onchange" (HTML элемент).
onclick (string) Позволяет задать обработчик события "onclick" (HTML элемент).

inp_edit_checkbox

Дает возможность сделать выбор значения с помощью CheckBox (<input type="checkbox">).
параметр описание
onchange (string) Позволяет задать обработчик события "onchange" (HTML элемент).
onclick (string) Позволяет задать обработчик события "onclick" (HTML элемент).
field_class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).

inp_edit_checkboxes

Дает возможность сделать выбор значений с помощью нескольких CheckBoxes (<input type="checkbox">).
параметр описание
no_empty (int) Если передать, то не будет напечатана опция с пустым значением. Позволяет решать проблему с некорректно заданной (в unit config) пустой опцией (в случае, когда раньше вместо этого блока использовался блок inp_edit_options).

inp_edit_checkbox_allow_html

В Platform не используется, используется в In-Portal при редактировании рецензий товара.

параметр описание
field_class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).

inp_edit_weight

Используется для ввода веса согласно значению поля UnitSystem в таблице Language. Если выбрана Американская система, то показывается 2 поля для ввода lbs и oz, если Европейская то показывается одно поле для ввода kg.
параметр описание
subfield (string) Может служить для обработки массива хранящегося в базе данных в сериализованного виде. Например на форме ввода находиться несколько inp_edit_box но с разными значениям данного параметра. Написав соответствующий метод для обработки полей, результат ввода данных можно будет сохранить в одном поле базы данных. Пример можно найти в In-Portal в секции "Configuration -> Stylesheets -> Edit".
class (string) Указавается стилевой класс для отображения поля ввода (HTML элемент).
maxlength (int) Максимальное количество символов, вводимых в текстовом поле (HTML элемент). По умолчанию не задано.
size (int) Ширина поля ввода в символах (HTML элемент). Для данного блока по умолчанию равно "15".

inp_edit_swf_upload

Используется для загрузки файлов большого размера или большого количества файлов одновременно. Во время загрузки показывает progress bar c процессом загрузки каждого файла на сервер. Перед использованием данного блока необходимо убедиться, что подключены файлы "js/swfobject.js" и "js/uploader.js". Если такие файлы не подключены, то это можно сделать используя следующий код: 
<script type="text/javascript" src="js/swfobject.js"></script>
<script type="text/javascript" src="js/uploader.js"></script>

Приведённый выше код следует разместить после объявления панели инструментов (toolbar).

параметр описание
class (string) Указывается стилевой класс для отображения поля ввода (HTML элемент).
style (string) Оформление поля с помощью стандартных стилей (HTML элемент).

inp_edit_picker

Данный блок представляет из себя два поля в одном из которых находятся выбранные элементы, а во втором все доступные элементы за исключением уже выбранных. Блок позволяет выбрать несколько элементов одновременно и перенести их во второй список. Более подробная информация об этом блоке доступна в этой статье.
параметр описание
style (string) Оформление поля с помощью стандартных стилей (HTML элемент). Для данного блока по умолчанию равно "width: 225px;".
size (int) Ширина поля ввода в символах (HTML элемент). Для данного блока по умолчанию равно "15".
optprefix (string) Префикс, данные которого будут использованы для заполнения списка доступных и выбранных опций.
option_key_field (string) Поле, объявленное в unit config префикса опций, которое содержит идентификатор (ID) опции.
option_value_field (string) Поле, объявленное в unit config префикса опций, которое содержит название опции.

inp_edit_minput

Блок используется для класса, который предназначен для ввода списка дополнительных данных в схожем формате, характеризующих основной предмет. Например, человек (people) - это пример основной сущности, а список его детей (children) - это пример дополнительной сущности. Т.е. ребенок (children) это подчинённый префикс для главного префикса people. Более подробная информация об этом блоке доступна в этой статье.
параметр описание
format (string) Значением данного параметра является строка, которая может состоять из названий полей (зарегистрированных в шаблоне при помощи метода registerControl) и любого текста. Название каждого поля должно быть заключено в символы "#". Например "#ChildFullName# #ChildBirthDate_date#". Фразы использовать нельзя, т.к. они не обрабатываются.
style (string) Оформление поля с помощью стандартных стилей (HTML элемент). Для данного блока по умолчанию равно "width: 100%; height: 45px;".
allow_add (int) Можно разрешить/запретить добавление элементов списка, по умолчанию разрешено.
allow_edit (int) Можно разрешить/запретить редактирование элементов списка, по умолчанию разрешено.
allow_delete (int) Можно разрешить/запретить удаление элементов списка, по умолчанию разрешено.
allow_move (int) Можно разрешить/запретить перемещение элементов вверх и вниз в списке, по умолчанию разрешено. Добавлен начиная с Core v 4.3.1.
Image:Tipbox Icon.gif В зависимости от того, как будет обрабатываться полученный XML может получиться, что в базе данных ничего перемещаться не будет.

inp_edit_filler

Данный блок заполняет градиентом свободное пространство во всплывающих окнах (popups).

параметр описание
control_options (string) Данный параметр позволяет задать минимальную и максималную высоту (в пикселях) для данного элемента в виде JavaScript объекта, напр. "{min_height: 200, max_height: 300}". В последсвии это значение будет использоваться при изменении размера (resize) формы. Данный параметр доступен только начиная с Core v 4.2.0.
Retrieved from "http://guide.in-portal.org/rus/index.php/K4:%D0%AD%D0%BB%D0%B5%D0%BC%D0%B5%D0%BD%D1%82%D1%8B_%D0%B2%D0%B2%D0%BE%D0%B4%D0%B0_%D0%B4%D0%B0%D0%BD%D0%BD%D1%8B%D1%85_%D0%BD%D0%B0_%D1%84%D0%BE%D1%80%D0%BC%D0%B0%D1%85"