# Elements

You can use AppMachine's preconfigured blocks to add data to your app, or you can dive deeper and design your screens down to every last detail. \
To use our Element Editor you need to add a Blank page, List, or Detail Block to your app. You can then use our drag and drop screen editor to configure your screen.

### Types of elements

AppMachine offers you various types of elements to add to your pages:&#x20;

* Display, including text and button elements
* Form elements
* Card elements\ <br>

  <figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2F2ZX7rWhO52Tj3MCAmOJp%2FScreenshot%202023-03-20%20at%2016.36.21.png?alt=media&#x26;token=5001e092-a8b5-4133-bb5b-15fbea02dc15" alt=""><figcaption></figcaption></figure>

Almost every element has the following basic settings which allow you to style the screen in anyway you want: <br>

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2F1FBMenAWZ5unQxIGktX7%2FScreenshot%202023-03-20%20at%2016.48.15.png?alt=media&#x26;token=f7cf7219-4479-4199-bba4-e9df70e5d9fe" alt=""><figcaption></figcaption></figure>

### Display

#### Container

An element used to hold other elements. Can be used to define/contain components that you create so that you can more easily move, edit, or manipulate them.&#x20;

#### List

Creates an ordered list from data made available to the app in the Data section.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2F9R29PsXTJrKsCND2Evii%2FScreenshot%202023-03-21%20at%2010.53.03.png?alt=media&#x26;token=2b5922a0-9f19-46ad-aa5b-8b9b52af67d5" alt=""><figcaption><p>Select from the available data sources in your app.</p></figcaption></figure>

Depending on the data available, the list generated will contain the different data types like Container, Repeater, Labels, and Links. The data types/elements can be toggled on and off and are then reflected in the design of the element.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FAOWnX61YYMquG3pHpbnt%2FScreenshot%202023-03-21%20at%2010.58.42.png?alt=media&#x26;token=cd3b3d28-12c5-44f0-bde3-87f8d1e8084d" alt=""><figcaption><p>Toggling content allows you to design a screen to your liking. </p></figcaption></figure>

![](https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2F3ejAoimnUVwAYQh2KVFG%2FScreenshot%202023-03-21%20at%2011.04.54.png?alt=media\&token=eb0db5af-6490-4654-aefe-2d2a540e8fe2)                 ![](https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FZe1Nny6UzdbIf8mLHIns%2FScreenshot%202023-03-21%20at%2011.03.50.png?alt=media\&token=82e4d36e-225e-4895-818c-e9dcf7655205)

#### Card

#### Divider

Creates a line that can be used to separate elements or content on your screen. You can change the color and thickness of the divider in the element's **Properties**.

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FUtXajpyXYJglM7wllTNN%2Fimage.png?alt=media&#x26;token=35a8678d-c425-4013-9505-6f4180847bab" alt=""><figcaption></figcaption></figure>

#### Image

Upload your own image with our image selector.&#x20;

* Set **Width** and **Height** using \
  \- Auto\
  \- Fill\
  \- Fixed , set amount of pixels\
  \- Flex, set fraction of the width of the screen. Is only applicable if you have multiple elements in a horizontal aligned container.
* **Background size** (Fit, Contain and Cover) will only have effect when both Width and Height are not set to Auto. \
  \- Fit will show the whole image\
  \- Contain will adjust the image to the set Height\
  \- Cover will adjust the image to fill the Width
* Is **Clickable** enabled will offer customers the option to open the image in a lightbox for additional zooming.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FZqiaoLvWxxjIrhFbX656%2Fimage.png?alt=media&#x26;token=ad308620-77db-4c8a-8545-3042a016f06b" alt=""><figcaption></figcaption></figure>

#### Link

Place a link in your screen.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2F7mIZyrTcyO3YWDkrHZnM%2FScreenshot%202023-03-22%20at%2015.25.45.png?alt=media&#x26;token=dc1d34bf-dfb8-4747-bc94-b8f0f66a9cf9" alt=""><figcaption></figcaption></figure>

