Редактирование: Модуль:Random/doc (раздел)

== List ==
Функция <code>list</code> возвращает список в случайном порядке.

 &#123;{#invoke:Random|list|''элемент списка 1''|''элемент списка 2''|''элемент списка 3''|...|sep=''разделитель''|limit=''сколько элементов отображать''|same=''yes''}}

'''Именованные параметры'''
* {{Para|sep}} или {{Para|separator}} — опциональный разделитель списка элементов. Некоторые значения зарезервированы, см. таблицу ниже.
* {{Para|limit}} — максимальное число отображаемых элементов списка. Наименьшее возможное значение — 0, наибольшее — число элементов в списке.
* Если параметру {{Para|same}} присвоено одно из значений «yes», «y», «true» или «1», один и тот же список возвращается для каждого вызова модуля на данной странице.

{| class="wikitable"
|+ Возможные значения разделителя
|-
! Код !! Вывод
|-
| <code>dot</code> || {{int:dot-separator}}
|-
| <code>pipe</code> 
|| {{int:pipe-separator}}
|-
| <code>comma</code> || {{int:comma-separator}}
|-
| <code>tpt-languages</code> || {{int:tpt-languages-separator}}
|-
| <code>space</code> || ''пробел''
|-
| <code>newline</code> || ''символ перевода строки''
|-
| ''любое другое значение'' || ''остальные значения используются без изменения''
|}

Передать пробелы в параметр {{Para|sep}} невозможно из-за ограничений, накладываемых синтаксисом шаблонов в MediaWiki. Однако их можно обойти, используя [[Кодировки_символов_в_HTML#Мнемоники_HTML_и_коды_Unicode|мнемоники HTML]]. Используйте <code>&amp;#32;</code> для представления обычного пробела и <code>&amp;nbsp;</code> для представления неразрывного пробела.

'''Примеры''' <small>({{Очистить кэш|обновить|anchor=List}})</small>

* <code><nowiki>{{#invoke:Random|list|egg|beans|sausage|bacon|spam}}</nowiki></code> &rarr; {{#invoke:Random|list|egg|beans|sausage|bacon|spam}}
* <code><nowiki>{{#invoke:Random|list|egg|beans|sausage|bacon|spam|sep=dot}}</nowiki></code> &rarr; {{#invoke:Random|list|egg|beans|sausage|bacon|spam|sep=dot}}
* <code><nowiki>{{#invoke:Random|list|egg|beans|sausage|bacon|spam|sep=space}}</nowiki></code> &rarr; {{#invoke:Random|list|egg|beans|sausage|bacon|spam|sep=space}}
* <code><nowiki>{{#invoke:Random|list|egg|beans|sausage|bacon|spam|sep=;&amp;#32;}}</nowiki></code> &rarr; {{#invoke:Random|list|egg|beans|sausage|bacon|spam|sep=;&#32;}}
* <code><nowiki>{{#invoke:Random|list|egg|beans|sausage|bacon|spam|sep=foo}}</nowiki></code> &rarr; {{#invoke:Random|list|egg|beans|sausage|bacon|spam|sep=foo}}
* <code><nowiki>{{#invoke:Random|list|egg|beans|sausage|bacon|spam|limit=3}}</nowiki></code> &rarr; {{#invoke:Random|list|egg|beans|sausage|bacon|spam|limit=3}}
* <code><nowiki>{{#invoke:Random|list|egg|beans|sausage|bacon|spam|same=yes}}</nowiki></code> &rarr; {{#invoke:Random|list|egg|beans|sausage|bacon|spam|same=yes}}
* <code><nowiki>{{#invoke:Random|list|egg|beans|sausage|bacon|spam|same=yes}}</nowiki></code> &rarr; {{#invoke:Random|list|egg|beans|sausage|bacon|spam|same=yes}}