Porovnávané verzie

Kľúč

  • Tento riadok sa pridal
  • Riadok je odstránený.
  • Formátovanie sa zmenilo.

...

The Alert component serves for displaying dialogue windows.  The  The component uses SweetAlert2 as a source library and its interface is identical with the interface of the SweetAlert2 library.   Komponent má aj naštýlovanú verziu s preddefinovanými CSS štýlmiThe component has a styled version with the predefined CSS styles too.

Blok kódu
languagejs
// otémovanáthemed verziaversion komponentuof alert component
import alert from 'framework/components/alert/themedAlert'
// verziaalert komponentucomponent alertversion bezwithout CSS štýlovstyles - neotémovanáunthemed, it CSSis necessary jeto nutnéimport ručneCSS naimportovaťmanually
// import alert from 'framework/components/alert/alert'

// príkladexample of použitiausage
alert({title: 'ÚspechSuccess', text: 'PodariloIt sawas tosuccessful!', type: 'success'});

Kotva
auth
auth

...

Authentication Components (framework/components/auth)

LoginForm

Komponent LoginForm predstavuje formulár, ktorým sa užívateľ prihlasuje do webovej aplikácie resp. systému D2000. Pre použitie LoginForm komponentu je v ňom potrebné zadefinovať textové pole The LoginForm component represents a form with which the user logs in to the web application - to the D2000 system. To use the LoginForm component, it is necessary to define a text field (html element <input>) s názvom with the name "j_username" pre meno užívateľa, textové pole s názvom  as a user name, a text field with the name "j_password" pre heslo užívateľa a odosielacie tlačidlo for the password of a user and the submitting button (element <button type="submit">). Samotná akcia prihlásenia je implementovaná na úrovni SmartWeb-u a po úspešnej autentifikácii je užívateľ presmerovaný na stránku The login operation itself is implemented on the SmartWeb level and after successful authentication, the user is redirected to the page  pages/index.html.

Blok kódu
languagejs
import React from 'react'
import SimplePageContainer from 'framework/components/react/simplePageContainer'
import LoginForm from 'framework/components/auth/loginForm'

// JednoduchýSimple príkladexample použitiaof LoginForm component komponentuusage
SimplePageContainer.renderComponent(class LoginPage extends React.Component {
        render() {
            return (
                <LoginForm {...this.props}>
                    <input type="text" placeholder="PoužívateľskéUser menoname" required="" name="j_username"/>
                    <input type="password" placeholder="HesloPassword" name="j_password"/>
                    <button type="submit">Prihlásiť<>Login</button>
                </LoginForm>
            );
        }
    }
);

Komponent LogoutLink je jednoduchým odkazom The LogoutLink component is a simple reference (html element <a>), na kliknutie ktorého sa zobrazí potvrdzovací dialóg odhlásenia užívateľa. Po potvrdení je užívateľ z aplikácie odhlásený a presmerovaný na úvodnú (prihlasovaciu) stránku; for clicking it, there will be a confirming dialogue of user's logout displayed. After confirming, the user is logged out of the application and redirected to the initial (login) page.

Blok kódu
languagejs
import React from 'react';
import LogoutLink from "framework/components/auth/logoutLink";

// PríkladExample použitiaof komponentuLogoutLink LogoutLinkcomponent akousage jednejas zone položiekof menu items
export default class PageHeader extends React.Component {
    render() {
        return (
            <div className="container-fluid">
                <div className="row">
                    <div className="col-xs-4">
                        <a href="#section1">Section 1</a>
                    </div>
                    <div className="col-xs-4">
                        <a href="#section2">Section 2</a>
                    </div>
                    <div className="col-xs-4">
                        <a href="#section3">Section 3</a>
                    </div>
                    <div className="col-xs-4">
                        <LogoutLink>Logout</LogoutLink>
                    </div>
                </div>
            </div>
        );
    }
};

Kotva
d2
d2

...

Components for Communication with D2000 ( framework/components/d2)

DataContainer

Základný komponent SmartWeb Frameworku. Potomok komponentu SimplePageContainer, ktorý v sebe navyš zabaľuje rozhranie D2Api a automaticky nadväzuje a ukončuje pripojenie k D2000. Zároveň zabezpečuje podporu pre klávesové skratky na prepínanie režimu ladenia It is a basic component of the SmartWeb Framework. This descendant of the SimplePageContainer component packs the D2Api interface and automatically follows and ends connection to D2000. It also secures support for keyboard shortcuts to switch debugging mode (CTRL+ALT+D) a rebundlovania aplikácie to rebundle application (CTRL+ALT+R). Do ostatných komponentov sa propaguje ako atribút s názvom d2.It is promoted as an attribute with the name d2 into other components. 

