...
- buildForm - funkcja budująca formularz parametrów
- toText - funkcja zwracająca bardziej czytelną reprezentację, przyjmuje ona parametr parameters, który jest postaci Object (czyli jak mapa w Java). Możemy otrzymywać poszczególne wartości parametrów po ich identyfikatorach. Otrzymana wartość parametru może być tabelą, albo bezpośrednią wartością tekstową, liczbową itd.
- apiVersion - wersja API formularza, parametr jest opcjonalny, jeśli nie jest podany, to jest wykorzystywane API formularza w wersji V1
Code Block | ||
---|---|---|
| ||
PWE.integrationComponent.registerSystemFunction( 'concat', [ {
type: 'string',
id: 'strings',
array: true
} ], {
apiVersion: 2,
buildForm: function( api, options ) {
api.addField( {
id: 'strings'
} );
},
toText: function( parameters ) {
var strings = parameters['strings'];
return 'konkatenacja( ' + strings.join( ', ' ) + ' )';
}
} ); |
Założenia
- Możliwość rozmieszczania parametrów w miarę dowolny sposób.
- Możliwość podpinania zdarzeń pod pola parametrów:
- change
- blur
- Grupowanie parametrów (chyba tylko tablicowych) - chodzi o to, żeby mając np 2 parametry tablicowe, które są ze sobą powiązane (np ustawianie zmiennych - jeden parametr ze zmiennymi, a drugi z wartościami do ustawienia) była możliwość przedstawienia ich jako pary dla której byłby tylko jeden przycisk dodawania kolejnego elementu tablicy i ten przycisk jednocześnie dodawałby pola dla wszystkich zgrupowanych parametrów
- Ukrywanie / pokazywanie parametrów.
- Możliwość zdefiniowania wybieracza z wartościami dla parametru z określeniem czy można wpisać własną wartość lub wybrać funkcję, czy zmienną. Wydaje mi się, że będzie to mieć sens tylko dla parametrów o podstawowych typach.
- Możliwość filtrowania wartości, np.: dla parametru typu VARIABLE, możnaby przefiltrować jakie zmienne miałyby być wyświetlane. Np, gdy chcielibyśmy tylko zmienne typu FLOAT.
- Możliwość dodania zwykłego labela, chyba będzie przydatne do grupowania parametrów.
- Możliwość dodania checkboxa - umożliwiałby pokazywanie i ukrywanie parametrów.
- Możliwość definiowania sekcji, którą możnaby było zwinąć, taki fieldset zwijany.
...