| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
How to Load an Image
You can add your own images to an application so that you can display company logos, icons, backgrounds and more. To do this;
- Go to the Repository → Application → Images.
- Click
.Insert excerpt _new _new nopanel true - PhixFlow opens the image properties, where you can upload the image; see Image Properties, below.
- Provide a name for the Image
- Click Browse
- Navigate to your image, select it and click the Open button.
- Click
.Insert excerpt _finish _finish nopanel true
How to Use an Image
- Open the properties for the component in which you want to use an image.
- In Styles tab → Style Settings → Background Image,
- select the image from the drop-down list
- Or click
to list the available images and drag one into the Background Image box.Insert excerpt _image_list _image_list nopanel true
- Set other options for the image. For example:
- background-repeat, no-repeat
- background-position, center
- Background Size, 100%
- Click
.Insert excerpt _finish _finish nopanel true
Setting Palette Item Icons.
| Expand | ||||||||
|---|---|---|---|---|---|---|---|---|
To use an image as an icon to represent the component in a palette:
For information about how to use an image stored on the PhixFlow server, see Using a URL to Display an Image. |
Setting the Size of an Image
| Anchor | ||||
|---|---|---|---|---|
|
Use the CSS Properties to size an image. For a background image, the background-size can be:
- auto: the background image is displayed in its original size.
- length: sets the width and height of the background image, for example, 20px 20px.
- The first value sets the width.
- The second value sets the height.
- If only one value is given, the second is set to 'auto'.
- percentage: sets the width and height of the background image in percent of the parent component, for example 100%.
- The first value sets the width
- The second value sets the height.
- If only one value is given, the second is set to 'auto'.
- cover: resize the background image to cover the entire container, even if it has to stretch the image or cut a little bit off.
- contain: resize the background image to make sure the image is fully visible.
- initial: sets this property to its default value.
- inherit: inherits this property from its parent component.
Getting an image to display correctly is a process of trial and error. The exact settings depend on the image size and how you want it to appear in your application. We recommend that you aim to make the image responsive on different screens using the options percentage, cover or contain. However, this can be ignored if you know your image will only be used in one form factor and you are having problems with it becoming distorted.
Example Image Configurations
Here are some possible locations for images, and suggestions for which options to use to control the image size.
Image location | background-size option to use | Details |
|---|---|---|
Area Background | contain | The image fills the area background. |
Grid Background | - | You cannot have an entire background for a grid. |
Application Logo in the menu | - | This defaults to 64px 64px and cannot be configured. We recommend you use square images. |
Grid Buttons and Icons | length or contain | Depending on the image, contain will fill the grid cell, but you cannot add padding. As grids are fixed widths and heights, you can use a fixed width to ensure the image displays correctly on different screens. Remember to apply the following Style properties:
Using 100% for the width and height ensures a button or icon fills the whole cell. This is good practice for action buttons, so that the user can click anywhere in the cell to trigger an action. |
Company Logo | - | This defaults to a height of 25px. It resizes horizontally to fill the available space. |
Company Logo | - | This defaults to a height of 100px. It resizes fit the size of the .svg image file. |
Buttons | length | Buttons usually have a fixed height. To ensure the button has the correct proportions, use a fixed length or width. |
Mouse-over buttons | length | Use the same background size and position settings as the original image. When a user moves their mouse pointer over, the image overlays the underlying image. You may need to add a background colour to the image, to ensure it covers the underlying image. For buttons, the image will be added to an area which completely covers the button and has absolute positioning:
For a mouse-over button to work, remember to set the additional CSS Properties:
|
| Anchor | ||||
|---|---|---|---|---|
|
Image Properties
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
| Insert excerpt | ||||||||
|---|---|---|---|---|---|---|---|---|
|
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
Basic Settings
| Field | Description |
|---|---|
| Name | Enter a name for the image. |
| Browse | Click the Browse button to open a file explorer window where you can navigate to the image you want to upload. PhixFlow displays a thumbnail of the uploaded image. |
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|