Attribute nameTypeMandatoryDefault valueDescriptionNázov atribútuTypPovinnýPredvolená hodnotaPopis
connectionobjectObsahuje informácie o pripojení k D2000 ako názov aplikácie a meno prihláseného užívateľa. Atribút je nastavovaný automaticky.

TclScheme

Tento komponent slúži na zobrazenie D2000 schémy pomocou technológie tenkého klienta (TCL). Schéma bude na stránku vložená ako HTML element <iframe>. Atribúty komponentu sú:



It contains information about the connection to D2000 as an application name and logged in user name. The attribute is set automatically. 

TclScheme

This component serves for displaying the D2000 scheme using the technology of a thin client (TCL). The scheme will be entered to the page as the HTML element <iframe>. Component attributes are:

Attribute nameTypeMandatoryDefault valueDescriptionNázov atribútuTypPovinnýPredvolená hodnotaPopis
d2objectánoyes
Reference to the DataContainer component. It is submitted from the parent container. Odkaz na komponent DataContainer. Odovzdáva sa z rodičovského kontajneru.
datasourcestringánoNázov D2000 objektu typu schéma, ktorá má byť zobrazená.

ValueComponent

Komponent zobrazujúci aktuálnu hodnotu D2000 objektu. Hodnota je zobrazovaná v HTML elemente <span>. Nasledujúca tabuľka popisuje atribúty komponentu:

yes
It is the name of the D2000 object of the scheme type that should be displayed. 

ValueComponent

This component shows the current value of the D2000 object. The value is displayed in the HTML element <span>. The following table describes the attributes of the component:

Attribute nameTypeMandatoryDefault valueDescriptionNázov atribútuTypPovinnýPredvolená hodnotaPopis
d2objectánoyes
Link to the DataContainer component. It is submitted from the parent container. Odkaz na komponent DataContainer. Odovzdáva sa z rodičovského kontajneru.
datasourcestringánoyes
It is the name of the D2000 object and its value should be displayed. Názov D2000 objektu, ktorého hodnota má byť zobrazovaná.
returnFieldsstring[]Zoznam

atribútov hodnoty, ktoré majú byť spolu s hodnotou objektu zaslané. Možné atribúty sú popísané na stránke Serializácia dát medzi klientom a API rozhraniamiList of value attributes that should be sent together with the object value. Possbile attributes are described on the page Serialization of Data between Client and API Interface.
descriptionstringManuálne

definovaný popis objektu - má prednosť pred popisom definovaným v Manually defined object description - it is preferred to the description defined in D2000.
technicalUnitsstringManuálne

definované technické jednotku objektu - majú prednosť pred definovanými v Manually defined technical object units - they are preferred to those defined in D2000.
numberFormatstringFormát

pre číselné hodnoty objektu v tvare pre knižnicu Format for numerical object values in the form fit for the Numeral.js. Ak je definovaný, má prednosť pred formátovanou hodnotou zaslanou z D2000 library. If it is defined, it will be preferred to the format value sent from D2000.
dateFormatstringFormát

pre hodnoty typu absolútny čas v tvare pre knižnicu Format for values of the absolute time type in the form fit for the Moment.js. Ak je definovaný, má prednosť pred formátovanou hodnotou zaslanou z D2000 library. If it is defined, it will be preferred to format value sent from D2000.
missingDescriptionstringPopis, ktorý sa použije v prípade, že nebol definovaný manuálne, ani v

The description that is used when it was not defined manually nor in D2000.
missingFormattedValuestringFormátovaná hodnota, ktorá sa použije v prípade, že objekt nemá platnú hodnotu.

Format value used when the object does not have a valid value. 
missingTechnicalUnitsstringTechnické jednotky, ktoré sa použijú v prípade, že neboli definované manuálne, ani v

Technical units used when they were not defined manually nor in D2000.
classNamestringNázov

CSS triedy, ktorá bude aplikovaná na HTML element <span> zobrazujúci hodnotu objektu.Name of the CSS class that will be applied to the HTML element <span> displaying object value. 
styleobject

CSS štýl, ktorý bude aplikovaný na style that will be applied to the HTML element <span> zobrazujúci hodnotu objektu. displaying object value. 

Kotva
datetime
datetime

...

