diff --git a/docs/ru/appendixes/tips.xml b/docs/ru/appendixes/tips.xml index 30766909..29ee7e1c 100644 --- a/docs/ru/appendixes/tips.xml +++ b/docs/ru/appendixes/tips.xml @@ -241,9 +241,9 @@ function makeTimeStamp($year='', $month='', $day='') был передан вместе с шаблоном. Простейший путь - написать пользовательскую функцию, которая будет выводить заголовки. Если вы используете кэширование, - это не сработает, так что мы сделаем это с помощью тега + это не сработает, так что мы сделаем это с помощью тэга {insert}; - не забывайте, что теги {insert} не кэшируются! + не забывайте, что тэги {insert} не кэшируются! Убедитесь, что перед шаблоном в браузер ничего не выводится, иначе отправить заголовок не получится. diff --git a/docs/ru/designers/language-builtin-functions/language-function-foreach.xml b/docs/ru/designers/language-builtin-functions/language-function-foreach.xml index d45627de..452b042a 100644 --- a/docs/ru/designers/language-builtin-functions/language-function-foreach.xml +++ b/docs/ru/designers/language-builtin-functions/language-function-foreach.xml @@ -13,7 +13,7 @@ {foreach} намного проще синтаксиса {section}, но с другой стороны его можно использовать только для одного массива. - Каждый тег {foreach} должен иметь пару + Каждый тэг {foreach} должен иметь пару {/foreach}. Обязательными параметрами являются from и item. Имя цикла {foreach} может быть любым, состоящим из букв, цифр и знаков diff --git a/docs/ru/designers/language-builtin-functions/language-function-if.xml b/docs/ru/designers/language-builtin-functions/language-function-if.xml index 700c0f8b..a5f521e0 100644 --- a/docs/ru/designers/language-builtin-functions/language-function-if.xml +++ b/docs/ru/designers/language-builtin-functions/language-function-if.xml @@ -1,6 +1,6 @@ - + {if},{elseif},{else} @@ -17,6 +17,12 @@ is_array() и т.д. + + Если $security включена, + то массив IF_FUNCS в массиве $security_settings. + + Ниже следует список распознаваемых квалификаторов, которые должны быть отделены от окружающих элементов пробелами. Обратите внимания, что @@ -165,15 +171,6 @@ ... {/if} -{* - следующий пример НЕ будет работать, квалификаторы условий следует - отделять от окружающих элементов пробелами -*} -{if $name=="Fred" || $name=="Wilma"} - ... -{/if} - - {* скобки разрешены *} {if ( $amount < 0 or $amount > 1000 ) and $volume >= #minVolAmt#} ... @@ -184,6 +181,16 @@ ... {/if} +{* проверка на массив *} +{if is_array($foo) } + ... +{/if} + +{* проверка на существование *} +{if isset($foo) } + ... +{/if} + {* проверяет чётность значений *} {if $var is even} ... @@ -212,18 +219,6 @@ {if $var is even by 3} ... {/if} - -{* ------- if с функциями PHP ------- *} -{* check for array. *} -{if is_array($foo) } - ..... -{/if} - -{* проверка на существование *} -{if isset($foo) } - ..... -{/if} - ]]> diff --git a/docs/ru/designers/language-builtin-functions/language-function-include.xml b/docs/ru/designers/language-builtin-functions/language-function-include.xml index 6b64fb5f..83e4cdb4 100644 --- a/docs/ru/designers/language-builtin-functions/language-function-include.xml +++ b/docs/ru/designers/language-builtin-functions/language-function-include.xml @@ -1,6 +1,6 @@ - + {include} @@ -13,7 +13,13 @@ Опциональный атрибут assign указывает, что результат выполнения {include} будет присвоен переменной вместо отображения. - + + Все значения присвоенных переменных восстанавливаются после того, + как подключаемый шаблон отработал. Это значит, что вы можете использовать + все переменные из подключающего шаблона в подключаемом, но изменения + переменных внутри подключаемого шаблона не будут видны внутри подключающего + шаблона после команды {include}. + diff --git a/docs/ru/designers/language-builtin-functions/language-function-section.xml b/docs/ru/designers/language-builtin-functions/language-function-section.xml index edea07e2..b458f95d 100644 --- a/docs/ru/designers/language-builtin-functions/language-function-section.xml +++ b/docs/ru/designers/language-builtin-functions/language-function-section.xml @@ -7,7 +7,7 @@ Секции используются для обхода массивов данных (так же, как и {foreach}). - Каждый тег {section} должен иметь пару + Каждый тэг {section} должен иметь пару {/section}. Обязательными параметрами являются name и loop. Имя цикла {section} может быть любым, состоящим из букв, цифр и знаков diff --git a/docs/ru/designers/language-builtin-functions/language-function-strip.xml b/docs/ru/designers/language-builtin-functions/language-function-strip.xml index f4cec74c..bf933f18 100644 --- a/docs/ru/designers/language-builtin-functions/language-function-strip.xml +++ b/docs/ru/designers/language-builtin-functions/language-function-strip.xml @@ -6,7 +6,7 @@ Часто вебдизайнеры сталкиваются с проблемой, что пробелы и переносы строк влияют на отображение HTML в броузере ("фишки" броузера), то - есть может понадобится склеить все теги в шаблоне вместе, чтобы получить + есть может понадобится склеить все тэги в шаблоне вместе, чтобы получить желаемый результат. Но в результате получается нечитаемый или трудноредактируемый шаблон. diff --git a/docs/ru/designers/language-custom-functions/language-function-assign.xml b/docs/ru/designers/language-custom-functions/language-function-assign.xml index 7c32d07b..031bc9c7 100644 --- a/docs/ru/designers/language-custom-functions/language-function-assign.xml +++ b/docs/ru/designers/language-custom-functions/language-function-assign.xml @@ -1,8 +1,13 @@ - + - assign + {assign} + + {assign} используется для установки значения переменной + в процессе выполнения шаблона. + + @@ -38,24 +43,87 @@ - - assign используется для установки значения переменной в - процессе выполнения шаблона. - + - assign + {assign} + + + Результат выполнения данного примера: + + + + + + + + Доступ к переменным {assign} из PHP-скрипта. + + Чтобы получить доступ к переменным {assign} из PHP используйте функцию + get_template_vars(). + Обратите внимание, что переменные доступны только во время и после + выполнения шаблона, как видно из следующего примера: + + + + + +get_template_vars('foo'); + +// получаем шаблон в переменную-пустышку +$dead = $smarty->fetch('index.tpl'); + +// это выведет 'smarty', так как шаблон уже выполнен +echo $smarty->get_template_vars('foo'); + +$smarty->assign('foo','Even smarter'); + +// это выведет 'Even smarter' +echo $smarty->get_template_vars('foo'); + +?> ]]> + + + Следующие функции также могут опционально + назначать переменные шаблона. + + + + {capture}, + {include}, + {include_php}, + {insert}, + {counter}, + {cycle}, + {eval}, + {fetch}, + {math}, + {textformat} + + + + См. также + assign() + и + get_template_vars(). + - - - counter - - - - - - - - - - Имя атрибута - Тип - Обязателен - По умолчанию - Описание - - - - - name - string - Нет - default - Имя счетчика - - - start - number - Нет - 1 - Начальное значение счетчика - - - skip - number - Нет - 1 - Шаг счетчика - - - direction - string - Нет - up - Направление (вверх - up/вниз - down) - - - print - boolean - Нет - true - выводить значение счетчика или нет - - - assign - string - Нет - n/a - Имя переменной, которой будет присвоен - вывод - - - - - - counter используется для управления счетчиком. counter запоминает - количество итераций. Можно регулировать начало, интервал и - направление отсчета, а также указать, выводить ил значение - счетчика или нет. Можно запустить несколько счетчиков одновременно, - указав уникальное имя для каждого. Если имя счетчика не указано, - будет использовано по умолчанию 'default'. - - - Если указан атрибут "assign", то вывод тэга counter будет присвоен - переменной шаблона, вместо отображения. - - -counter - + + + {counter} + + {counter} используется для вывода счетчика. {counter} запоминает значение + счетчика на каждой итерации. Вы можете настроить значение, интервал + и направление счета, а так же определить, следует ли печатать это значение. + Вы можете использовать несколько счетчиков одновременно, назначив каждому + уникальное имя. Если вы явно не указываете имени, используется имя 'default'. + + + Если вы укажете специальный атрибут "assign", вывод счетчика будет назначен + соответствующей переменной шаблона вместо печати в шаблон. + + + + + + + + + + + + Имя атрибута + Тип + Обязателен + По умолчанию + Описание + + + + + name + string + Нет + default + Имя счетчика + + + start + number + Нет + 1 + Изначальное число, с которого начинается счет + + + skip + number + Нет + 1 + Интервал увеличения счетчика + + + direction + string + Нет + up + Направление счета (up/down) + + + print + boolean + Нет + true + Печатать ли значение счетчика + + + assign + string + Нет + n/a + Имя переменной шаблона для сохранения значения счетчика + + + + + + + {counter} + + - +{counter start=0 skip=2}
+{counter}
+{counter}
+{counter}
+]]> + + + Результат выполнения данного примера: + + + +2
+4
+6
+]]> + + +--> \ No newline at end of file diff --git a/docs/ru/designers/language-custom-functions/language-function-cycle.xml b/docs/ru/designers/language-custom-functions/language-function-cycle.xml index e6d6246e..5aa53e9a 100644 --- a/docs/ru/designers/language-custom-functions/language-function-cycle.xml +++ b/docs/ru/designers/language-custom-functions/language-function-cycle.xml @@ -1,117 +1,137 @@ - - - cycle - - - - - - - - - - Имя атрибута - Тип - Обязателен - По умолчанию - Описание - - - - - name - string - Нет - default - Название цикла - - - values - mixed - Да - N/A - Значения, по которым будет производиться цикл. - Либо список, разделеный запятыми (либо другим указанным - разделителем), либо массив значений. - - - print - boolean - Нет - true - Выводить значение, или нет - - - advance - boolean - Нет - true - Переключаться или нет на следующее значение - - - delimiter - string - Нет - , - Разделитель, используемый в атрибуте values. - - - assign - string - Нет - n/a - Имя переменной, которой будет присвоен вывод тэга - - - - - - Cycle используется для прохода через множество значений. - С его помощью можно легко реализовать переключение между - двумя и более цветами в таблице, или пройти цикл через - массив. - - - Можно проходить через несколько множеств значений одновременно, - указав атрибут name. Имена должны быть уникальными. - - - Можно не отображать данный элемент, установив атрибут print в - ложь (false). Удобно для пропуска значения, без его вывода. - - - Атрибут advance используется для повтора значения. Если - установлен в истина (true), то при следующем вызове cycle - будет выведено то же значение. - - - Если указан специальный атрибут "assign", то вывод cycle - присваивается переменной, вместо отображения. - - -cycle - + + + {cycle} + + {cycle} is used to cycle though a set of values. This makes it easy + to alternate for example between two or more colors in a table, or cycle + through an array of values. + + + {cycle} используется для прохода через множество значений. + С его помощью можно легко реализовать чередование двух или более цветов в + таблице или пройтись циклом по массиву. + + + + + + + + + + + + Имя атрибута + Тип + Обязателен + По умолчанию + Описание + + + + + name + string + Нет + default + Название цикла + + + values + mixed + Да + N/A + + Значения, по которым будет производиться цикл. + Либо список, разделеный запятыми (либо другим указанным разделителем), + либо массив значений. + + + + print + boolean + Нет + true + Выводить значение, или нет + + + advance + boolean + Нет + true + Переключаться или нет на следующее значение + + + delimiter + string + Нет + , + Разделитель, используемый в атрибуте values. + + + assign + string + Нет + n/a + Имя переменной, которой будет присвоен вывод тэга + + + reset + boolean + Нет + false + Цикл будет установлен в начальное значение и не увеличен + + + + + + + Можно проходить через несколько множеств значений одновременно, + указав атрибут name. Имена должны быть уникальными. + + + Можно не отображать данный элемент, установив атрибут print в + false. Удобно для пропуска значения, без его вывода. + + + Атрибут advance используется для повтора значения. Если + установлен в true, то при следующем вызове {cycle} + будет выведено то же значение. + + + Если указан специальный атрибут "assign", то вывод {cycle} + присваивается переменной, вместо отображения. + + + + {cycle} + + + {$data[rows]} + {/section} +]]> + + + + 1 + + + 2 + + + 3 + +]]> + + -OUTPUT: - -<tr bgcolor="#eeeeee"> - <td>1</td> -</tr> -<tr bgcolor="#d0d0d0"> - <td>2</td> -</tr> -<tr bgcolor="#eeeeee"> - <td>3</td> -</tr> - - - - - debug - - - - - - - - - - Имя атрибута - Тип - Обязателен - По умолчанию - Описание - - - - - output - string - Нет - html - Тип вывода (html или javascript) - - - - - - {debug} выводит консоль отладки. Это работает независимо от - значения опции debug. - Так как этот тэг обрабатывается в процесе выполнения, то возможно - вывести только присвоенные переменные, но не используемые шаблоны. - Но вы видите все переменные, доступные в области видимости текущего - шаблона. - + + + {debug} + + + + + + + + + + Имя атрибута + Тип + Обязателен + По умолчанию + Описание + + + + + output + string + Нет + javascript + Тип вывода (html или javascript) + + + + + + + {debug} выводит консоль отладки. Это работает независимо от + значения опции debug. + Так как этот тэг обрабатывается в процесе выполнения, то возможно + вывести только присвоенные переменные, + но не используемые шаблоны. + Но вы видите все переменные, доступные в области видимости текущего + шаблона. + + + См. также + Отладочная консоль. + - - - eval - - - - - - - - - - Имя атрибута - Тип - Обязателен - По умолчанию - Описание - - - - - var - mixed - Да - n/a - Переменная (или строка) для обработки - - - assign - string - Нет - n/a - Имя переменной, которой будет присвоен вывод - - - - - - eval используется для обработки переменной, как шаблона. Можно - использовать для таких вещей, как хранение шаблонных - тэгов/переменных в переменной или в файлах конфигруации. - - - Если указан специальный атрибут "assign", то вывод тэга eval - присваивается переменной, вместо отображения. - - - Техническое Замечание - + + + {eval} + + {eval} используется для обработки переменной, как шаблона. + Можно использовать для таких вещей, как хранение шаблонных + тэгов/переменных в переменной или в файлах конфигруации. + + + Если указан специальный атрибут "assign", то вывод тэга eval + присваивается переменной, вместо отображения. + + + + + + + + + + + + Имя атрибута + Тип + Обязателен + По умолчанию + Описание + + + + + var + mixed + Да + n/a + Переменная (или строка) для обработки + + + assign + string + Нет + n/a + Имя переменной, которой будет присвоен вывод + + + + + + + Техническое Замечание + Переменные шаблоны обрабатываются так же, как и обычные шаблоны. Они подвластны тем же правилам и ограничениям безопасности. - - - - Техническое Замечание - - Переменные шаблоны компилируются при каждом обращении. - Откомпилированные версии не сохраняются! Однако, если - кэширование включено, то вывод будет закэширован с - остальной частью шаблона. - - - -eval - -setup.conf ----------- + + -emphstart = <b> -emphend = </b> -title = Welcome to {$company}'s home page! -ErrorCity = You must supply a {#emphstart#}city{#emphend#}. -ErrorState = You must supply a {#emphstart#}state{#emphend#}. + + Техническое Замечание + + Переменные шаблоны компилируются при каждом вызове, скомпилированные версии + не сохраняются! + Однако, если кэширование включено, + вывод будет кэширован вместе с остальной частью шаблона. + + + + {eval} + + + emphend = + title = Welcome to {$company}'s home page! + ErrorCity = You must supply a {#emphstart#}city{#emphend#}. + ErrorState = You must supply a {#emphstart#}state{#emphend#}. +]]> + + + index.tpl: + + + - + {eval var=$foo} + {eval var=#title#} + {eval var=#ErrorCity#} + {eval var=#ErrorState# assign="state_error"} + {$state_error} +]]> + + + Результат выполнения данного примера: + + +city. + You must supply a state. +]]> + + - + - fetch + {fetch} + + fetch используется для отображения содержимого локальных файлов, + http- или ftp-страниц. + Если имя файла начинается с "http://", то веб-страница будет получена и + выведена. + Если имя файла начинается с "ftp://", то файл будет получен с ftp-сервера и + выведен. Для локальных файлов должен быть указан абсолютный путь, + либо путь относительно выполняемого PHP-файла. + + + Если указать специалньый атрибут "assign", то вывод функции {fetch} + будет присвоен переменной шаблона, вместо отображения. Добавлено в + Smarty версии 1.5.0. + + @@ -37,19 +52,7 @@ - - fetch используется для отображения локальных файлов, http или ftp - страниц. Если файл начинается с "http://", то вебстраница будет - получена и выведена. Если файл начинается с "ftp://", то файл будет - получен с ftp сервера и выведен. Для локальных файлов должен быть - указан либо абсолютный путь, либо путь относительно выполняемого - php файла. - - - Если указать специалньый атрибут "assign", то вывод функции fetch - будет присвоен переменной вместо отображения. Добавлено в - Smarty версии 1.5.0. - + Техническое Замечание @@ -62,11 +65,12 @@ Если включена security и указан файл из локальной файловой системы, то отобразятся лишь файлы, который находятся в - указаных безопасных папках ($secure_dir). + указаных безопасных папках + ($secure_dir). - fetch + {fetch} {$weather} {/if} ]]> + + + См. также + {capture}, + {eval} + и + fetch(). + - + - html_checkboxes + {html_checkboxes} + + {html_checkboxes} является + пользовательской функцией, + которая создает группу флажков в HTML по указанной информации. + Также она обеспечивает отметку флажков по умолчанию. + Параметры values и output являются обязательными, если не указан атрибут + options. Весь вывод совместим с XHTML. + + @@ -72,42 +81,36 @@ - - Пользовательская функция html_checkboxes генерирует группу - HTML флажков по указанной информации. Также заботится о - флажках, которые выбраны по умолчанию. Параметры values и output - являются обязательными, если не указан атрибут options. Весь вывод - совместим с XHTML. - + Все параметры, которые не указаны в списке, выводятся в виде пар name/value в каждом созданном тэге <input>. - html_checkboxes - - Где PHP код: - + {html_checkboxes} assign('cust_ids', array(1000,1001,1002,1003)); -$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane Johnson','Charlie Brown')); +$smarty->assign('cust_names', array( + 'Joe Schmoe', + 'Jack Smith', + 'Jane Johnson', + 'Charlie Brown') + ); $smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); ?> ]]> - и шаблон index.tpl: + шаблон: "} +{html_checkboxes name="id" values=$cust_ids output=$cust_names + selected=$customer_id separator="
"} ]]> @@ -123,14 +126,15 @@ $smarty->assign('cust_checkboxes', array( 1000 => 'Joe Schmoe', 1001 => 'Jack Smith', 1002 => 'Jane Johnson', - 1003 => 'Charlie Brown')); + 1003 => 'Charlie Brown') +); $smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); + ?> ]]> - и шаблон index.tpl: + шаблон: display('index.tpl'); ]]> + + + Пример с базой данных (к примеру, PEAR или ADODB): + + +assign('types',$db->getAssoc($sql)); + +$sql = 'select * from contacts where contact_id=12'; +$smarty->assign('contact',$db->getRow($sql)); + +?> +]]> + + +"} +]]> + + + + См. также + {html_radios} + и + {html_options} + - + - html_image + {html_image} + + {html_image} является + пользовательской функцией, + которая создает HTML-тэги для изображений. Высота и ширина автоматически + вычислаются из файла изображения, если они не указаны явно. + + @@ -62,19 +69,23 @@ n/a значение href, куда ссылается картинка + + path_prefix + string + Нет + n/a + префикс пути результата + - - Пользовательская функция html_image генерирует HTML для изображения. - Ширина и высота автоматически вычисляются из файла изображения, если - не указаны явно. - + basedir - базовая папка для относительных путей. Если не указана, - то используется корень веб сервер (переменная окружени DOCUMENT_ROOT). - Если security включено, то путь к изображения должен быть в пределах - безопасных папок. + то используется корень веб сервер + (переменная окружения DOCUMENT_ROOT). + Если $security включено, то путь к + файлу изображения должен быть в пределах безопасной директории. Атрибут link указывает, куда ссылается изображение. Атрибут @@ -82,28 +93,30 @@ атрибут link, то изображение окружается выражениями <a href="LINKVALUE"> и <a>. + + path_prefix - это необязательный префикс, который + вы можете добавить к пути результата + Это удобно в случае, если вы хотите передать другое серверное имя для + изображения. + + + Все параметры, которые не указаны в списке, выводятся в виде + пар name/value в каждом созданном тэге <input>. + Техническое Замечание - html_image требует обращение к диску для чтения изображения - и вычисления его размеров. Если не используется кэширование - шаблонов, то тогда лушче не пользоваться тэгом html_image - и вставлять статические тэги изображений, для достижения - оптимального быстродействия. + {html_image} требует обращение к диску для чтения изображения + и вычисления его размеров. Если не используется + кэширование шаблонов, + то тэг {html_image} лучше не использовать, а вставлять статичные тэги + изображений для достижения оптимального быстродействия. - html_image + {html_image} display('index.tpl'); - -index.tpl: - {html_image file="pumpkin.jpg"} {html_image file="/path/from/docroot/pumpkin.jpg"} {html_image file="../path/relative/to/currdir/pumpkin.jpg"} @@ -115,6 +128,16 @@ OUTPUT: (possible) ]]> + + возможный результат: + + + + + +]]> + - + - html_options + {html_options} + {html_options} является + пользовательской функцией, + которая создает группу HTML-тэгов option по указанной информации. + Также она обеспечивает выбор элемента по умолчанию. + Параметры values и output являются обязательными, если не указан атрибут + options. + + @@ -58,86 +66,128 @@ + - пользовательская функция html_options генерирует группу html тэгов - option по указанной информации. Также заботится о выбранных по - умолчанию элементах. Атрибуты values и output обязательны, если не - указан атрибут options. + Если переданное значение - массив, оно будет принято за HTML-тэг <optgroup> + и отображено в виде групп. В элементе <optgroup> поддерживается рекурсия. + Весь вывод совместим с XHTML. - Если данное значение - массив, то оно будет представлено в виде - html OPTGROUP. Рекурсия с OPTGROUP поддерживается. Весь вывод - совместим с XHTML. - - - Если указан необязательный атрибут name, - то группа опций заключится в тэг <select - name="groupname"> и </select>, иначе сгенерируется только - группа опций. + Если указан необязательный параметр name, список будет + окружен тэгом <select name="groupname"></select>. + В противном случае будут сгенерированы лишь элементы <option>. Все параметры, которые не указаны выше, выводятся в виде - пары name/value внутри тэга <select>. Они игнорируются, - если атрибут name не указан. + пар name/value в тэге <select>. Если необязательный + параметр name не указан, они игнорируются. - html_options + {html_options} + + Пример №1: + + +assign('cust_ids', array(1000,1001,1002,1003)); +$smarty->assign('cust_names', array( + 'Joe Schmoe', + 'Jack Smith', + 'Jane Johnson', + 'Charlie Brown')); +$smarty->assign('customer_id', 1001); + +?> +]]> + + + Шаблон: + assign('cust_ids', array(1000,1001,1002,1003)); -$smarty->assign('cust_names', array('Joe Schmoe','Jack Smith','Jane -Johnson','Charlie Brown')); -$smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); - -index.tpl: - - + {html_options values=$cust_ids output=$cust_names selected=$customer_id} +]]> + + + Пример №2: + + +assign('cust_options', array( - 1001 => 'Joe Schmoe', - 1002 => 'Jack Smith', - 1003 => 'Jane Johnson', - 1004 => 'Charlie Brown')); + 1000 => 'Joe Schmoe', + 1001 => 'Jack Smith', + 1002 => 'Jane Johnson', + 1003 => 'Charlie Brown') + ); $smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); -index.tpl: - - +]]> + + + + {html_options} - Пример с базой данных (к примеру, PEAR или ADODB): + +assign('types',$db->getAssoc($sql)); -РЕЗУЛЬТАТ: (оба примера) ------------------------- +$sql = 'select contact_id, name, email, type_id + from contacts where contact_id='.$contact_id; +$smarty->assign('contact',$db->getRow($sql)); - ]]> + + См. также + {html_checkboxes} + и + {html_radios} + + - + - html_radios + {html_radios} +{html_radios} является + пользовательской функцией, + которая создает группу радиокнопок в HTML по указанной информации. + Также она обеспечивает выбор радиокнопки по умолчанию. + Параметры values и output являются обязательными, если не указан атрибут + options. Весь вывод совместим с XHTML. + + @@ -66,62 +74,108 @@ + - Пользовательсякая функция html_radios генерирует HMTL код - группы элементов выбора (radio button group). Автоматически - устанавливает выбранное значение, если оно укзано. Требует - наличия атрибутов values и output или атрибута options. - Сгенерированный HMTL код совместим с XHTML. - - - Все параметры, которые не указаны в таблице выше, передаются - и выводятся внутри каждого созданного тэга <input>. + Все параметры, которые не указаны в списке, выводятся в виде + пар name/value в каждом созданном тэге <input>. - html_radios + {html_radios}: Пример №1 + +assign('cust_ids', array(1000,1001,1002,1003)); +$smarty->assign('cust_names', array( + 'Joe Schmoe', + 'Jack Smith', + 'Jane Johnson', + 'Charlie Brown') + ); +$smarty->assign('customer_id', 1001); + +?> +]]> + + + Шаблон: + -index.php: +"} +]]> + + + + {html_radios}: Пример №2 + +assign('cust_radios', array( + 1000 => 'Joe Schmoe', + 1001 => 'Jack Smith', + 1002 => 'Jane Johnson', + 1003 => 'Charlie Brown')); +$smarty->assign('customer_id', 1001); +?> +]]> + + + Шаблон: + + +"} +]]> + + + Both examples will output: + + + +Joe Schmoe
+
+
+
+]]> + + + + {html_radios}- Пример с базой данных (к примеру, PEAR или ADODB): + +assign('types',$db->getAssoc($sql)); -{html_radios name="id" values=$cust_ids selected=$customer_id output=$cust_names separator="<br />"} +$sql = 'select contact_id, name, email, type_id + from contacts where contact_id='.$contact_id; +$smarty->assign('contact',$db->getRow($sql)); - -index.php: - -require('Smarty.class.php'); -$smarty = new Smarty; -$smarty->assign('cust_radios', array( - 1000 => 'Joe Schmoe', - 1001 => 'Jack Smith', - 1002 => 'Jane Johnson', - 1003 => 'Charlie Brown')); -$smarty->assign('customer_id', 1001); -$smarty->display('index.tpl'); - - -index.tpl: - -{html_radios name="id" options=$cust_radios selected=$customer_id separator="<br />"} - - -OUTPUT: (both examples) - -<label for="id_1000"><input type="radio" name="id" value="1000" id="id_1000" />Joe Schmoe</label><br /> -<label for="id_1001"><input type="radio" name="id" value="1001" id="id_1001" checked="checked" />Jack Smith</label><br /> -<label for="id_1002"><input type="radio" name="id" value="1002" id="id_1002" />Jane Johnson</label><br /> -<label for="id_1003"><input type="radio" name="id" value="1003" id="id_1003" />Charlie Brown</label><br /> - +?> +]]> + + + Шаблон: + + +"} +]]> + + + + См. также + {html_checkboxes} + и + {html_options} + + diff --git a/docs/ru/designers/language-custom-functions/language-function-html-select-date.xml b/docs/ru/designers/language-custom-functions/language-function-html-select-date.xml index 344e5ae3..bcbcc3b5 100644 --- a/docs/ru/designers/language-custom-functions/language-function-html-select-date.xml +++ b/docs/ru/designers/language-custom-functions/language-function-html-select-date.xml @@ -1,8 +1,15 @@ - + - html_select_date + {html_select_date} + + {html_select_date} является + пользовательской функцией, + которая создает выпадающее меню для выбора даты. + Она может отображать поля для года, месяца и дня. + + @@ -206,32 +213,70 @@ По умолчанию - %m (номер месяца). + + year_empty + string + Нет + null + + Если указан, первый пункт элемента для выбора года станет такой надписью + с пустым ("") значением. + Это удобно для создания надписей вроде "Пожалуйста, выберите год" в + качестве первого пункта выпадающего меню. + Обратите внимание, что вы можете использовать значения типа "-MM-DD" + для атрибута time, чтобы не выбирать год заранее. + + + + month_empty + string + No + null + + Если указан, первый пункт элемента для выбора месяца станет такой надписью + с пустым ("") значением. + Обратите внимание, что вы можете использовать значения типа "YYYY--DD" + для атрибута time, чтобы не выбирать месяц заранее. + + + + day_empty + string + No + null + + Если указан, первый пункт элемента для выбора дня станет такой надписью + с пустым ("") значением. + Обратите внимание, что вы можете использовать значения типа "YYY-MM-" + для атрибута time, чтобы не выбирать день заранее. + + - пользовательская функция html_select_date генерирует поля выбора - даты. + Все параметры, которые не указаны в списке, выводятся в виде + пар name/value в каждом созданном тэге <select> для дня, + месяца и года. - html_select_date + {html_select_date} + Шаблон: + + + Результат обработки шаблона: + + + - - - - - - + ..... snipped ..... @@ -240,31 +285,13 @@ - - - - - - - + ..... snipped ..... - - - - - - - - - - - - - + ..... snipped ..... @@ -273,18 +300,23 @@ ]]> - + - html_select_date + {html_select_date} + + + Результатом обработки шаблона будет: (текущий год - 2000) + + + @@ -309,10 +341,18 @@ ]]> - + - + + См. также + {html_select_time}, + date_format, + $smarty.now + и + Советы относительно дат. + + - + - html_select_time + {html_select_time} + + {html_select_time} является + пользовательской функцией, + которая создает выпадающее меню для выбора времени. + Она может отображать поля для часа, минуты, секунды и меридиана. + + - - - - - - - - Имя атрибута - Тип - Обязателен - По умолчанию - Описание - - - - - prefix - string - Нет - Time_ - префикс названий переменных - - - time - timestamp - Нет - текущее время - используемое время - - - display_hours - boolean - Нет - true - выводить часы - - - display_minutes - boolean - Нет - true - выводить минуты - - - display_seconds - boolean - Нет - true - выводить секунды - - - display_meridian - boolean - Нет - true - выводить меридиан (am/pm) - - - use_24_hours - boolean - Нет - true - использовать 24-часовой формат времени - - - minute_interval - integer - Нет - 1 - интервал элементов выпадающего списка минут - - - second_interval - integer - Нет - 1 - интервал элементов выпадающего списка секунд - - - field_array - string - Нет - n/a - - название переменной, в которую передадутся выбранные значения - в виде массива - - - - all_extra - string - Нет - null - - указывает дополнительные атрибуты для всех тэгов select/input - - - - hour_extra - string - Нет - null - - указывает дополнительные атрибуты для тэгов select/input - для выбора часов - - - - minute_extra - string - Нет - null - - указывает дополнительные атрибуты для тэгов select/input - для выбора минут - - - - second_extra - string - Нет - null - - указывает дополнительные атрибуты для тэгов select/input - для выбора секунд - - - - meridian_extra - string - Нет - null - - указывает дополнительные атрибуты для тэгов select/input - для выбора меридиан - - - + + + + + + + + Имя атрибута + Тип + Обязателен + По умолчанию + Описание + + + + + prefix + string + Нет + Time_ + префикс для имен переменных + + + time + timestamp + Нет + текущее время + какую дату/время использовать + + + display_hours + boolean + Нет + true + отображать ли часы + + + display_minutes + boolean + Нет + true + Отображать ли минуты + + + display_seconds + boolean + Нет + true + Отображать ли секунды + + + display_meridian + boolean + Нет + true + отображать ли меридиан (am/pm) + + + use_24_hours + boolean + Нет + true + использовать ли 24-часовой формат + + + minute_interval + integer + Нет + 1 + интервал пунктов выпадающего меню минут + + + second_interval + integer + Нет + 1 + интервал пунктов выпадающего меню секунд + + + field_array + string + Нет + n/a + присвоить значения массиву с таким именем + + + all_extra + string + Нет + null + добавляет дополнительные атрибуты к тэгам select/input + + + hour_extra + string + Нет + null + добавляет дополнительные атрибуты к тэгу select часа + + + minute_extra + string + Нет + null + добавляет дополнительные атрибуты к тэгу select минуты + + + second_extra + string + Нет + null + добавляет дополнительные атрибуты к тэгу select секунды + + + meridian_extra + string + Нет + null + добавляет дополнительные атрибуты к тэгу select меридиана + + + - Пользовательская функция html_select_time генерирует HTML поля - для выбора времени. Она может выборочно отображать поля для часов, - минут, секунд и меридиана. - - - Аттрибут time имеет несколько разных форматов: - он моэет быть представлен в виде уникальной временной - метки (UNIX timestamp) или строки в формате - ГГГГММДДЧЧММСС или любо другой строки, которую может - обработать PHP-функция strtotime(). + Атрибут time может иметь разные форматы. + Он может быть уникальной временной меткой (Unix timestamp), + строкой формата YYYYMMDDHHMMSS или любой другой строкой, + которую может обработать функция PHP + strtotime(). - html_select_time - + {html_select_time} + Шаблон: + + + + Результат обработки шаблона: + + + @@ -176,7 +166,7 @@ - + @@ -213,7 +203,7 @@ - + @@ -278,7 +268,7 @@ - + @@ -317,12 +307,19 @@ ]]> - + + + См. также + $smarty.now, + {html_select_date} + и + Советы относительно дат. + - + - html_table + {html_table} + + {html_table} является + пользовательской функцией, + которая распечатывает массив данных в HTML-тэг table. + Атрибут cols указывает, сколько в таблице будет колонок. + Атрибуты table_attr, tr_attr и + td_attr определяют атрибуты соответствующих элементов + таблицы - тэгов table, tr и td. Если параметры tr_attr + или td_attr являются массивами, их значения будут + использоваться циклически. trailpad - это значение, + помещаемое в пустые ячейки последней строки, если такие будут. + + - - - - - - - - Имя атрибута - Тип - Обязателен - По умолчанию - Описание - - - - - loop - array - Да - n/a - массив данных, по которому будет произведен обход - - - cols - integer - Нет - 3 - - количество колонок в таблице. если атрибут cols не указан, но указан - rows, тогда кол-во колонок вычисляется исходя из кол-ва строк и кол-ва - элементов, которые необходимо отобразить. если оба атрибута, rows и - cols, не указаны, cols по умолчанию равен 3. - - - - rows - integer - Нет - empty - - количество строк в таблице. если атрибут rows не указан, но указан cols, - тогда кол-во строк вічисляется исходя из кол-ва колонок и кол-ва - элементов, которые необходимо отобразить. - - - - inner - string - No - cols - - направление последовательного отображения элементов из массива loop. - cols означает, что элементы отображаются колонка - за колонкой. - rows означает, что элементы отображаются строка - за строкой. - - - - table_attr - string - Нет - border="1" - дополнительные атрибуты тэга table - - - tr_attr - string - Нет - пусто - дополнительные атрибуты тэга tr (если указан - массив, то его элементы циклически повторяются) - - - td_attr - string - Нет - пусто - дополнительные атрибуты тэга td (если указан - массив, то его элементы циклически повторяются) - - - trailpad - string - Нет - &nbsp; - значение остаточных ячеек на последней строке табилцы - - - hdir - string - Нет - right - - направление отображения каждого ряда. допустимые значения: - left (слева направо), - right (справа налево) - - - - vdir - string - Нет - down - - направление отображение каждой колонки. допустимые значения: - down (сверху вниз), - up (снизу вверх) - - - + + + + + + + + Имя атрибута + Тип + Обязателен + По умолчанию + Описание + + + + + loop + array + Да + n/a + массив данных для обработки + + + cols + integer + Нет + 3 + + количество колонок в таблице. Если этот атрибут не указан, но указан + атрибут rows, то количество колонок автоматически вычисляется исходя + из количества строк и количества элементов для отображения, чтобы как + раз уместить все элементы. Если оба параметра (и rows, и cols) опущены, + cols принимает значение по умолчанию, равное 3. + + + + rows + integer + Нет + empty + + количество строк в таблице. Если этот атрибут не указан, но указан + атрибут cols, то количество строк автоматически вычисляется исходя + из кооичества колонок и количества элементов для отображения, чтобы как + раз уместить все элементы. + + + + inner + string + Нет + cols + + направление заполнения элементов таблицы из массива. + cols означает заполнение элементов колонки за колонкой. + rows означает заполнение элементов строка за строкой. + + + + table_attr + string + Нет + border="1" + атрибуты для тэга table + + + tr_attr + string + Нет + empty + атрибуты для тэга tr (значения массива отображаются циклично) + + + td_attr + string + Нет + empty + атрибуты для тэга td (значения массива отображаются циклично) + + + trailpad + string + Нет + &nbsp; + значение для заполнения пустых ячеек последней строки (если такие есть) + + + hdir + string + Нет + right + + направления заполнения каждой строки. доступные значения: + right (слева-направо) + и + left (справа-налево) + + + + vdir + string + Нет + down + + направление заполнения каждой колонки. доступные значения: + down (сверху-вниз) + и + up (снизу-вверх) + + + - - Пользовательская функция html_table выводит - массив в виде HTML таблицы. Атрибут cols - указывает количество колонок. Атрибуты table_attr, - tr_attr и td_attr указывают - дополнительные атрибуты тэгов table, tr и td. Если значение - tr_attr или td_attr - массив, - то кго значения циклический повторяются. Атрибут - trailpad устанавливает значения для остаточных - ячеек на последней строке таблицы. - + + - html_table + {html_table} assign('data',array(1,2,3,4,5,6,7,8,9)); $smarty->assign('tr',array('bgcolor="#eeeeee"','bgcolor="#dddddd"')); $smarty->display('index.tpl'); + ?> ]]> + + Шаблон: + display('index.tpl'); + - + - mailto + {mailto} + + {mailto} автоматически создает ссылки "mailto:" и опционально кодирует + их. Кодирование e-mail'ов на вашем сайте усложняет их обнаружение + автоматическими программами-анализаторами и является элементарным + способом защиты от спама. + + @@ -95,54 +102,60 @@ - - пользовательская функция mailto автоматизирует создание ссылок - на e-mail адреса с возможностью кодирования их. Кодирование - усложняет работу web-пауков, которые собирают e-mail адреса - с вашего сайта. - + Техническое Замечание javascript - скорее всего наиболее полная форма кодирования, хотя вы так же можете использовать шестнадцатиричное - кодирование. + кодирование. К сожалению, javascript не поддерживает + кодирование русских символов. - mailto + {mailto} me@example.com + + {mailto address="me@example.com" text="send me some mail"} send me some mail - -me@d& -#x6f;main.com -me@example.com -me@example.com - + + {mailto address="me@example.com" encode="javascript"} + + {mailto address="me@example.com" encode="hex"} +m&..snipped...#x6f;m + + {mailto address="me@example.com" subject="Hello to you!"} + me@example.com + +{mailto address="me@example.com" cc="you@example.com,they@example.com"} + me@example.com + +{mailto address="me@example.com" extra='class="email"'} + + +{mailto address="me@example.com" encode="javascript_charcode"} + ]]> + + См. также + escape, + Сокрытие E-mail адреса + и + {textformat} + + - + - math + {math} + + {math} позволяет дизайнерам шаблонов проводить математические вычисления + в шаблоне. Любые числовые переменные шаблона могут быть использованы в + уравнениях, и результат будет выведен на месте этого тега. + Переменные, используемые в уравнении, передаются в виде параметров, + которые могут быть переменными шаблона или статическими значениями. + +, -, /, *, abs, ceil, cos, exp, floor, log, log10, max, min, pi, pow, + rand, round, sin, sqrt, srans и tan являются доступными операторами. + Обратитесь к документации PHP для получения дополнительной информации + по этим математическим функциям. + + + Если вы указываете специальный параметр "assign", результат выполнения + функции {math} будет присвоен переменной шаблона вместо вывода в шаблон. + + - - - - - - - - Имя атрибута - Тип - Обязателен - По умолчанию - Описание - - - - - equation - string - Да - n/a - математической выражение - - - format - string - Нет - n/a - формат рузультата (sprintf) - - - var - numeric - Да - n/a - переменная выражения - - - assign - string - Нет - n/a - - переменная шаблона, которой будет присвоен - вывод - - - - [var ...] - numeric - Да - n/a - дополнительные переменные выражения - - + + + + + + + + Имя атрибута + Тип + Обязателен + По умолчанию + Описание + + + + + equation + string + Да + n/a + уравнение для выполнения + + + format + string + Нет + n/a + формат результата (sprintf) + + + var + numeric + Да + n/a + значение переменной уравнения + + + assign + string + Нет + n/a + имя переменной шаблона для сохранения результата + + + [var ...] + numeric + Да + n/a + значение переменной уравнения + + - - пользовательская функция math позволяет дизайнерам шаблонов - вычислять математические выражения в шаблоне. Любая численная - переменная шаблона может быть использована в выражении. Переменные, - используемые в выражении, передаются в качестве параметров, - которыми могут быть как и переменные шаблона, так и статические - значения. Допустимые операторы: +, -, /, *, abs, ceil, cos, - exp, floor, log, log10, max, min, pi, pow, rand, round, sin, sqrt, - srans и tan. Ознакомтесь с php документацией под данным функциям. - - - Если указан атрибут "assign", то вывод будет присвоен переменной, - вместо отображения. - + Техническое Замечание - использование функции math значительно сказывается на - времени выполнения программы, так как реализована с помощью - php функции eval(). Выполнение математических операций в php - программе более эффективно, то есть везде, где возможно, - следует делать вычисления в программе и передавать результат - в шаблон. Следует также избегать повторяющегося вызова функции - math (например, в циклах). + {math} - это очень ресурсоёмкая функция из-за использования ею функции PHP + eval(). + Выполнение математических операций в PHP намного эффективнее, так что + по возможности используйте PHP для математических рассчетов и + присваивайте результат шаблону. + При любых обстоятельствах, избегайте повторяющихся вызовов функции {math}, + например внутри циклов + {section}. - - math - + + {math} + + Пример №1: + + + + Результат выполнения данного примера: + + + + + + Пример №2: + + + + + + Результат выполнения данного примера: + + + + + + Пример №3: + + + + + + Результат выполнения данного примера: + + + + + + Пример №4: + + + + + + Результат выполнения данного примера: + + + + +--> \ No newline at end of file diff --git a/docs/ru/designers/language-custom-functions/language-function-popup-init.xml b/docs/ru/designers/language-custom-functions/language-function-popup-init.xml index f9b992e5..29429e93 100644 --- a/docs/ru/designers/language-custom-functions/language-function-popup-init.xml +++ b/docs/ru/designers/language-custom-functions/language-function-popup-init.xml @@ -1,31 +1,32 @@ - + - popup_init + {popup_init} - функция popup реализует интеграцию с библиотекой overLib, которая - используется для создания всплывающих окон. Они могут использоваться - для вывода контекстно-зависимой информации, такой как контекстная - помощь или всплывающие подсказки. Функция popup_init должна быть - вызвана один раз в начале страницы, где планируется вызов функции - popup. Библиотеку - overLib написал Эрик Босрап (Erik Bosrup). Домашняя страница расположена - по адресу http://www.bosrup.com/web/overlib/. - - - Начиная со Smarty версии 2.1.2, библиотека overLib не включается - в релиз. Скачайте библиотеку overLib, поместите файл overlib.js - в корень документов (DOCUMENT_ROOT) или глубже. При вызове функции - popup_init передайте относительный путь к этому файлу в качестве - параметра src. + {popup} - + это функция для интеграции + overLib, библиотеки, которая + используется для отображения всплывающих окон. Они используются для + контекстно-чувствительной информации, такой как окна справки и всплывающие + подсказки. {popup_init} должна быть вызвана один раз в начале страницы, + если вы собираетесь использовать на ней функцию + {popup}. + + + overLib + написана Эриком Босрупом (Erik Bosrup) и её домашняя страница находится по + адресу &url.overLib;. + - popup_init + {popup_init} +{* popup_init должна быть вызвана один раз в начале страницы *} +{popup_init src="javascripts/overlib.js"} + ]]> @@ -49,4 +50,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file diff --git a/docs/ru/designers/language-custom-functions/language-function-popup.xml b/docs/ru/designers/language-custom-functions/language-function-popup.xml index 71e45ac1..ed36893a 100644 --- a/docs/ru/designers/language-custom-functions/language-function-popup.xml +++ b/docs/ru/designers/language-custom-functions/language-function-popup.xml @@ -1,10 +1,16 @@ - + - popup - - + {popup} + + {popup} используется для создания высплывающих окон при помощи javascript. + Для обеспечения работы этой функции, предварительно ДОЛЖНА быть вызвана + функция {popup_init}. + + + + @@ -25,9 +31,7 @@ string Да n/a - - HTML код (текст), который будет выводиться в высплывающем окне. - + текст/html для отображения во всплывающем окне trigger @@ -35,406 +39,386 @@ Нет onMouseOver - Способ вызова окна. Может быть либо onMouseOver, либо onclick - + Какое событие используется для активации всплывающего окна. + Может быть onMouseOver или onClick. + sticky boolean Нет false - Makes the popup stick around until closed + Всплывающее окно закрывается кликом caption string Нет n/a - устанавливает заголовок + устанавливает заголовок окна fgcolor string Нет n/a - цвет внутри окна + цвет всплывающего окна bgcolor string Нет n/a - цвет границы окна + цвет рамки всплывающего окна textcolor string Нет n/a - цвет текста в окне + устанавливает цвет текста внутри всплывающего окна capcolor string Нет n/a - цвет заголовка окна + устанавливает цвет заголовка всплывающего окна closecolor string Нет n/a - цвет текста "Close" (Закрыть) + устанавливает цвет надписи "закрыть" textfont string Нет n/a - шрифт текста в окне + устанавливает шрифт для главного текста captionfont string Нет n/a - шрифт заголовка окна + устанавливает шрифт дла заголовка closefont string Нет n/a - шрифт текста "Close" (Закрыть) + устанавливает шрифт надписи "Закрыть" textsize string Нет n/a - размер шрифта в окне + устанавливает размер главного текста captionsize string Нет n/a - размер шрифта заголовка + устанавливает размер заголовка closesize string Нет n/a - размер шрифта текста "Close" (Закрыть) + устанавливает размер надписи "Закрыть" width integer Нет n/a - ширина окна + устанавливает ширину всплывающего окна height integer Нет n/a - высота окна + устанавливает высоту всплывающего окна left boolean Нет false - создавать окно слева от курсора мыши + заставляет всплывающее окно появляться слева от курсора мыши right boolean Нет false - создавать окно справа от курсора мыши + заставляет всплывающее окно появляться справа от курсора мыши center boolean Нет false - создавать окно на месте мыши + заставляет всплывающее окно появляться по центру курсора мыши above boolean Нет false - создает окно выше курсора мыши. ЗАМЕЧАНИЕ: возможно - только если указан атрибут height + + Заставляет всплывающее окно появляться сверху от курсора. + Внимание: работает только если установлен атрибут height. + below boolean Нет false - создает окно под курсором мыши + заставляет всплывающее окно появляться снизу от курсора мыши border integer Нет n/a - толщина границы окна + делает рамку вокрут всплывающего окна тоньше или толще offsetx integer Нет n/a - горизонтальное смещение окна от курсора мыши. + как далеко от курсора будет отображаться всплывающее окно, + по горизонтали offsety integer - Нет + No n/a - вертикальное смещение окна от курсора мыши + как далеко от курсора будет отображаться всплывающее окно, + по вертикали fgbackground - url to image + url к картинке Нет n/a - - определяет фоновое изображение текста, - вместо fgcolor. - + определяет картинку, которая будет использована вместо цвета для + содержимого всплывающего окна. bgbackground - url to image - Нет + url к картинке + No n/a - - определяет фоновое изображение для границ окна, вместо bgcolor. - ЗАМЕЧАНИЕ: Может понадобиться установить bgcolor в "" или будет - показан цвет, а не зиображение. - ЗАМЕЧАНИЕ: При наличии ссылки "Close" Netscape перерисовывает - ячейки таблицы, что приводит к некорректному отображению. - + определяет картинку, которая будет использована вместо цвета для + рамки всплывающего окна. Внимание: вам следует установить bgcolor в "", + иначе цвет так же будет отображаться. Внимание: когда присутствует ссылка + "Закрыть", Netscape будет перерисовывать ячеки таблицы, из-за чего результат + может быть неверным closetext string Нет n/a - устанвливает текст вместо "Close" + устанавливает текст для надписи "Закрыть" noclose boolean Нет n/a - не отображать текст "Close" + не отображать текст "Закрыть" для всплывающих окон с заголовком status string Нет n/a - установить значение строки статуса в браузере + устанавливает текст в строку статуса браузера autostatus boolean Нет n/a - - установить значение строки статуса в браузере в текст окна. - ЗАМЕЧАНИЕ: отменяет значение status - + устанавливает текст всплывающего окна в строку статуса браузера + Внимание: переназначает установку status autostatuscap string Нет n/a - - установить значение строки статуса в браузере в текст заголовка. - ЗАМЕЧАНИЕ: отменяет начение autostatus - + устанавливает текст заголовка всплывающего окна в строку статуса + браузера. + NOTE: переназначает установки status и autostatus inarray integer Нет n/a - - указывает, что текст окна следует взять из указанного элемента массива - ol_text, расположенного в overlib.js. Этот параметр может использоваться - вместо text - + говорит overLib прочитать текст по этому индексу в + массиве ol_text, расположеном в overlib.js. Этот параметр + может быть использован вместо параметра text caparray integer Нет n/a - - указывает, что заголовок окна следует взять из указанного элемента - массива ol_caps - + говорит overLib и прочитать заголовок по этому индексу в + массиве ol_caps capicon url Нет n/a - выводит изображение перед заголовком окна. + отображает картинку перед заголовком всплывающего окна snapx integer Нет n/a - ровняет окно к горизонтальной сетке + прикрепляет всплывающее окно к каждому N-ому пикселю по горизонтали snapy integer Нет n/a - ровняет окно к вертикальной сетке + прикрепляет всплывающее окно к каждому N-ому пикселю по вертикали fixx integer Нет n/a - - закрепляет горизонтальное положение окна. - ЗАМЕЧАНИЕ: отменяет все остальные параметры горизонтального положения - + блокирует горизонтальное положение всплывающего окна. + Внимание: переназначает всё горизонтальное позиционирование fixy integer Нет n/a - - закрепляет вертикалнное положение окна. - ЗАМЕЧАНИЕ: отменяет все остальные параметры вертикального положения - + блокирует вертикальное положение всплывающего окна. + Внимание: переназначает всё вертикальное позиционирование background url Нет n/a - указывает фоновое изображение окна + устанавливает картинку для использования вместо фона таблицы padx integer,integer Нет n/a - - дополняет фоновое изображение горизонтальными отступами к тексту. - ЗАМЕЧАНИЕ: этот параметр принимает два значения + делает горизонтальный отступ фоновой картинки для размещения текста. + Внимание: это двойная команда pady integer,integer Нет n/a - - дополняет фоновое изображение вертикальными отступами к тексту. - ЗАМЕЧАНИЕ: этот параметр принимает два значения + делает вертикальный отступ фоновой картинки для размещения текста. + Внимание: это двойная команда fullhtml boolean Нет n/a - - Позволяет полностью контролировать HTML над фоновым изображением. - HTML код ожидается в параметре text - + дает вам возможность полностью контролировать html поверх фоновой + картинки. HTML-код ожидается в атрибуте "text" frame string Нет n/a - - Контролировать высплывающие окна в различных фрэймах. - См. сайт overlib для дополнительной информации по этой функции - + контролирует всплывающее окно в другом фрейме. + См. домашнюю страницу overlib для дополнительной информации по этой + функции timeout string Нет n/a - - вызывает указанную javascript функцию и использует результат - как текст окна - + вызывает указанную функцию javascript и отображает возвращенное + значение во всплывающем окне delay integer Нет n/a - - время жизни окна в милисекундах. Позволяет реализовывать - высплывающие подсказки. - + заставляет всплывающее окно вести себя как всплывающую подсказку. + Оно всплывет только после определенной задержки в миллисекундах. hauto boolean Нет n/a - - автоматическое опредление горизонтального местоположения окна - относительно мыши. - + автоматически определять, должна ли всплывающая подсказка быть + слева или справа от курсора мыши. vauto boolean Нет n/a - - автоматическое опредление вертикального местоположения окна - относительно мыши. - + автоматически определять, должна ли всплывающая подсказка быть + выше или ниже курсора мыши. - - функция popup используется для генерации javascript кода, - который создаст высплывающее окно. - + - popup + {popup} mypage +{* создает ссылку со всплывающим окном, когда вы наводите на неё курсор *} +mypage -{* можно использовать html, ссылки и т.п. в высплывающем окне *} +{* вы можете использовать HTML, ссылки и т.д. в тексте *} mypage - +text="
  • links
  • pages
  • images
