Working with the components of a Digital article in Studio

When looking at the way an article is set up, you can see that it consists of different parts: it will have a header, maybe a sub header, multiple paragraphs, perhaps one or more images with or without captions, and so on.

In a Digital article, each of these parts is represented by a 'component'. You will construct your story by adding all those components that your story needs by using the Digital editor.

In this article here, we describe how to work with the components in a Digital article.

Notes:  The information below describes the default set of components in Studio. Depending on how the system is configured, the components in your installation of Studio may be different than what is shown here. For detailed information about each component, see The components of a Digital article in Studio.

When working with components, you can:

• Add components
• Delete components
• Select multiple components
• Delete components
• Rearrange components
• Copy and paste components
• Change components
• Control how a component should look and behave

Adding components

When creating a new article, it will already contain components. Which components these are typically depends on the template that the article is based on. When needed, additional components can be added.

Note: Depending on the way the system is set up by the administrator, it may not be possible to add (certain) components.

To add a component, hover your mouse over an area between two existing components where you want to add the new component. Click the orange plus sign that appears. A Component window is shown containing various components, grouped by type. Find the component that you want to use and click it to add it to the article.

Figure: Adding a Slideshow component to the story.

Deleting components

To delete one or more components, do one of the following:

• Hover the mouse pointer over the component and click the Trash Can icon. When multiple components are selected, clicking the Trash Can icon for one of the selected components will delete all selected components.

• In the Properties panel, click Delete.

Selecting components

Components in an article can be selected so that they can be worked on in a particular way. The method of selecting and the actions that can be performed depends on the type of component that is selected and if a single component or multiple components are selected. When components are copied, the newly created components can be automatically selected as well.

Single components

Selecting a single component is done by doing the following:

• Clicking the component.
• Placing the text cursor in a component that can hold text.
• Using one of the following keyboard shortcuts (Requires Studio 11.81 or higher):

Key	Action
Up Arrow	Move the selection from the component that currently has the selection to the component above it.
Down Arrow	Move the selection from the component that currently has the selection to the component below it.
Ctrl+Left Arrow (Windows) Cmd+Left Arrow (macOS)	Move the selection to the beginning of the component.
Ctrl+Right Arrow (Windows) Cmd+Right Arrow (macOS)	Move the selection to the end of the component.
Ctrl+Up Arrow (Windows) Cmd+Up Arrow (macOS)	Move the selection to the top of the component.
Ctrl+Down Arrow (Windows) Cmd+Down Arrow (macOS)	Move the selection to the bottom of the component.

You can tell that a component is selected by the following:

• A blue border around the component.

• The Properties panel, showing the properties that can be applied to the selected component and the actions that can be performed on it.

Notes:  For Studio 11.82 or higher: No blue border is shown for components that can hold text (such as a Body component). For components that contain multiple fields (such as a Hero, Standfirst, or Image), the blue border is only shown for the component itself, not for each individual field within the component. For Containers, a blue border is shown when the Container itself or one of its nested components is selected. For Studio 11.81: No blue border is shown for components that can hold text (such as a Body component). For components that contain multiple fields (such as a Hero, Container, Standfirst, or Image), the blue border is only shown for the component itself, not for each individual field within the component.

Tip: See how to check the version of Studio that is installed.

Multiple components

Info: This feature requires Studio 11.81 or higher (see how to check the version of Studio that is installed).

Multiple components can be selected to quickly perform the same action on these components:

• Delete
• Move

Note: Other actions such as changing the properties or applying styling are not yet possible.

Selecting multiple components can be done by doing one of the following:

• To select individual components: select one component and click another component while holding down Ctrl (Windows) or Cmd (macOS).
• To select a range of components: select one component and click another component while holding down Shift.
• With at least one component selected, press Shift+Up Arrow or Shift+Down Arrow.
• Use a combination of the above mentioned methods.

Tip: Deselecting components can be done by using the same methods as for selecting components.

You can tell that multiple components are selected by the following:

