npm package: @iobroker/gui-components
Description: React components to develop ioBroker interfaces with react.
Author: bluefox
Latest version: 8.0.2

# Help ReactJS classes for adapter config

You can find demo on https://github.com/ioBroker/adapter-react-demo

## Getting started

If you want to create the configuration page with ReactJS:

1. Create github repo for adapter.
2. execute `npx create-react-app src` . It will take a while.
3. `cd src`
4. Modify package.json file in src directory:
    - Change `name` from `src` to `ADAPTERNAME-admin` (Of course replace `ADAPTERNAME` with yours)
    - Add to devDependencies:
        ```json
        "@iobroker/adapter-react-v5": "^7.4.10",
        ```
        Versions can be higher.
        So your `src/package.json` should look like:

```json
{
    "name": "ADAPTERNAME-admin",
    "version": "0.1.0",
    "private": true,
    "dependencies": {
        "@iobroker/adapter-react-v5": "^7.4.10",
        "@iobroker/build-tools": "^1.0.0",
        "babel-eslint": "^10.1.0",
        "react-scripts": "^5.0.1"
    },
    "scripts": {
        "start": "react-scripts start",
        "build": "react-scripts build",
        "test": "react-scripts test",
        "eject": "react-scripts eject"
    },
    "eslintConfig": {
        "extends": "react-app"
    },
    "homepage": ".",
    "browserslist": [">0.2%", "not dead", "not ie <= 11", "not op_mini all"]
}
```

5. Call in `src`: `npm install`
6. Copy `tasks.js` into `src`: `cp node_modules/@iobroker/adapter-react-v5/tasks.js tasks.js`
7. Add scripts to your `package.json` `scripts` section:

```json
"scripts": {
    "0-clean": "node tasks --0-clean",
    "1-npm": "node tasks --1-npm",
    "2-build": "node tasks --2-build",
    "3-copy": "node tasks --3-copy",
    "4-patch": "node tasks --4-patch",
    "build": "node tasks"
}
```

7. Start your dummy application `npm run start` for developing or build with `npm run build` and
   copy files in `build` directory to `www` or to `admin`. In the admin you must rename `index.html` to `index_m.html`.
8. You can do that with `npm` tasks: `npm run build`

## Development

1. Add `socket.io` to `public/index.html`.
   After

```html
<link
    rel="manifest"
    href="%PUBLIC_URL%/manifest.json"
/>
```

insert

```html
<script>
    const script = document.createElement('script');
    window.registerSocketOnLoad = function (cb) {
        window.socketLoadedHandler = cb;
    };
    const parts = (window.location.search || '').replace(/^\?/, '').split('&');
    const query = {};
    parts.forEach(item => {
        const [name, val] = item.split('=');
        query[decodeURIComponent(name)] = val !== undefined ? decodeURIComponent(val) : true;
    });
    script.onload = function () {
        typeof window.socketLoadedHandler === 'function' && window.socketLoadedHandler();
    };
    script.src =
        window.location.port === '3000'
            ? window.location.protocol +
              '//' +
              (query.host || window.location.hostname) +
              ':' +
              (query.port || 8081) +
              '/lib/js/socket.io.js'
            : '%PUBLIC_URL%/../../lib/js/socket.io.js';

    document.head.appendChild(script);
</script>
```

3. Add to App.js constructor initialization for I18n:

```jsx
class App extends GenericApp {
    constructor(props) {
        const extendedProps = { ...props };
        extendedProps.encryptedFields = ['pass']; // this parameter will be encrypted and decrypted automatically
        extendedProps.translations = {
            en: require('./i18n/en'),
            de: require('./i18n/de'),
            ru: require('./i18n/ru'),
            pt: require('./i18n/pt'),
            nl: require('./i18n/nl'),
            fr: require('./i18n/fr'),
            it: require('./i18n/it'),
            es: require('./i18n/es'),
            pl: require('./i18n/pl'),
            uk: require('./i18n/uk'),
            'zh-cn': require('./i18n/zh-cn'),
        };
        // get actual admin port
        extendedProps.socket = { port: parseInt(window.location.port, 10) };

        // Only if close, save buttons are not required at the bottom (e.g. if admin tab)
        // extendedProps.bottomButtons = false;

        // only for debug purposes
        if (extendedProps.socket.port === 3000) {
            extendedProps.socket.port = 8081;
        }

        // allow to manage GenericApp the sentry initialisation or do not set the sentryDSN if no sentry available
        extendedProps.sentryDSN = 'https://yyy@sentry.iobroker.net/xx';

        super(extendedProps);
    }
    // ...
}
```

4. Replace `index.js` with the following code to support themes:

```jsx
import React from 'react';
import { createRoot } from 'react-dom/client';
import * as serviceWorker from './serviceWorker';

import './index.css';
import App from './App';
import { version } from '../package.json';

console.log(`iobroker.scenes@${version}`);

const container = document.getElementById('root');
const root = createRoot(container);
root.render(<App />);

// If you want your app to work offline and load faster, you can change
// unregister() to register() below. Note this comes with some pitfalls.
// Learn more about service workers: http://bit.ly/CRA-PWA
serviceWorker.unregister();
```

5. Add to App.js encoding and decoding of values:

```jsx
class App extends GenericApp {
    // ...
    onPrepareLoad(settings) {
        settings.pass = this.decode(settings.pass);
    }
    onPrepareSave(settings) {
        settings.pass = this.encode(settings.pass);
    }
}
```

6. The optional step is to validate the data to be saved:

```jsx
onPrepareSave(settings) {
     super.onPrepareSave(settings);
     if (DATA_INVALID) {
         return false; // configuration will not be saved
     } else {
         return true;
     }
 }
```

## Components

### Connection.tsx

This is a non-React class to provide the communication for socket connection with the server.

### GenericApp.tsx

### i18n.ts

### Theme.tsx

### Dialogs

Some dialogs are predefined and could be used out of the box.

#### Confirm.tsx

<!-- TODO: Provide screenshot here -->

Usage:

```jsx
import React from 'react';
import { I18n, Confirm as ConfirmDialog } from '@iobroker/adapter-react-v5';

class ExportImportDialog extends React.Component {
    constructor(props) {
        super(props);

        this.state = {
            confirmDialog: false,
        };
    }

    renderConfirmDialog() {
        if (!this.state.confirmDialog) {
            return null;
        }
        return (
            <ConfirmDialog
                title={I18n.t('Scene will be overwritten.')}
                text={I18n.t('All data will be lost. Confirm?')}
                ok={I18n.t('Yes')}
                cancel={I18n.t('Cancel')}
                suppressQuestionMinutes={5}
                dialogName="myConfirmDialogThatCouldBeSuppressed"
                suppressText={I18n.t('Suppress question for next %s minutes', 5)}
                onClose={isYes => {
                    this.setState({ confirmDialog: false });
                }}
            />
        );
    }
    render() {
        return (
            <div>
                <Button onClick={() => this.setState({ confirmDialog: true })}>Click</Button>
                {this.renderConfirmDialog()}
            </div>
        );
    }
}

export default ExportImportDialog;
```

#### Error.tsx

<!-- TODO: Provide screenshot here -->

#### Message.tsx

<!-- TODO: Provide screenshot here -->

```jsx
renderMessage() {
   if (this.state.showMessage) {
      return <Message
         text={this.state.showMessage}
         onClose={() => this.setState({showMessage: false})}
      />;
   } else {
      return null;
   }
}
```

#### SelectID.tsx

![Logo](img/selectID.png)

```jsx
import { SelectID as DialogSelectID } from '@iobroker/adapter-react-v5';

class MyComponent extends Component {
    constructor(props) {
        super(props);
        this.state = {
            showSelectId: false,
        };
    }

    renderSelectIdDialog() {
        if (this.state.showSelectId) {
            return (
                <DialogSelectID
                    key="tableSelect"
                    imagePrefix="../.."
                    dialogName={this.props.adapterName}
                    themeType={this.props.themeType}
                    socket={this.props.socket}
                    statesOnly={true}
                    selected={this.state.selectIdValue}
                    onClose={() => this.setState({ showSelectId: false })}
                    onOk={(selected, name) => {
                        this.setState({ showSelectId: false, selectIdValue: selected });
                    }}
                />
            );
        } else {
            return null;
        }
    }
    render() {
        return renderSelectIdDialog();
    }
}
```

#### Cron

Include `"react-text-mask": "^5.4.3",` in package.json.

<!-- TODO: Provide screenshot here -->

```jsx
function renderCron() {
    if (!showCron) {
        return null;
    } else {
        return (
            <DialogCron
                key="dialogCron1"
                cron={this.state.cronValue || '* * * * *'}
                onClose={() => this.setState({ showCron: false })}
                onOk={cronValue => {
                    this.setState({ cronValue });
                }}
            />
        );
    }
}
```

### Components

#### Utils.tsx

##### getObjectNameFromObj

`getObjectNameFromObj(obj, settings, options, isDesc)`

Get object name from a single object.

Usage: `Utils.getObjectNameFromObj(this.objects[id], null, {language: I18n.getLanguage()})`

##### getObjectIcon

`getObjectIcon(id, obj)`

Get icon from the object.

Usage:

```jsx
const icon = Utils.getObjectIcon(id, this.objects[id]);
return <img src={icon} />;
```

##### isUseBright

`isUseBright(color, defaultValue)`

Usage: `

#### Loader.tsx

![Logo](img/loader.png)

```jsx
render() {
     if (!this.state.loaded) {
         return <MuiThemeProvider theme={this.state.theme}>
             <Loader theme={this.state.themeType}/>
         </MuiThemeProvider>;
     }
     // render loaded data
}

```

#### Logo.tsx

![Logo](img/logo.png)

```jsx
render() {
   return <form className={this.props.classes.tab}>
      <Logo
       instance={this.props.instance}
       common={this.props.common}
       native={this.props.native}
       onError={text => this.setState({errorText: text})}
       onLoad={this.props.onLoad}
      />
      ...
   </form>;
}
```

#### Router.tsx

#### ObjectBrowser.js

It is better to use `Dialog/SelectID`, but if you want:

![Logo](img/objectBrowser.png)

```jsx
<ObjectBrowser
    foldersFirst={this.props.foldersFirst}
    imagePrefix={this.props.imagePrefix || this.props.prefix} // prefix is for back compatibility
    defaultFilters={this.filters}
    dialogName={this.dialogName}
    showExpertButton={this.props.showExpertButton !== undefined ? this.props.showExpertButton : true}
    style={{ width: '100%', height: '100%' }}
    columns={this.props.columns || ['name', 'type', 'role', 'room', 'func', 'val']}
    types={this.props.types || ['state']}
    t={I18n.t}
    lang={this.props.lang || I18n.getLanguage()}
    socket={this.props.socket}
    selected={this.state.selected}
    multiSelect={this.props.multiSelect}
    notEditable={this.props.notEditable === undefined ? true : this.props.notEditable}
    name={this.state.name}
    theme={this.props.theme}
    themeName={this.props.themeName}
    themeType={this.props.themeType}
    customFilter={this.props.customFilter}
    onFilterChanged={filterConfig => {
        this.filters = filterConfig;
        window.localStorage.setItem(this.dialogName, JSON.stringify(filterConfig));
    }}
    onSelect={(selected, name, isDouble) => {
        if (JSON.stringify(selected) !== JSON.stringify(this.state.selected)) {
            this.setState({ selected, name }, () => isDouble && this.handleOk());
        } else if (isDouble) {
            this.handleOk();
        }
    }}
/>
```

#### TreeTable.ts

![Logo](img/tableTree.png)

```jsx
// STYLES
const styles = {
    tableDiv: {
        width: '100%',
        overflow: 'hidden',
        height: 'calc(100% - 48px)',
    },
};
class MyComponent extends Component {
    constructor(props) {
        super(props);

        this.state = {
            data: [
                {
                    id: 'UniqueID1', // required
                    fieldIdInData: 'Name1',
                    myType: 'number',
                },
                {
                    id: 'UniqueID2', // required
                    fieldIdInData: 'Name12',
                    myType: 'string',
                },
            ],
        };

        this.columns = [
            {
                title: 'Name of field', // required, else it will be "field"
                field: 'fieldIdInData', // required
                editable: false, // or true [default - true]
                cellStyle: {
                    // CSS style - // optional
                    maxWidth: '12rem',
                    overflow: 'hidden',
                    wordBreak: 'break-word',
                },
                lookup: {
                    // optional => edit will be automatically "SELECT"
                    value1: 'text1',
                    value2: 'text2',
                },
            },
            {
                title: 'Type', // required, else it will be "field"
                field: 'myType', // required
                editable: true, // or true [default - true]
                lookup: {
                    // optional => edit will be automatically "SELECT"
                    number: 'Number',
                    string: 'String',
                    boolean: 'Boolean',
                },
                type: 'number/string/color/oid/icon/boolean', // oid=ObjectID,icon=base64-icon
                editComponent: props => (
                    <div>
                        Prefix&#123; <br />
                        <textarea
                            rows={4}
                            style={{ width: '100%', resize: 'vertical' }}
                            value={props.value}
                            onChange={e => props.onChange(e.target.value)}
                        />
                        Suffix
                    </div>
                ),
            },
        ];
    }
    // renderTable
    render() {
        return (
            <div className={this.props.classes.tableDiv}>
                <TreeTable
                    columns={this.columns}
                    data={this.state.data}
                    onUpdate={(newData, oldData) => {
                        const data = JSON.parse(JSON.stringify(this.state.data));

                        // Added new line
                        if (newData === true) {
                            // find unique ID
                            let i = 1;
                            let id = 'line_' + i;

                            // eslint-disable-next-line
                            while (this.state.data.find(item => item.id === id)) {
                                i++;
                                id = 'line_' + i;
                            }

                            data.push({
                                id,
                                name: I18n.t('New resource') + '_' + i,
                                color: '',
                                icon: '',
                                unit: '',
                                price: 0,
                            });
                        } else {
                            // existing line was modifed
                            const pos = this.state.data.indexOf(oldData);
                            if (pos !== -1) {
                                Object.keys(newData).forEach(attr => (data[pos][attr] = newData[attr]));
                            }
                        }

                        this.setState({ data });
                    }}
                    onDelete={oldData => {
                        console.log('Delete: ' + JSON.stringify(oldData));
                        const pos = this.state.data.indexOf(oldData);
                        if (pos !== -1) {
                            const data = JSON.parse(JSON.stringify(this.state.data));
                            data.splice(pos, 1);
                            this.setState({ data });
                        }
                    }}
                />
            </div>
        );
    }
}
```

#### Toast

<!-- TODO: Provide screenshot here -->

Toast is not a part of `adapter-react` but it is an example how to use toast in application:

```jsx
import { Component } from 'react';
import { Snackbar } from '@mui/material';