" +snapx=10 snapy=10}>mypage ]]> + + См. также + {popup_init} + и + overLib. + - + - textformat + {textformat} + + {textformat} - это + блоковая функция, + используемая для форматирования текста. Проще говоря, она убирает + лишние пробелы и спецсимволы, а так же форматирует параграфы добавляя + разрывы строк и отступы. + + + Вы можете указать параметры явно, либо использовать предустановленный + стиль. + На данный момент, единственным таким стилем является "email". + + - - - - - - - - Имя атрибута - Тип - Обязателен - По умолчанию - Описание - - - - - style - string - Нет - n/a - предустановленный стиль - - - indent - number - Нет - 0 - отступ строки - - - indent_first - number - Нет - 0 - отступ первой строки - - - indent_char - string - Нет - (single space) - символ, которым заполняется отступ строк. - - - wrap - number - Нет - 80 - количество символов в строке - - - wrap_char - string - Нет - \n - текст, разделяющий каждую строку - - - wrap_cut - boolean - Нет - false - - Переносить текст по символам (то есть точно - по указанной длине строки) (true), или по - границам слов (false) - - - - assign - string - Нет - n/a - переменная шаблона, которой будет присвоен вывод - - + + + + + + + + Имя атрибута + Тип + Обязателен + По умолчанию + Описание + + + + + style + string + Нет + n/a + предустановленный стиль + + + indent + number + Нет + 0 + Количество символов для отступа на каждой строке + + + indent_first + number + Нет + 0 + Количество символов для отступа на первой строке + + + indent_char + string + Нет + (один пробел) + Символ (или набор символов), при помощи которых будет + осуществляться отступ + + + wrap + number + Нет + 80 + Максимальное количество символов, после которого будет вставлен + перенос строки + + + wrap_char + string + Нет + \n + Символ (или набор символов), при помощи которых будет + осуществляться перенос строки + + + wrap_cut + boolean + Нет + false + Если true, перенос строки будет разбивать строку на любом символе, + а не только на границе слов + + + assign + string + Нет + n/a + переменная шаблона для присвоения результата работы функции + + - - функция textformat используется для форматирования текста, - заключенного внтури ее. В основном, убирает лишние пробелы и - специальные символы, а так же форматирует абзацы, делает отступы, - переносит слова. - - - Можно указывать параметры явно, или использовать предустановленные стили. - На данный момент существует только стиль "email". - + - textformat + {textformat} + + Результат выполнения данного примера: + + + + + + + + + Результат выполнения данного примера: + + + + + + + + + Результат выполнения данного примера: + + + + + + + + + Результат выполнения данного примера: + + + + + + См. также + {strip} + и + {wordwrap}. + + +--> \ No newline at end of file diff --git a/docs/ru/designers/language-modifiers/language-modifier-strip-tags.xml b/docs/ru/designers/language-modifiers/language-modifier-strip-tags.xml index 763bdfc0..c7c3eb80 100644 --- a/docs/ru/designers/language-modifiers/language-modifier-strip-tags.xml +++ b/docs/ru/designers/language-modifiers/language-modifier-strip-tags.xml @@ -4,7 +4,7 @@ strip_tags - Вырезает HTML теги, обычно все между < и >. + Вырезает HTML тэги, обычно все между < и >. strip_tags diff --git a/docs/ru/programmers/api-functions/api-unregister-modifier.xml b/docs/ru/programmers/api-functions/api-unregister-modifier.xml index cd5d638c..168e344a 100644 --- a/docs/ru/programmers/api-functions/api-unregister-modifier.xml +++ b/docs/ru/programmers/api-functions/api-unregister-modifier.xml @@ -22,7 +22,7 @@ unregister_modifier("strip_tags"); ?> diff --git a/docs/ru/programmers/api-variables/variable-php-handling.xml b/docs/ru/programmers/api-variables/variable-php-handling.xml index c7b1fc3c..90c8daa0 100644 --- a/docs/ru/programmers/api-variables/variable-php-handling.xml +++ b/docs/ru/programmers/api-variables/variable-php-handling.xml @@ -14,7 +14,7 @@ SMARTY_PHP_PASSTHRU - Smarty показывает тэги без обработки. SMARTY_PHP_QUOTE - Smarty превращает спецсимволы тэгов в HTML-сущности. SMARTY_PHP_REMOVE - Smarty удаляет тэги из шалона. - SMARTY_PHP_ALLOW - Smarty будет выполнять теги как PHP-код. + SMARTY_PHP_ALLOW - Smarty будет выполнять тэги как PHP-код. diff --git a/docs/ru/programmers/plugins/plugins-functions.xml b/docs/ru/programmers/plugins/plugins-functions.xml index a72fb67a..73a81fdd 100644 --- a/docs/ru/programmers/plugins/plugins-functions.xml +++ b/docs/ru/programmers/plugins/plugins-functions.xml @@ -19,7 +19,7 @@ Вывод (возвращаемое значение) функции будет подставлен в место расположения - тега функции в шаблоне (функция fetch например). + тэга функции в шаблоне (функция fetch например). В качестве альтернативы, функция может выполнять какие либо действия без какого-либо вывода (assign функция).