Interface IMeInput

Основной элемент для ввода данных Использует attrs.type для уточнения внешнего вида элемента. Может принимать вид текстового поля ввода, выпадающего списка, checkbox, radio и пр.

Returns

any - тип результирующего значения зависит от [[IMeInputAttrs.type]] элемента и от значения multiple @lego_elem

interface IMeInput {
    align?: string;
    attrs?: IMeInputAttrs;
    bindAttrs?: IMeElemBindAttrs[];
    calculator?: IMeElemCalculatorInfo;
    cssClass?: string;
    cssFormClass?: string;
    defaultValue?: any;
    depends?: string[];
    elemClassName?: string;
    elems?: IMeElem<any>[];
    entityId?: string;
    eraseValue?: boolean;
    errors?: IMeElemError[];
    exist?: string | IMeElemExistSetting;
    exportable?: boolean;
    exportLabel?: string;
    formHorizontal?: boolean;
    help?: string;
    hideApplyButton?: boolean;
    i18n?: { string: string };
    icon?: string;
    id?: string;
    inlineForm?: boolean;
    label?: string;
    listen?: IMeElemListenItem[];
    liveReload?: boolean;
    maxMenuHeight?: number;
    name?: string;
    offset?: number;
    onLoadOptionsCallback?: Function;
    order?: number;
    persistValueView?: boolean;
    refData?: any;
    refPvmData?: string | IRefPvmValues;
    refPvmValidator?: string | IRefPvmValues;
    selectedValueView?: any;
    selfDepends?: boolean;
    selfDependsSettings?: any;
    selfDependsSettingsLoaded?: any;
    span?: number;
    styles?: any;
    submitRefPvmValidator?: string | IRefPvmValues;
    tooltip?: ITooltip;
    updateElemAttrsFromOptions?: boolean;
    valid?: boolean;
    validateInProgress?: boolean;
    value?: string;
    visible?: string;
}

Hierarchy (View Summary)

IMeElem
- IMeInput

Properties

`Optional`align

align?: string

Позиционирование элемента в ячейке серки

Default

"left"

`Optional`attrs

attrs?: IMeInputAttrs

Зависят от типа элемента

`Optional`bindAttrs

bindAttrs?: IMeElemBindAttrs[]

Когда нужно подписаться на изменение данные в pvm и заполнять какие-то поля элемента Например, менять elems в me-lego динамически или запонять me-input[type=text] расчетным значением

`Optional`calculator

calculator?: IMeElemCalculatorInfo

Атрибут calculator позволяет указать отношеня контролов между собой в виде формул. Они могут находятся на разных уровнях lego

Link

https://apps.devision.io/page?p=3593&a=35

`Optional`cssClass

cssClass?: string

Класс для кнопки (me-submit)

`Optional`cssFormClass

cssFormClass?: string

Класс колонки, нужно для выравнивания элементов.

Link

https://apps.devision.io/page?p=493c9084-85b8-4a00-a478-43ca056541a0&a=sp

`Optional`defaultValue

defaultValue?: any

Значение элемента по умолчанию Для некоторых элементов

`Optional`depends

depends?: string[]

Указываться от корневого me-lego вставленного через html. Работает только когда у элемента есть параметр refPvmData и refPvmData с depends и зависимость еще не загружена. Также есть возможность делать зависимости от текущего уровня иерархии, это удобно, когда неизвестна родительская вложенность. Например, когда у вас одна и та же динамическая форма подгружается в разных местах приложения на разном уровне вложенности или даже в me-lego-list иногда

Зависимости от других элементов. При изменении зависимых элементов, при условии, что заполнены все значения из depends делается автоматический переапрос refPvmData и depends будут переданы в env.sp как {key: value}

Для зависимостей me-lego-list в одной строке используется нотация с [], например filled[].orgId, где filled - шв me-lego-list, orgId - id элемента

Например: [ "filled[].orgId as orgId" ] - переименовать для env.sp. Придет как env.sp.orgId Например: [ "mode", "clientId" ] - Придет как env.sp.mode, env.sp.clientId Например: [ "@.subOrgId42 as orgId" ] - Для ссылки на текущую вложенность, например при динамической загрузки формы Например: [ "@:-1.orgId as orgId" ] - Для ссылки на один уровень наверх от предыдущей вложенности. Вместо -1 может быть -2, -3 и т.д.

Example

https://apps.devision.io/page?p=4329&a=35

Example

https://apps.devision.io/page?p=3597&a=35

`Optional`elemClassName

elemClassName?: string

Нужен для стича, чтобы могли стилизовать отдельные елементы в MeLegoItem

`Optional`elems

elems?: IMeElem<any>[]

`Optional`entityId

entityId?: string

Meta EntityId Для некоторых элементов, напрмиер [[IMeInput]], [[IMeTable]]

`Optional`eraseValue

eraseValue?: boolean

