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.
• Pressing Up Arrow or Down Arrow when another component is already selected to move the selection to the component above or below the currently selected component.¹
• Pressing Up Arrow when the cursor is placed at the beginning of a text component to move the selection to the previous component.¹
• Pressing Down Arrow when the cursor is placed at the end of a text component to move the selection to the next component¹.
• Pressing Ctrl (Windows) or Cmd (macOS) plus one of the following:¹
• Left Arrow to move to the beginning of the component.
• Right Arrow to move to the end of the component.
• Up Arrow to move to the top component.
• Down Arrow to move to the bottom component.

¹ Requires Studio 11.81 or higher.

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):

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 allows this content to be customized 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.