kibana/docs/canvas/canvas-edit-workpads.asciidoc
Kaarina Tungseth bdceec1b39
[DOCS] Updates Canvas images for 7.14 (#106424) (#106740)
* [DOCS] Updates Canvas images for 7.14

* Fixes refresh image size
2021-07-26 11:29:41 -04:00

135 lines
4 KiB
Plaintext

[role="xpack"]
[[edit-workpads]]
== Edit workpads
To create the look and feel that you want, apply format settings to the entire workpad, or individual elements.
[float]
[[create-variables]]
=== Create variables
When you frequently use copy and paste, create variables to easily reuse strings and patterns. For example, when you clone a large workpad and need to connect your elements to a new index, use variables to update
each element instead of updating them manually.
. Create the variables.
.. Expand the *Variables* options.
.. Click *Add a variable*.
.. Specify the variable options, then click *Save changes*.
. Apply the variable.
.. Copy the variable.
.. Select the element you want to change, then open the expression editor.
.. Paste the variable.
For example, to change the index pattern for a set of charts:
. Specify the variable options.
+
[role="screenshot"]
image::images/specify_variable_syntax.png[Variable syntax options]
+
. Copy the variable, then apply it to each element you want to update in the *Expression editor*.
+
[role="screenshot"]
image::images/copy_variable_syntax.png[Copied variable syntax pasted in the Expression editor]
[float]
[[apply-changes-to-the-entire-workpad]]
=== Apply changes to the entire workpad
With stylesheets, you can change the look of the entire workpad, including fonts, colors, layout, and more.
To get started, enter the changes you want to make in the *Global CSS overrides* text editor, then click *Apply stylesheet*.
For example, to change the background for the entire workpad, enter:
[source,text]
--------------------------------------------------
.canvasPage {
background-color: #3990e6;
}
--------------------------------------------------
[float]
[[change-the-element-settings]]
=== Change the element settings
Element settings enable you to change the display options at the element level. For example, use the element settings to change the dimensions, style, or location of an element.
[float]
[[change-the-display-options]]
==== Change the display options
Choose the display options for your elements. The options available depend on the element you select.
To change the element display options, click *Display*, then make your changes in the editor.
To use CSS overrides:
. Click *+* next to *Element style*, then select *CSS*.
. In the *CSS* text editor, enter the changes you want to make, then click *Apply stylesheet*.
For example, to center an element, enter:
[source,text]
--------------------------------------------------
.canvasRenderEl h1 {
text.align: center;
}
--------------------------------------------------
[float]
[[clone-elements]]
==== Clone elements
To use an element with the same functionality and appearance in multiple places, clone the element.
Select the element, then click *Edit > Clone*.
[float]
[[move-and-resize-elements]]
==== Move and resize elements
Canvas provides you with many options to move and resize the elements on your workpad.
* To move elements, click and hold the element, then drag to the new location.
* To move elements by 1 pixel, select the element, press and hold Shift, then use your arrow keys.
* To move elements by 10 pixels, select the element, then use your arrow keys.
* To resize elements, click and drag the resize handles to the new dimensions.
[float]
[[edit-elements]]
==== Edit elements
The element editing options allow you to arrange and organize the elements on your workpad page.
To align two or more elements:
. Press and hold Shift, then select the elements you want to align.
. Click *Edit > Alignment*, then select the alignment option.
To distribute three or more elements:
. Press and hold Shift, then select the elements you want to distribute.
. Click *Edit > Distribution*, then select the distribution option.
To reorder elements:
. Select the element you want to reorder.
. Click *Edit > Order*, then select the order option.
[float]
[[delete-elements]]
==== Delete elements
When you no longer need an element, delete it from your workpad.
. Select the element you want to delete.
. Click *Edit > Delete*.