Skip to content

Commit 820ac3f

Browse files
committed
Document layout argument for attribute value macros
Covers the singleline/multiline macro argument, the new targetVersions attribute and the deprecated version attribute in the WYSIWYG guide.
1 parent 669e9a3 commit 820ac3f

1 file changed

Lines changed: 14 additions & 1 deletion

File tree

docs/user-guide/wysiwyg/README.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -213,6 +213,18 @@ Example:
213213

214214
**Linking to the current project's status**: `projectValue:status`
215215

216+
### Controlling the layout of multi-value attributes
217+
218+
Attributes that hold multiple values (for example target versions or multi-select custom fields) render one value per line in the application and comma-separated in PDF exports. Append a layout argument to the macro to choose a layout explicitly:
219+
220+
- `workPackageValue:1234:targetVersions:multiline` renders one value per line
221+
- `workPackageValue:1234:targetVersions:singleline` renders all values on a single line, comma-separated
222+
223+
The layout argument also works with custom fields (`workPackageValue:1234:"My custom field":singleline`), with project attributes (`projectValue:...`) and with relative references (`workPackageValue:targetVersions:singleline`).
224+
225+
> [!NOTE]
226+
> The deprecated `version` attribute renders the work package's target versions on a single line by default.
227+
216228
### Embedding attribute help texts
217229

218230
You can also embed attribute values and [their help texts](../../system-admin-guide/attribute-help-texts/) by using `workPackageLabel` or `projectLabel`.
@@ -255,7 +267,8 @@ where `1234` stands for the [work package ID](../work-packages).
255267
| Start date | `workPackageValue:1234:startDate` |
256268
| Status | `workPackageValue:1234:status` |
257269
| Subject / Title | `workPackageValue:1234:subject` |
258-
| Version | `workPackageValue:1234:version` |
270+
| Target versions | `workPackageValue:1234:targetVersions` |
271+
| Version _(deprecated)_ | `workPackageValue:1234:version` |
259272
| Work | `workPackageValue:8415:estimatedTime` |
260273
| Work package type | `workPackageValue:1234:type` |
261274

0 commit comments

Comments
 (0)