Components of Datepicker (framework/components/datetime)

BootstrapDatePicker

Komponent výberovníka dátumu. Založený je na komponente Bootstrap Datepicker, ktorého atribúty rozširuje o nasledovné:

It is the component of a datepicker based on the Bootstrap Datepicker component which has the following attributes:

Attribute nameTypeMandatoryDefault valueDescriptionNázov atribútuTypPovinnýPredvolená hodnotaPopis
namestring

Unikátne meno pre Unique name for the HTML element <input>.
classNamestringNázov CSS triedy, ktorá bude aplikovaná na HTML element <input> zobrazujúci vybraný dátum.

Name of the CSS class that will be applied to the HTML element <input> displaying the chosen date. 
defaultValue

string

date

Predvolená


hodnota. Môže byť zadaná ako text alebo ako objekt date.Default value. It can be entered as a text or as a date object. 
disabledbool
falseZakáže alebo povolí modifikáciu.It forbids or allows modification. 
enableKeyboardEditbool
truePovolí alebo zakáže modifikáciu pomocou kláves.It allows or forbids modification by a keyboard. 

Example of a usagePríklad použitia

Blok kódu
languagejs
// otémovanáthemed verziaversion komponentuof alert component
import DatePicker from 'framework/components/datetime/themedBootstrapDatePicker'
// verziacomponent komponentuversion bezwithout CSS štýlovstyles - neotémovanáunthemed, it CSSis necessary jeto nutnémanually ručneimport naimportovaťCSS
// import DatePicker from 'framework/components/datetime/bootstrapDatePicker'

// príkladusage použitiaexample vin JSX
<div className="row">
  <div className="col-md-2">
      <DatePicker defaultValue={new Date()}/>
  </div>
</div>

BootstrapDateRangePicker

Komponent BootstrapDateRangePicker je rozšírením dátumovníka. Zobrazuje dva dátumy, ktorými sa definuje interval. Atribúty zabaleného komponentu Bootstrap Datepicker rozširuje o nasledovné:

The BootstrapDateRangePicker component is an extension of the datepicker. It displays two dates by which the interval is defined. Apart from attributes of the packed component Bootstrap Datepicker, there are the following attributes: 

Attribute nameTypeMandatoryDefault valueDescriptionNázov atribútuTypPovinnýPredvolená hodnotaPopis
namestring

Unikátne meno pre Unique name for the HTML element <input>.
classNamestring

Názov CSS triedy, ktorá bude aplikovaná na HTML element <input> zobrazujúci vybraný dátum.Name of the CSS class that will be applied to the HTML element <input> displaying the chosen date. 
defaultFromValue

string

date

Predvolená hodnota


začiatku intervalu. Môže byť zadaná ako text alebo ako objekt date.The default value of the interval beginning. It can be entered as a text or as a date object. 
defaultToValue

string

date

Predvolená hodnota konca intervalu. Môže byť zadaná ako text alebo ako objekt date.


The default value of the interval end. It can be entered as a text or as a date object. 
betweenDatesTextstring
"do"Text zobrazený medzi dátumamidisplayed between dates.
disabledbool
falseZakáže alebo povolí modifikáciuIt forbids or allows modification.
enableKeyboardEditbool
truePovolí alebo zakáže modifikáciu pomocou kláves.

...

It allows or forbids modification by a keyboard. 

Components of Lists (framework/components/list)

LazyList

Komponent LazyList implementuje zoznam, ktorý podporuje postupné načítavanie obsahu pri scrolovaní smerom nadol. Vo svojej základnej verzii zobrazuje obsah pomocou elementov <div>. Pre finálne použitie sa predpokladá preťaženie metód renderItem a render, ktoré majú na starosti vykresľovanie obsahu zoznamu. KomponentKomponent rozpoznáva nasledovné atribúty:

The LazyList component implements a list that supports gradual reading of content when scrolling downward. In its basic form, it displays content using elements <div>. For final usage, an overload of renderItem and render methods, which have are responsible for depicting the list content, is expected. The component recognizes the following attributes:

Attribute nameTypeMandatoryDefault valueDescriptionNázov atribútuTypPovinnýPredvolená hodnotaPopis
loadHandlerfunction

function (size, callback) {

callback([]);

}