Удалять выбранные значения зависимого элемента из скоупа данных если элемент будет скрыт?

Default

false

`Optional`errors

errors?: IMeElemError[]

Список ошибок элемента пока только валидации, но определенно все ошибки будут тут

`Optional`exist

exist?: string | IMeElemExistSetting

AngularJs expression от рута vm страницы. Обратите внимание, что пути абсотюлтные, в отличие от "depends" в элементах Расчет идет на стороне браузера Например: 'editGroup.card.name == "exist" || editGroup.card.name == "exist23"' Для me-lego-list можно использовать нотацию [] для получения доступа в элементу списка, Например: env.sp.obj.filled[].deadline_enabled === true, где filled - id me-lego-list

Важно! Если вам надо ставить два условия используйте indexOf Например: ["goal_completions", "visit"].indexOf(env.sp.obj.metric_elem[].kpi_indicator) > -1

Если вдруг не работает, возможно надо использовать двойное отрицание "!!", чтобы получить bool из переменной любого типа. Например !pvm.data.mylist.row[0].user - будет "не user в первой строке" Например !!pvm.data.mylist.row[0].user - будет "есть user в первой строке и это не null, не пустота и не 0" Т.е. прямо как это работает в конструкции if в языках javascript, python, php

Условия типа такого: env.sp.obj.metric_elem[].kpi_indicator == "visit" || env.sp.obj.metric_elem[].kpi_indicator == "goal_completions" где дважды используется [] не будут работать из-за внутренней реализации

Так же сущетсвует возможность как в depends указывать относительные пути: Например: [ "@.orgId != 42" ] - Для ссылки на текущую вложенность, например при динамической загрузки формы

Example

https://apps.devision.io/page?p=3570&a=35

Example

https://apps.devision.io/page?p=4329&a=35

`Optional`exportable

exportable?: boolean

Имеет ли экспорт этот элемент

`Optional`exportLabel

exportLabel?: string

`Optional`formHorizontal

formHorizontal?: boolean

Если элемента поддерживает, вывести его в стиле формы ключ, значение. Чтобы заголовок был на уровне элемента

`Optional`help

help?: string

Доп информация, рисуется под label или под элементом. Зависит от типа элемента

`Optional`hideApplyButton

hideApplyButton?: boolean

Скрывает кнопку применения в модальном окне

`Optional`i18n

i18n?: { string: string }

MeElem property internationalization (for label and help for example). Key of i18m map is elem property name, value is message key of i18n file

`Optional`icon

icon?: string

Иконка Font Awesome Например fa-bicycle

`Optional`id

id?: string

ID данных элемента Будет доступно в env.sp.{ID} или как вложенная структура, если это [[IMeElemContainer]]

`Optional`inlineForm

inlineForm?: boolean

Нужно ли отрисовывать элемент без сетки в виде inlineForm (bootstrap)

Link

`Optional`label

label?: string

Заголовок элемента Обычно над элементом, на некоторых не рисуется вообще

`Optional`listen

listen?: IMeElemListenItem[]

Подписка на изменения объектов. Пока работает только для изменений вызваных в модальном окне Например у вас таблица со списоком аккуантов и в "+ Аккаунт" вы можете добавить или привязать аккаунт, а после сохранения в модальном окне, родительская таблциа должна пересчитаться

Напрмиер: [{"code": ["ADD", "REMOVE"], "reload":{},"entityId": 2782 }]

`Optional`liveReload

liveReload?: boolean

Отправляет страницу на пересчет

`Optional`maxMenuHeight

maxMenuHeight?: number