Use the **Type** property to determine whether the link is shown as text or as a button. Use the **Title** property to create the text that is shown as a link (or as the text on the button). Set the **Link Type** to classify the link (and its resulting behaviour) as a Site, Email, or Phone. You can also choose whether the link opens in the app or externally.&#x20;

#### Icon

Allows you to place an icon in your screen from a preselected library of icons. Select the icon design from the dropdown menu, determine the icon's size, its color, and the label.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FoHsNuzkcO9NtxkKE6Sz2%2FScreenshot%202023-03-22%20at%2015.31.34.png?alt=media&#x26;token=d322da1f-94be-4b96-9f72-cc76152158a9" alt=""><figcaption><p>Icon element properties</p></figcaption></figure>

The dropdown menu for icons contains a vast array of searchable icon types and styles.

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FJmS4b0FjXns22qvqeZ3y%2FScreenshot%202023-03-22%20at%2015.31.45.png?alt=media&#x26;token=c8b97d22-181a-46d3-9c22-38e7e34a3c80" alt=""><figcaption><p>Icon library</p></figcaption></figure>

#### Map

Add a map to your screen.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FtT67XXawzAFs9MQBloTk%2FScreenshot%202023-03-28%20at%2013.34.45.png?alt=media&#x26;token=42752b0f-6c20-40e0-bb06-dd7c1a5ff07a" alt=""><figcaption></figcaption></figure>

You can add an **Address**, a custom **Marker Image**, a custom Location Label, you can toggle on or off the ability to zoom in the map, you can select the **Zoom level**, Fix the position of the map, and show the location of the app user.

#### Rating

#### Progress

#### QR Code

Adds a QR code to your screen. You can place text or a URL in the **Text** field.

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2Ffbt3hk0I12rqihRpt8LC%2FScreenshot%202023-03-22%20at%2016.52.17.png?alt=media&#x26;token=db0bcc7e-00ef-41c2-bda0-5d3da532149d" alt=""><figcaption></figcaption></figure>

#### Video

Allows you to place a video in your screen.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FVldVR4SUaFxxkktXPv98%2FScreenshot%202023-03-22%20at%2015.47.26.png?alt=media&#x26;token=c692ff9c-2a83-491c-b0b7-7ea005fa51cf" alt=""><figcaption></figcaption></figure>

In the properties, you can define the URL of the video, whether the video autoplays, whether the controls of the videos are shown, and whether the app can be shown full screen.&#x20;

#### iFrame

#### Simple Detail

### Text

All the text elements have settings to influence the font, color and size of the text. These are the default fonts to use to make your app look the same in every screen.\
For example a Headline element gives you the option to add a text , and it uses by default the Headline font which is set in the green Theme block. If you want to add more variation to your screen you have the option to choose another font style, change fontsize, fontcolor, Bold, Italics or alignment.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2Fg94FFSihAK0y9ZFWLqUA%2Fimage.png?alt=media&#x26;token=e5cd508e-62a3-42dc-afc8-84ba315299a0" alt=""><figcaption></figcaption></figure>

NOTE : We do advice you to mostly use the default options offered in the dropdown, to maintain uniformity in your app.&#x20;

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FiIMHRnQpqwbDclvjQloN%2Fimage.png?alt=media&#x26;token=4de0fcc1-e468-4965-b6ac-d080e9840cc5" alt=""><figcaption></figcaption></figure>

* Display
* Heading
* Title
* Body
* Label
* Rich text

### Buttons

Add a button to your screen and add Events to initiate an action. Set&#x20;

* Text
* layout
* Background of your button.

<figure><img src="https://2636455530-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F2wzy1sO41plYrfJfaAhN%2Fuploads%2FetKXrWDenWnXD09364Jr%2Fimage.png?alt=media&#x26;token=b8984d52-89d9-48f6-bc71-85843444a97e" alt=""><figcaption></figcaption></figure>

* **Primary button** uses the primary color as the backgroundcolor
* **Secondary button** uses the secondary color as the backgroundcolor
* **Action button** is shown as an overlay at the bottom of the screen and will always be visible.
