# Font Awesome picker 1.0.0+

# Базовое использование

<xf:macro name="tc_clib_fa_picker_macros::fa_picker"
          arg-name="icon" arg-value="far fa-gavel"
          arg-row="true" />

Базовое использование
Базовое использование

# Список аргументов tc_clib_fa_picker_macros::fa_picker

Аргумент Значение по умолчанию Описание
name Значение атрибута name поля формы.
value Значение атрибута rowtype для xf:formrow.
required false Значение атрибута required поля формы.
readonly false Значение атрибута readonly поля формы.
disabled false Значение атрибута disabled поля формы.
controlId Значение атрибута id поля формы.
row true Отображение поля выбора иконки в xf:formrow.
label Значение атрибута label для xf:formrow.
hint Значение атрибута hint для xf:formrow.
explain Значение атрибута explain для xf:formrow.
html Значение атрибута html для xf:formrow.
rowclass Значение атрибута rowclass для xf:formrow.
rowtype Значение атрибута controlid для xf:formrow.
boxBeforeInput false Если true, предпросмотр иконки будет отображаться слева от поля ввода.
triggerInput false Если true, двойное нажатие по полю ввода будет открывать меню выбора иконки.
noBox false Если true, блок предпросмотра иконки не будет отображаться, а меню будет открываться двойным кликом по полю ввода.
variant  1.0.5+ Стиль иконок, который будет выбран по умолчанию. Возможные значения: duotone, light, regular, solid.

# TeslaCloud.FontAwesomePicker (tc-fa-picker)

# Параметры

Параметр Значение по умолчанию Описание
faIconInput | .input Селектор поля ввода класса иконки.
box | .js-faPickerBox Селектор блока предпросмотра иконки.
trigger .js-faPickerTrigger Селектор триггеров меню выбора иконок.
triggerInput false Если true, двойное нажатие по полю ввода будет открывать меню выбора иконки.
noBox false Если true, блок предпросмотра иконки не будет отображаться, а меню будет открываться двойным кликом по полю ввода.

# Примеры

# Открытие меню пользовательскими триггерами

Для добавления пользовательского триггера, необходимо добавить к элементу класс js-faPickerTrigger.
Пример использования кнопки в качестве триггера:

<xf:css src="public:tc_clib_fa_picker.less" />
<xf:comment>Для XenForo 2.1.0+:</xf:comment>
<xf:js src="TC/ComponentLibrary/fa_picker.js" addon="TC/ComponentLibrary" min="1" />
<xf:comment>Для XenForo 2.3.0+:</xf:comment>
<xf:js src="TC/ComponentLibrary/font_awesome.js" addon="TC/ComponentLibrary" min="1" />

<xf:formrow>
    <div class="inputGroup tc-fa-picker" data-xf-init="tc-fa-picker">
        <xf:button fa="fa-search" class="js-faPickerTrigger">Choose icon</xf:button>

        <xf:textbox name="test" dir="ltr" />
    </div>
    <xf:macro name="tc_clib_fa_picker_macros::fa_picker_menu" />
</xf:formrow>

Пользовательский триггер
Пользовательский триггер