This commit is contained in:
2020-04-09 23:44:30 +00:00
parent de3163a93f
commit 9acd909606
2 changed files with 54 additions and 0 deletions

View File

@@ -1,8 +1,58 @@
# FORM BASICS
## Overview
### Responsive display
The AyaNova interface is designed to be "responsive" which means it will adapt what is displayed to accomodate to the size of the device being used.
This means that on smaller screens items will be displayed in a vertical manner and on larger screens they will flow outwards horizontally to make the best use of screen space.
In addition some elements are customized to work better with the size of the device being used. For example a data grid list of records will show as a traditional horizontal grid on a larger display to take advantage of the horizontal space and on a smaller device the same list will appear as a series of vertical boxes. This avoids the need to scroll sideways on any screen size.
The responsive display is dynamic which means it will adapt on the fly to the screen size even if it changes, so, for example if you rotate a narrow screen sideways the display will change to take advantage of the wider display area.
### Main user interface components
The overall AyaNova user interface consists of three main components:
- [App Bar](#app-bar) at the top
- [Navigation drawer](#navigation-drawer) to the side
- [View](#main-view-area) displayed in the main largest area of the screen
### App bar
The purpose of the app bar is to show which part of AyaNova is currently open by displaying a text title and often an icon corresponding to the form being displayed in the main view area.
A blue app bar indicates the current view is a main area of AyaNova and not a specific record being edited.
A green app bar indicates a specific record is being edited in an edit form.
The app bar also hosts the [context menu](#context-menu) which appears as three dots stacked on top of each other and the "hamburger" icon which looks like three horizontal bars stacked on top of each other and is used to show or hide the [navigation drawer](#navigation-drawer)
### Navigation drawer
The navigation drawer shows all the areas of AyaNova the currently logged in user has rights to access. Clicking on an item in the navigation drawer will cause that view to be displayed in the view area of AyaNova.
The navigation drawer can be displayed or hidden by clicking on the "hamburger" icon in the app bar.
On smaller screens such as smart phones the navigation drawer is by default not shown until the user clicks on the hamburger icon.
On larger screens the navigation drawer is displayed by default.
### Main view area
In the smallest sized screens the `Navigation drawer` will by default be hidden and only slide out when the user clicks on the `hamburger` icon at the top which appears as three horizontal lines stacked on top of each other.
On larger screens the navigation drawer will by default be visible and can be hidden by clicking on the hamburger icon at the top.
## How to use forms in AyaNova
TODO Anatomy of a form with all possible control types and common elements and how they work
This is a good page to have images on for examples
todo: tags and picklists, show how to enter a query in a picklist and how to query tags specifically
todo: common elements between all forms and menu options like record history, save, delete, help, whatever may trip people up or be confusing
## Navigation
## Context menu
The context menu is located at the top of every form in AyaNova and looks like 3 dots stacked vertically. It is called the "context" menu because the options in it will change based on the particular form in use, the rights the currently logged in user has to make changes or the state of an object being edited.
On larger screens the most commonly used options will move from the context menu to the main too

View File

@@ -1,5 +1,9 @@
# HOME-SEARCH Placeholder
## Overview
AyaNova has a search form available by selecting the Search option in the [context menu](ay-start-form-basics.md#context-menu)
Explain search phrase entry, stopwords etc
Searches are contains by default, case insensitive always.