Через это свойство мы можем контролировать длину выпадающего меню. В компоненте MeInputSelect у Select есть свойство maxMenuHeight. Это свойство определяет максимальную высоту меню. Иногда список выпадающего меню некрасиво обрезается нижним краем модалки (страница https://apps.devision.io/page?p=3203&a=58, Select под названием "Поиск аккаунтов") и чтобы это не происходил мы можем увеличить длину выпадающего меню.

`Optional`name

name?: string

Название элемента Например: me-lego, me-input

`Optional`offset

offset?: number

Отстут по сетке справа от 0 до12

`Optional`onLoadOptionsCallback

onLoadOptionsCallback?: Function

`Optional`order

order?: number

Прзиция элемента в сетке, чем меньше значение, тем элемент выше и левее

`Optional`persistValueView

persistValueView?: boolean

Блок обрабатывает вписывание в элемент текущего выбранного пункта в поле selectedValueView, чтобы можно быьт делать, label + name в скрытом режиме

`Optional`refData

refData?: any

Техническое поле. Имя связанных данных

`Optional`refPvmData

refPvmData?: string | IRefPvmValues

Инструкции по получению данных для [[IMeInputAttrs.options]] или таблицы

Example

https://apps.devision.io/page?p=3570&a=35

Example

https://apps.devision.io/page?p=3597&a=35

`Optional`refPvmValidator

refPvmValidator?: string | IRefPvmValues

Пользовательская валидация

Example

https://apps.devision.io/page?p=3443&a=35

`Optional`selectedValueView

selectedValueView?: any

Текстовое представление выбранного значения

`Optional` `Beta`selfDepends

selfDepends?: boolean

Зависимость от себя самого, нужно для editable [[IMeTable]] и прототип для поиска [[IMeInputAttrs.options]] в me-input для частичной подгрузки данных

`Optional`selfDependsSettings

selfDependsSettings?: any

`Optional`selfDependsSettingsLoaded

selfDependsSettingsLoaded?: any

`Optional`span

span?: number

Размер по сетке справа от 0 до12

`Optional`styles

styles?: any

Произвольные стили, применяемые к элементу Представляет из себя хешмап, где ключи - целевой блок, а значения - React.CSSProperties Стандартные ключи: meLegoItem meLogo meLegoContainer Остальные ключи зависят от реализации каждого элемента отдельно Например, для me-div создан ключ div - стили, применяемые к самому div

`Optional`submitRefPvmValidator

submitRefPvmValidator?: string | IRefPvmValues

Валидатор, который должен быть вызван перед сабмитом формы Структура и содержимое такое же, как у refPvmValidator

`Optional`tooltip

tooltip?: ITooltip

Стандартный Meta-tooltip

`Optional`updateElemAttrsFromOptions

updateElemAttrsFromOptions?: boolean

Запишет пересчитанные значения атрибутов в зависимый контрол me-input. Это сработает только при наличии depends и refPvmData у элемента.

Link

https://apps.devision.io/page?p=36a8d1ef-fe3d-4011-9ea3-5a2a87c2df45&a=35

`Optional`valid

valid?: boolean

Элемент валидный

`Optional`validateInProgress

validateInProgress?: boolean

Принимает значение true на момент асинхронной валидации

`Optional`value

value?: string

для некоторых элементов

`Optional`visible

visible?: string

AngularJs expression от корня vm страницы. Обратите внимание, что пути абсолютные, в отличие от "depends" в элементах Расчет идет на стороне браузера Например: 'editGroup.card.name == "visible"'

Example

https://apps.devision.io/page?p=3570&a=35

Interface IMeInput

Returns

Hierarchy (View Summary)

Index

Properties

Properties

Optionalalign

Default

Optionalattrs

OptionalbindAttrs

Optionalcalculator

Link

OptionalcssClass

OptionalcssFormClass

Link

OptionaldefaultValue

Optionaldepends

Example

Example

OptionalelemClassName

Optionalelems

OptionalentityId

OptionaleraseValue

Default

Optionalerrors

Optionalexist

Example

Example

Optionalexportable

OptionalexportLabel

OptionalformHorizontal

Optionalhelp

OptionalhideApplyButton

Optionali18n

Optionalicon

Optionalid

OptionalinlineForm

Link

Optionallabel

Optionallisten

OptionalliveReload

OptionalmaxMenuHeight

Optionalname

Optionaloffset

OptionalonLoadOptionsCallback

Optionalorder

OptionalpersistValueView

OptionalrefData

OptionalrefPvmData

Example

Example

OptionalrefPvmValidator

Example

OptionalselectedValueView

Optional BetaselfDepends

OptionalselfDependsSettings

OptionalselfDependsSettingsLoaded

Optionalspan

Optionalstyles

OptionalsubmitRefPvmValidator

Optionaltooltip

OptionalupdateElemAttrsFromOptions

Link

Optionalvalid

OptionalvalidateInProgress

Optionalvalue

Optionalvisible

Example

Settings

On This Page

`Optional`align

`Optional`attrs

`Optional`bindAttrs

`Optional`calculator

`Optional`cssClass

`Optional`cssFormClass

`Optional`defaultValue

`Optional`depends

`Optional`elemClassName

`Optional`elems

`Optional`entityId

`Optional`eraseValue

`Optional`errors

`Optional`exist

`Optional`exportable

`Optional`exportLabel

`Optional`formHorizontal

`Optional`help

`Optional`hideApplyButton

`Optional`i18n

`Optional`icon

`Optional`id

`Optional`inlineForm

`Optional`label

`Optional`listen

`Optional`liveReload

`Optional`maxMenuHeight

`Optional`name

`Optional`offset

`Optional`onLoadOptionsCallback

`Optional`order

`Optional`persistValueView

`Optional`refData

`Optional`refPvmData

`Optional`refPvmValidator

`Optional`selectedValueView

`Optional` `Beta`selfDepends

`Optional`selfDependsSettings

`Optional`selfDependsSettingsLoaded

`Optional`span

`Optional`styles

`Optional`submitRefPvmValidator

`Optional`tooltip

`Optional`updateElemAttrsFromOptions

`Optional`valid

`Optional`validateInProgress

`Optional`value

`Optional`visible