• The components have a blue fill except Container components and components that contain video, social media, or embedded content; these will have a blue border.
• The Properties panel shows the properties that can be applied to the selected components and the actions that can be performed on them.

Figure: The selection of multiple components is indicated by a blue fill or border, and the state of the Properties panel.

Automatic selection

Info: This feature requires Studio 11.85 or higher (see how to check the version of Studio that is installed).

When one or more components are selected and subsequently copied by moving them while holding the Alt key (see Copying components), the newly created components are automatically selected.

Example: Components A, B, and C are selected. When moving them while holding the Alt key, components D, E, and F are created and automatically selected.

Hover states

When hovering the mouse pointer over a component, actions become available and outlines become visible:

• A toolbar appears containing the following icons:

• A Move icon for moving the currently selected components (requires Studio 11.81 or higher. See how to check the version of Studio that is installed).

• A Trash Can icon for deleting the selected components.

• A gray border appears around the component. (Requires Studio 11.81 or higher. See how to check the version of Studio that is installed). Does not apply to components that contain a single field that can hold text such as a Body component.)

• A label with the component name appears for Container components and components that contain video, social media, or embedded content.

Figure: When hovering the mouse pointer over a component, a gray border and a toolbar appears.

Moving components

To move one or more components to a different position, do one of the following:

To move a single component:

• Click and hold the component and drag it to the position where you want to place it.
• Hover the mouse pointer over the component, click and hold the Move icon, and drag it to the position where you want to place it.

To move multiple components:

• Select the components, hover the mouse pointer over one of the components, click and hold the Move icon, and drag it to the position where you want to place it. All selected components are now moved.

Notes: A Container component cannot be moved into a nested Container component. Whenever a component cannot be placed on the current area over which the mouse pointer is hovered, the label that is shown is colored red. When moving one or more components while pressing Alt, the components are copied rather than moved. (Requires Studio 11.84 or higher. See how to check the version of Studio that is installed).

Copying components

When working on an article, it is very possible that the content that needs to be added already exists. This could be in another component in the same article or in a different Digital article — either an article available in Studio or an article archived in Assets.

Think of a slide show, an image with a caption, a quote, a particular paragraph of text, and so on.

Components or their content can be copied and pasted for reuse elsewhere. The processes for doing this are described below.

Copying components in the same article

In this scenario, one or more components are copied in the article that is currently being worked on.

The exact working of the feature depends on the version of Studio used (see how to check the version of Studio that is installed).

Info: The following information applies to Studio 11.88 and later. For earlier versions, see the end of this section.

Components can be copied by using keyboard shortcuts or by dragging them.

Using keyboard shortcuts to copy, cut, and paste

In this method, keyboard shortcuts are used to copy, cut, and paste components or the content of components.

Copying and cutting

The following keyboard shortcuts can be used:

• For copying: Cmd+C (macOS) or Ctrl+C (Windows)
• For cutting: Cmd+X (macOS) or Ctrl+X (Windows)

The following table shows the different scenarios and their result when the shortcut for copying or cutting is used:

#	Scenario	Result
1	The text cursor is placed in a component with text, no text is selected.	The whole component in which the cursor is placed is copied or cut.
2	Text in a component is selected.	The selected text is copied or cut.
3	Multiple components are selected.	All components are copied or cut.

Pasting

The following keyboard shortcut can be used:

• Windows: Ctrl+V
• macOS: Cmd+V

The position at which the copied or cut content needs to be pasted can be specified as follows:

• By placing the text cursor in some text.
• By hovering the mouse pointer over an area between 2 components so that the +-button for adding a component appears.
• By opening the Component window for adding a new component.

Note: Pasting is not possible when one or more components are selected.

The following table shows the different scenarios and their result when the shortcut for pasting is used:

#	Scenario	Result
1	The text cursor is placed within text and selected text was copied or cut.	The text is added at the cursor position, including any comments that it contains.
2	The text cursor is placed within text and one or more components were copied or cut.	When the cursor is at the start of the component: the components are added above the component in which the cursor is placed. When the cursor is at the end of the component: the components are added below the component in which the cursor is placed. When the cursor is not at the start or end of the component: the component in which the cursor is placed is split into two components at the cursor position and the components are added in between them. Note: Any images that the pasted components contain are not duplicated.
3	The +-button for adding a component is visible. The Component window for adding a new component is opened.	When selected text was copied or cut: the text is added in a new component at that position. When one or more components were copied or cut: the components are added at that position. Note: For this to work, the text cursor should not also be positioned within some text somewhere in the article, else scenario 2 takes place.
4	A Container is copied or cut and pasted inside a nested Container.	This cannot be done, it is not possible to add a Container which is already part of another Container.

Dragging components

Select one or more components and drag them (see Moving components) while holding the Alt key. Drop the components in the position where they need to be placed and release the Alt key.

Note: Any images that the pasted components contain are not duplicated.

The selection of components then behaves as follows:

• When one or more components are selected and subsequently copied by moving them while holding the Alt key, the newly created components are automatically selected.

Example: Components A, B, and C are selected. When moving them while holding the Alt key, components D, E, and F are created and automatically selected.

• When no components are selected and a component is copied by moving it while holding the Alt key, the copied component is not selected.

• When one or more components are selected and a component that is not selected is copied by moving it while holding the Alt key, the components that were selected are still selected.

Example: Components A, B, and C are selected. When moving component D while holding the Alt key, component E is created but components A, B, and C are still selected.

Copying components in earlier versions of Studio:

Copying components from another article

Components that exist in another article can be copied to the article that is currently being worked on. The article that the component is copied from could be an article in Studio or an article that is archived in WoodWing Assets.

Changing the component type

Sometimes a component of a certain type needs to be changed to a different type.

Examples: When working on an article and pressing Enter, a new component is created — in most cases a body component. However, you want the new component to be of a different type such as a subtitle or a quote. The Digital article that you are working on was converted from a print article. To make it ready for publishing it digitally, some components need to be changed to a different type.

Step 1. Select the component or (when possible) place the cursor inside the component.

Step 2. Do one of the following:

• Access the Properties panel and from the Change Component list, choose a different component.
• Use a keyboard shortcut. The available keyboard shortcuts are shown in the Change Component list in the Properties panel.

Note: The Change Component list in the Properties panel shows different components to choose from depending on the component type that you want to change. Keyboard shortcuts are defined as part of configuring Component Sets.

Figure: The Change Component option in the Properties panel.

Controlling how a component should look and behave

Using the properties of a component, you can control how a component should look and how it should behave.

Properties that can be controlled include the order in which images in a slideshow appear, the alignment of an image, the style to apply, line spacing , and so on.

Setting the properties

To set the properties for a component, select it and click the Properties icon in the toolbar on the right.

Figure: A slideshow and its properties.

Applying a Style variant to a component

When a particular component for a particular output always needs to be styled in a particular way, a Style variant can be created for it.

A Style variant is a collection of style settings that are stored for repeated use. This makes it possible to apply these settings in one single action instead of having to set these manually.

To apply a Style variant to a component, simply choose it from the Style variant list in the Properties panel for that component.

Editing Interactive components

An Interactive component displays content that is hosted on the Internet somewhere, such as a Google Map, a video, a poll, a quiz, and so on, and also makes it possible to customize this content in the Digital editor.

Example: A basic Google Map could be made available to which one or more locations can be added, the map settings changed, and so on.

To edit an Interactive component, access the Properties for the component and under 'Configuration', click 'Edit'.

A window will appear in which you can change the settings for that component.

Revisions

• 1 April 2021: Updated section 'Copying components' with information about using keyboard shortcuts in Studio 11.88.
• 4 March 2021: Updated section 'Copying components' with information about duplicating images in Studio 11.86.
• 17 February 2021: Added section 'Automatic selection' to section 'Selecting components'.
• 17 February 2021: Updated section 'Copying components' with information about the selection behavior in Studio 11.85.
• 5 February 2021: Updated section 'Moving components' with information about Alt-dragging components.
• 5 February 2021: Updated section 'Copying components' with information about copying components from the same article.