class MyComponent extends Component {
    constructor(props) {
        super(props);
        this.state = {
            // ....
            toast: '',
        };
    }

    // ...
    renderToast() {
        if (!this.state.toast) {
            return null;
        }
        return (
            <Snackbar
                anchorOrigin={{
                    vertical: 'bottom',
                    horizontal: 'left',
                }}
                open={true}
                autoHideDuration={6000}
                onClose={() => this.setState({ toast: '' })}
                ContentProps={{ 'aria-describedby': 'message-id' }}
                message={<span id="message-id">{this.state.toast}</span>}
                action={[
                    <IconButton
                        key="close"
                        aria-label="Close"
                        color="inherit"
                        className={this.props.classes.close}
                        onClick={() => this.setState({ toast: '' })}
                    >
                        <IconClose />
                    </IconButton>,
                ]}
            />
        );
    }

    render() {
        return <div>{this.renderToast()}</div>;
    }
}
```

## List of adapters that use adapter-react

-   Admin
-   Backitup
-   iot
-   echarts
-   text2command
-   scenes
-   javascript
-   devices
-   eventlist
-   cameras
-   web
-   vis-2
-   vis-2-widgets-xxx
-   fullcalendar
-   openweathermap

## Usability

In dialogs, the OK button is first (on the left) and the cancel button is last (on the right)

## Used icons

This project uses icons from [Flaticon](https://www.flaticon.com/).

ioBroker GmbH has a valid license for all the used icons.
The icons may not be reused in other projects without the proper flaticon license or flaticon subscription.

## Migration instructions

You can find the migration instructions:

-   [from adapter-react-v5@6.x to adapter-react-v5@7.x](MIGRATION_6_7.md)
-   [from adapter-react-v5@5.x to adapter-react-v5@6.x](MIGRATION_5_6.md)
-   [from adapter-react to adapter-react-v5@5.x](MIGRATION_4_5.md)

<!--
	Placeholder for the next version (at the beginning of the line):
	### **WORK IN PROGRESS**
-->

## Changelog
### 8.0.2 (2025-10-23)

-   (@GermanBluefox) Split packages from mono-repo

### 7.2.3 (2024-10-05)

-   (@GermanBluefox) Corrected error in the simple CRON dialog

### 7.2.2 (2024-10-04)

-   (@GermanBluefox) Small layout change for Icon Picker

### 7.2.1 (2024-09-30)

-   (@GermanBluefox) Allowed using an array of elements in dialogs
-   (@GermanBluefox) Allowed to use `socket.iob` instead of `socket.io`

### 7.1.4 (2024-09-15)

-   (@GermanBluefox) Updated socket classes

### 7.1.3 (2024-09-15)

-   (@GermanBluefox) Updated socket classes
-   (@GermanBluefox) Added additional confirmation dialog for CRONs for every minute execution

### 7.1.1 (2024-09-13)

-   (@GermanBluefox) Corrected TabContainer

### 7.1.0 (2024-09-12)

-   (@GermanBluefox) Optimized the icon picker
-   (@GermanBluefox) Used common eslint-config

### 7.0.2 (2024-09-10)

-   (@GermanBluefox) Showed the context menu under cursor position in the object browser
-   (@GermanBluefox) Added links to aliases in the object browser

### 7.0.1 (2024-08-29)

-   (@GermanBluefox) Updated the object browser
-   (@GermanBluefox) Used MUI Library 6.0

### 6.1.10 (2024-08-30)

-   (@GermanBluefox) Updated the object browser

### 6.1.9 (2024-08-14)

-   (@GermanBluefox) Updated JSON schema

### 6.1.8 (2024-08-03)

-   (@GermanBluefox) Added translations

### 6.1.6 (2024-07-23)

-   (@GermanBluefox) Optimize package

### 6.1.5 (2024-07-20)

-   (@GermanBluefox) Added sources to package

### 6.1.3 (2024-07-20)

-   (@GermanBluefox) Better typing of legacy connection

### 6.1.1 (2024-07-16)

-   (@GermanBluefox) Added translations

### 6.1.0 (2024-07-15)

-   (@GermanBluefox) Replace by CRON to text the package to `cronstrue`

### 6.0.19 (2024-07-14)

-   (@GermanBluefox) added some packages for federation

### 6.0.17 (2024-07-14)

-   (@GermanBluefox) Allowed playing mp3 files in the file browser
-   (@GermanBluefox) Corrected jump by object selection

### 6.0.14 (2024-07-07)

-   (@GermanBluefox) Corrected theme type selection

### 6.0.13 (2024-06-30)

-   (@GermanBluefox) Corrected color picker

### 6.0.12 (2024-06-29)

-   (@GermanBluefox) Added support for the overrides in the theme

### 6.0.10 (2024-06-27)

-   (@GermanBluefox) Added translation
-   (@GermanBluefox) Mobile object browser improved

### 6.0.9 (2024-06-26)

-   (@GermanBluefox) Corrected Icons

### 6.0.8 (2024-06-26)

-   (@GermanBluefox) Corrected types of the select ID dialog
-   (@GermanBluefox) Made the tooltips neutral to the pointer events

### 6.0.6 (2024-06-24)

-   (@GermanBluefox) Synchronised with admin
-   (@GermanBluefox) Added translations for time scheduler

### 6.0.4 (2024-06-21)

-   (@GermanBluefox) Removed the usage of `withStyles` in favor of `sx` and `style` properties (see [Migration from v5 to v6](#migration-from-v5-to-v6)
-   (@GermanBluefox) (BREAKING) Higher version of `@mui/material` (5.15.20) is used

### 5.0.8 (2024-06-15)

-   (@GermanBluefox) Added `modulefederation.admin.config.js` for module federation

### 5.0.5 (2024-06-10)

-   (@GermanBluefox) Sources were synchronized with admin

### 5.0.4 (2024-06-07)

-   (@GermanBluefox) Added better typing

### 5.0.2 (2024-05-30)

-   (@GermanBluefox) Added better typing
-   (@GermanBluefox) Json-Config is now a separate package and must be installed additionally

### 5.0.0 (2024-05-29)

-   (@GermanBluefox) Types are now exported
-   (@GermanBluefox) Translator renamed to Translate
-   (@GermanBluefox) Breaking: Theme renamed to IobTheme because of the naming conflict

### 4.13.24 (2024-05-25)

-   (@GermanBluefox) Updated packages

-   ### 4.13.22 (2024-05-23)
-   (@GermanBluefox) Updated packages

### 4.13.20 (2024-05-22)

-   (@GermanBluefox) Better types added
-   (@GermanBluefox) updated theme definitions
-   (@GermanBluefox) corrected dates in cron dialog

### 4.13.14 (2024-05-19)

-   (@GermanBluefox) Updated packages

### 4.13.13 (2024-05-09)

-   (@GermanBluefox) Updated ioBroker types

### 4.13.12 (2024-05-06)

-   (@GermanBluefox) All files are migrated to Typescript

### 4.13.11 (2024-04-23)

-   (@GermanBluefox) Corrected the size of icons

### 4.13.10 (2024-04-22)

-   (@GermanBluefox) Migrated all icons to Typescript

### 4.13.9 (2024-04-20)

-   (@GermanBluefox) Updated socket-client package

### 4.13.8 (2024-04-19)

-   (@GermanBluefox) Corrected CRON selector

### 4.13.7 (2024-04-19)

-   (@GermanBluefox) Migrated ColorPicker to typescript

### 4.13.6 (2024-04-11)

-   (@GermanBluefox) Migrated TreeTable to typescript
-   (@GermanBluefox) corrected the object subscription

### 4.13.5 (2024-04-02)

-   (@GermanBluefox) used new connection classes
-   (@GermanBluefox) Improved the `SelectID` dialog

### 4.13.3 (2024-04-01)

-   (@GermanBluefox) used new connection classes

### 4.12.3 (2024-03-30)

-   (@GermanBluefox) Migrated legacy connection to typescript

### 4.12.2 (2024-03-25)

-   (@GermanBluefox) Added support for remote cloud

### 4.11.6 (2024-03-19)

-   (@GermanBluefox) Corrected rendering of LoaderMV

### 4.11.4 (2024-03-18)

-   (@GermanBluefox) Corrected types of IconPicker

### 4.11.3 (2024-03-17)

-   (@GermanBluefox) Made filters for the file selector dialog optional

### 4.11.2 (2024-03-16)

-   (@GermanBluefox) Migrated GenericApp to typescript

### 4.10.4 (2024-03-16)

-   (@GermanBluefox) Migrated some components to typescript

### 4.10.1 (2024-03-11)

-   (@GermanBluefox) Migrated some components to typescript

### 4.9.11 (2024-03-08)

-   (foxriver76) type GenericApp socket correctly

### 4.9.10 (2024-02-21)

-   (@GermanBluefox) translations
-   (@GermanBluefox) updated JSON config

### 4.9.9 (2024-02-16)

-   (foxriver76) also check plugin state of instance to see if Sentry is explicitly disabled

### 4.9.8 (2024-02-13)

-   (@GermanBluefox) allowed hiding wizard in cron dialog

### 4.9.7 (2024-02-03)

-   (foxriver76) allow passing down the instance number do avoid determining from url

### 4.9.5 (2024-01-01)

-   (foxriver76) make `copyToClipboard` event parameter optional

### 4.9.4 (2024-01-01)

-   (foxriver76) try to fix `SelectID` scrolling

### 4.9.2 (2023-12-30)

-   (foxriver76) bump version of `@iobroker/json-config`

### 4.9.1 (2023-12-22)

-   (foxriver76) `@iobroker/json-config` moved to real dependencies

### 4.9.0 (2023-12-22)

-   (foxriver76) migrate to `@iobroker/json-config` module to have a single point of truth
-   (@GermanBluefox) Allowed using of `filterFunc` as string

### 4.8.1 (2023-12-14)

-   (@GermanBluefox) Added Device manager to JSON Config

### 4.7.15 (2023-12-12)

-   (@GermanBluefox) Corrected parsing of a text

### 4.7.13 (2023-12-10)

-   (@GermanBluefox) Added possibility to define the root style and embedded property

### 4.7.11 (2023-12-06)

-   (@GermanBluefox) Extended color picker with "noInputField" option

### 4.7.9 (2023-12-04)

-   (@GermanBluefox) Corrected the icon picker

### 4.7.8 (2023-12-04)

-   (foxriver76) port to `@iobroker/types`

### 4.7.6 (2023-11-29)

-   (@GermanBluefox) Added translations

### 4.7.5 (2023-11-28)

-   (@GermanBluefox) Corrected subscribe on objects in the legacy connection

### 4.7.4 (2023-11-23)

-   (@GermanBluefox) Updated packages
-   (@GermanBluefox) Made getStates method in legacy connection compatible with new one

### 4.7.3 (2023-11-08)

-   (@GermanBluefox) Updated packages

### 4.7.2 (2023-11-03)

-   (foxriver76) fixed problem with color picker, where editing TextField was buggy
-   (foxriver76) fixed light mode color of a path in FileBrowser

### 4.7.0 (2023-10-31)

-   (@GermanBluefox) Synced with admin
-   (@GermanBluefox) Added GIF to image files

### 4.6.7 (2023-10-19)

-   (@GermanBluefox) Added return value for `subscribeOnInstance` for Connection class

### 4.6.6 (2023-10-13)

-   (@GermanBluefox) Fixed the legacy connection

### 4.6.5 (2023-10-12)

-   (foxriver76) fixed object browser with date

### 4.6.4 (2023-10-11)

-   (@GermanBluefox) Updated the packages

### 4.6.3 (2023-10-09)

-   (@GermanBluefox) Just updated the packages
-   (@GermanBluefox) Synced with admin

### 4.6.2 (2023-09-29)

-   (@GermanBluefox) Experimental feature added: update states on re-subscribe

### 4.5.5 (2023-09-27)

-   (@GermanBluefox) Added export for IconNoIcon

### 4.5.4 (2023-09-17)

-   (@GermanBluefox) Added the restricting to folder property for select file dialog

### 4.5.3 (2023-08-20)

-   (foxriver76) fixed css classes of TableResize, see https://github.com/ioBroker/ioBroker.admin/issues/1860

### 4.5.2 (2023-08-20)

-   (foxriver76) added missing export of TableResize

### 4.5.1 (2023-08-19)

-   (foxriver76) fix dialog TextInput

### 4.5.0 (2023-08-18)

-   (@GermanBluefox) Synchronize components with admin

### 4.4.8 (2023-08-17)

-   (@GermanBluefox) Added translations

### 4.4.7 (2023-08-10)

-   (@GermanBluefox) Added `subscribeStateAsync` method to wait for answer
-   (@GermanBluefox) Added support for arrays for un/subscriptions

### 4.4.5 (2023-08-01)

-   (@GermanBluefox) Updated packages

### 4.3.3 (2023-07-28)

-   (@GermanBluefox) Added translations

### 4.3.0 (2023-07-19)

-   (@GermanBluefox) Updated packages
-   (@GermanBluefox) Added translations
-   (@GermanBluefox) Synced object browser
-   (@GermanBluefox) formatting

### 4.2.1 (2023-07-17)

-   (@GermanBluefox) Updated packages
-   (@GermanBluefox) Added translations

### 4.2.0 (2023-07-07)

-   (@GermanBluefox) Updated packages
-   (@GermanBluefox) Added new method `getObjectsById` to the socket communication

### 4.1.2 (2023-06-20)

-   (@GermanBluefox) Allowed setting theme name directly by theme toggle

### 4.1.0 (2023-05-10)

-   (@GermanBluefox) `craco-module-federation.js` was added. For node 16

### 4.0.27 (2023-05-09)

-   (@GermanBluefox) Allowed showing only specific root in SelectIDDialog

### 4.0.26 (2023-05-08)

-   (@GermanBluefox) Added IDs to the buttons in the dialog for GUI tests

### 4.0.25 (2023-04-23)

-   (@GermanBluefox) Extended `TextWithIcon` with defined color and icon

### 4.0.24 (2023-04-03)

-   (@GermanBluefox) Updated the file selector in tile mode

### 4.0.23 (2023-03-27)

-   (@GermanBluefox) Added translations

### 4.0.22 (2023-03-22)

-   (@GermanBluefox) Re-Activate legacy connection

### 4.0.21 (2023-03-22)

-   (@GermanBluefox) Added translations

### 4.0.20 (2023-03-21)

-   (@GermanBluefox) Color picker was improved

### 4.0.19 (2023-03-20)

-   (@GermanBluefox) Packages were updated
-   (@GermanBluefox) Added new translations

### 4.0.18 (2023-03-16)

-   (@GermanBluefox) Packages were updated

### 4.0.17 (2023-03-15)

-   (@GermanBluefox) Added translations
-   (@GermanBluefox) Added port controller to JSON config

### 4.0.15 (2023-03-12)

-   (@GermanBluefox) Updated the object browser and file browser

### 4.0.14 (2023-03-03)

-   (@GermanBluefox) added handler of alert messages

### 4.0.13 (2023-02-15)

-   (@GermanBluefox) Corrected the theme button

### 4.0.12 (2023-02-15)

-   (@GermanBluefox) made the fix for `echarts`

### 4.0.11 (2023-02-14)

-   (@GermanBluefox) Updated packages
-   (@GermanBluefox) The `chartReady` event was omitted

### 4.0.10 (2023-02-10)

-   (@GermanBluefox) Updated packages
-   (@GermanBluefox) made the fix for `material`

### 4.0.9 (2023-02-02)

-   (@GermanBluefox) Updated packages

### 4.0.8 (2022-12-19)

-   (@GermanBluefox) Extended socket with `log` command

### 4.0.6 (2022-12-19)

-   (@GermanBluefox) Corrected URL for the connection

### 4.0.5 (2022-12-14)

-   (@GermanBluefox) Added support of custom palette for color picker

### 4.0.2 (2022-12-01)

-   (@GermanBluefox) use `@iobroker/socket-client` instead of `Connection.tsx`

### 3.5.3 (2022-11-30)

-   (@GermanBluefox) Improved `renderTextWithA` function to support `<b>` and `<i>` tags

### 3.5.2 (2022-11-30)

-   (@GermanBluefox) updated json config component

### 3.4.1 (2022-11-29)

-   (@GermanBluefox) Added button text for message dialog

### 3.4.0 (2022-11-29)

-   (@GermanBluefox) Added file selector

### 3.3.0 (2022-11-26)

-   (@GermanBluefox) Added subscribe on files

### 3.2.7 (2022-11-13)

-   (@GermanBluefox) Added `fullWidth` property to `Dialog`

### 3.2.6 (2022-11-08)

-   (xXBJXx) Improved TreeTable component

### 3.2.5 (2022-11-08)

-   (@GermanBluefox) Added the role filter for the object browser

### 3.2.4 (2022-11-03)

-   (@GermanBluefox) Added support for alfa channel for `invertColor`

### 3.2.3 (2022-10-26)

-   (@GermanBluefox) Corrected expert mode for object browser

### 3.2.2 (2022-10-25)

-   (@GermanBluefox) Added support for prefixes for translations

### 3.2.1 (2022-10-24)

-   (@GermanBluefox) Corrected color inversion

### 3.2.0 (2022-10-19)

-   (@GermanBluefox) Added ukrainian translation

### 3.1.35 (2022-10-17)

-   (@GermanBluefox) small changes for material

### 3.1.34 (2022-08-24)

-   (@GermanBluefox) Implemented fallback to english by translations

### 3.1.33 (2022-08-24)

-   (@GermanBluefox) Added support for onchange flag

### 3.1.30 (2022-08-23)

-   (@GermanBluefox) Added method `getCompactSystemRepositories`
-   (@GermanBluefox) corrected error in `ObjectBrowser`

### 3.1.27 (2022-08-01)

-   (@GermanBluefox) Disable file editing in FileViewer

### 3.1.26 (2022-08-01)

-   (@GermanBluefox) Added translations
-   (@GermanBluefox) JSON schema was extended with missing definitions

### 3.1.24 (2022-07-28)

-   (@GermanBluefox) Updated file browser and object browser

### 3.1.23 (2022-07-25)

-   (@GermanBluefox) Extend custom filter for object selector

### 3.1.22 (2022-07-22)

-   (@GermanBluefox) Added i18n tools for development

### 3.1.20 (2022-07-14)

-   (@GermanBluefox) Allowed to show select dialog with the expert mode enabled

### 3.1.19 (2022-07-08)

-   (@GermanBluefox) Allowed extending translations for all languages together

### 3.1.18 (2022-07-06)

-   (@GermanBluefox) Added translation

### 3.1.17 (2022-07-05)

-   (@GermanBluefox) Deactivate JSON editor for JSONConfig because of space

### 3.1.16 (2022-06-27)

-   (@GermanBluefox) Update object browser

### 3.1.15 (2022-06-27)

-   (@GermanBluefox) Allowed using of spaces in name

### 3.1.14 (2022-06-23)

-   (@GermanBluefox) Added translations

### 3.1.11 (2022-06-22)

-   (@GermanBluefox) Added preparations for iobroker cloud

### 3.1.10 (2022-06-22)

-   (@GermanBluefox) Added translations

### 3.1.9 (2022-06-20)

-   (@GermanBluefox) Allowed working behind reverse proxy

### 3.1.7 (2022-06-19)

-   (@GermanBluefox) Added file select dialog

### 3.1.3 (2022-06-13)

-   (@GermanBluefox) Added table with resized headers

### 3.1.2 (2022-06-09)

-   (@GermanBluefox) Added new document icon (read only)

### 3.1.1 (2022-06-09)

-   (@GermanBluefox) Allowed working behind reverse proxy

### 3.1.0 (2022-06-07)

-   (@GermanBluefox) Some german texts were corrected

### 3.0.17 (2022-06-03)

-   (@GermanBluefox) Allowed calling getAdapterInstances not for admin too

### 3.0.15 (2022-06-01)

-   (@GermanBluefox) Updated JsonConfigComponent: password, table

### 3.0.14 (2022-05-25)

-   (@GermanBluefox) Added ConfigGeneric to import

### 3.0.7 (2022-05-25)

-   (@GermanBluefox) Made the module definitions

### 3.0.6 (2022-05-25)

-   (@GermanBluefox) Added JsonConfigComponent

### 2.1.11 (2022-05-24)

-   (@GermanBluefox) Update file browser. It supports now the file changed events.

### 2.1.10 (2022-05-24)

-   (@GermanBluefox) Corrected object browser

### 2.1.9 (2022-05-16)

-   (@GermanBluefox) Corrected expert mode in object browser

### 2.1.7 (2022-05-09)

-   (@GermanBluefox) Changes were synchronized with adapter-react-v5
-   (@GermanBluefox) Added `I18n.disableWarning` method

### 2.1.6 (2022-03-28)

-   (@GermanBluefox) Added `log` method to connection
-   (@GermanBluefox) Corrected translations

### 2.1.1 (2022-03-27)

-   (@GermanBluefox) Corrected error in TreeTable

### 2.1.0 (2022-03-26)

-   (@GermanBluefox) BREAKING_CHANGE: Corrected error with readFile(base64=false)

### 2.0.0 (2022-03-26)

-   (@GermanBluefox) Initial version

### 0.1.0 (2022-03-23)

-   (@GermanBluefox) Fixed theme errors

### 0.0.4 (2022-03-22)

-   (@GermanBluefox) Fixed eslint warnings

### 0.0.3 (2022-03-19)

-   (@GermanBluefox) beta version

### 0.0.2 (2022-02-24)

-   (@GermanBluefox) try to publish a first version

### 0.0.1 (2022-02-24)

-   initial commit

## License

The MIT License (MIT)

Copyright (c) 2019-2025 @GermanBluefox <dogafox@gmail.com>

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.