editors.rst 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041
  1. .. include:: ../_header.rst
  2. .. highlight:: javascript
  3. Editors
  4. -------
  5. An editor is a panel that is dedicated to editing an object or input. It has a title and a content area. The title shows the name or identifier of the input object and the content area provides the UI elements to edit the input. In the majority of the cases, the input of an editor is a file.
  6. Dirty state
  7. ~~~~~~~~~~~
  8. An important characteristic of the editors is the "dirty" state. When the user changes something in the editor, the editor is labeled as "dirty" and indicates that it should be saved to persist the changes. If you close an editor but it is dirty, it shows a confirmation message, because the changes will be lost.
  9. .. image:: ../images/workbench-editor-dirty-04042020.jpg
  10. :alt: Editor dirty state and content preview.
  11. Title image
  12. ~~~~~~~~~~~
  13. The title of an editor, in many cases, shows a preview of the content of the input. It is the case of scenes or images. This helps to identify the input of an editor when you have some of them open.
  14. You can make the title image bigger or smaller, by pressing ``Ctrl+3`` and ``Ctrl+4``.
  15. .. image:: ../images/workbench-editor-title-small-04052020.jpg
  16. :alt: Title image size.
  17. Title menu
  18. ~~~~~~~~~~
  19. The editor's title provides a context menu with a couple of options. To close the editor, close other editors or change the title's image size:
  20. .. image:: ../images/workbench-editor-title-menu-04052020.jpg
  21. :alt: The context menu of the editor's title.
  22. Restore editors
  23. ~~~~~~~~~~~~~~~
  24. When you open a project, the IDE opens the editors used in the previous session. This information is stored in the local storage of the browser. This means, it is not present in other browser instance or you can remove it by clearing the browser private data.