Funkcia, ktorá je volaná pri požiadavke na načítanie ďalších dát. Parameter size hovorí, maximálne koľko prvkov má byť načítaných a parameter callback je funkcia, ktorou budú načítané dáta doplnené na koniec zoznamu.The function that is called when there is a request for reading more data. The size parameter defines the maximal number of elements that should be read and the callback parameter is a function using which read data will be added to the end of the list. 
batchSizenumber
10Predvolený počet prvkov, ktorý je načítavaný v jednej dávke. Odovzdáva sa ako parameter do funkcie loadHandler.The default number of elements which is read in one batch. It is submitted as a parameter into the loadHandler function. 

Kotva
react
react

...

Basic Components Widening React (framework/components/react)

ConfigurableComponent

Tento komponent slúži ako wrapper pre komponenty, ktoré nie sú natívnymi React komponentami. Vytvorením potomka tohto komponentu a preťažením metód This component serves as a wrapper for components that are not native React components. By creating a descendant of this component and by overloading methods configureComponentrender wrappedInstance je im možné jednoducho pridať podporu zobrazovania pomocou React frameworku.

RootElement

and wrappedInstance, it is possible to simply add to them the support of displaying using the React framework. 

RootElement

A component that replaces the HTML element with the Komponent, ktorý nahradzuje HTML element s id = "root" za zvolený React komponent. Tento komponent má len interné využitie.

SimplePageContainer

for the chosen React component. This component has only internal usage. 

SimplePageContainer

A basic container of a web page. It secures support for keyboard shortcuts to switch debugging mode Základný kontainer web stránky. Zabezpečuje podporu pre klávesové skratky na prepínanie režimu ladenia (CTRL+ALT+D) a rebundlovania aplikácie and to rebundle applications (CTRL+ALT+R). Jeho využitie je pre React stránky, ktoré nepotrebujú pripojenie k D2000. Na tvorbu web stránok, ktoré požadujú pripojenie k D2000 slúži potomok tohto komponentu DataContainer.It is used for React pages that do not need a connection to D2000. For creating web pages which require a connection to D2000, the descendant of the DataContainer component serves. 

Kotva
table
table

...

Table Component (framework/components/table)

...

DataTable and ThemedDataTable

Tabuľkový komponent Table v sebe zabaľuje knižnicu DataTables. Rozhranie tejto knižnice rozširuje o nasledovné atribúty:

The Table component encompasses the DataTables library. The interface of this library has these additional attributes:  

Attribute nameTypeMandatoryDefault valueDescriptionNázov atribútuTypPovinnýPredvolená hodnotaPopis
classNamestringNázov

CSS triedy, ktorá bude aplikovaná na hlavný HTML element zobrazujúci tabuľkuThe name of the CSS class which will be applied to the main HTML element displaying the table.
styleobject

CSS štýl, ktorý bude aplikovaný na hlavný HTML element zobrazujúci tabuľku.style which will be applied to the main HTML element displaying table. 
widthstring

Šírka tabuľky.Width of the table. 
heightstring

Výška tabuľky.Height of the table. 
renderFooterbool
falsePríznak či názvy stĺpcov budú zobrazené aj v pätičke tabuľky.Column names or flags will be displayed in the footer of the table. 


Blok kódu
languagejs
import React from 'react'
import {DataContainer} from '../custom/components'
import Table from 'framework/components/table/themedDataTable'
// verziacomponent komponentuversion bezwithout CSS štýlovstyles - neotémovanáunthemed, it CSSis necessary jeto nutnémanually ručneimport naimportovaťCSS
// import Table from 'framework/components/table/dataTable'

// PríkladExample použitiaof komponentuusing ThemedDataTable, ktorý načítavá dáta volaním component that reads data by calling RPC
DataContainer.renderComponent(class IndexPage extends React.Component {

    async loadData(data, callback, settings) {
        const d2Api = this.props.d2;
        const response = await d2Api.rpc("E.SmartWebApiTutorial", "GetPersonData", 1000, {
            type: 'record',
            structType: 'SD.Arr_Person',
            returnAs: 'vysledokresult',
            value: []
        }).call();

        callback({
            data: response.vysledokresult,
            recordsTotal: response.vysledokresult.length
        });
    }

    render() {
        return (
            <div>
                <Table className="table table-striped table-bordered dt-responsive nowrap dataTable" width="100%"
                       ajax = {(data, callback, settings) => {
                           this.loadData(data, callback, settings);
                       }}
                       columns = {[
                           {title: "MenoName", data: "menoname.value"},
                           {title: "VekAge", data: "vekage.value"}
                       ]}
                       select={true}
                       ref = {(component) => {
                           this.table = component;
                       }}/>
            </div>
        );
    }
});

...