Multiple labels behaviour with Match All
- Nirosan (Unlicensed)
- Praveena Manohar
- Smita Nair
Beginning with Visibility 5.0.15, when using multiple labels within the Labels parameter with Match Using set to all, the Show-If and Hide-If macros will check if the labels within the parameter are all present on a given page's labels.
Take a look at the following table for more examples:
Match Using | Show-If/Hide-If Labels parameter value | Page Labels | Show-If | Hide-If | Notes |
|---|---|---|---|---|---|
all | label-one | label-one | ✅ | ❌ | Matches. |
all | label-one | label-one, label-two | ✅ | ❌ | Matches since label-one is on the page's labels. The extra-label label-two on the page does not affect the outcome. |
all | label-two | label-one, label-two | ✅ | ❌ | Matches since label-two is on the page's labels. The extra-label label-one on the page does not affect the outcome. |
all | label-one, label-two | label-one | ❌ | ✅ | Does not match since label-two is missing from the page's labels. Note the labels in the parameter must all be on the page's labels. |
all | label-one, label-two | label-one, label-two | ✅ | ❌ | Matches since both label-one and label-two are on the page's labels. |
✅ - the contents of the macro will be shown/visible
❌ - the contents of the macro will be hidden/invisible
How will this affect my pages?
In Visibility 5.0.10 - 5.0.14, when using multiple labels within the Labels parameter with Match Using set to all, the Show-If and Hide-If macros will check if the labels on a given page are all present within the parameter. This may sound the same, but the semantic difference may affect your Show-If and Hide-If macros.
The table below compares the behavior for Visibility 5.0.10 - 5.0.14 versus Visibility 5.0.15:
Match Using | Show-If/Hide-If Labels parameter value | Page Labels | Show-If (5.0.14) | Show-If (5.0.15) | Notes |
|---|---|---|---|---|---|
all | label-one | label-one | ✅ | ✅ | Matches. |
all | label-one | label-one, label-two | ❌ | ✅ | Matches in 5.0.15 since all the labels in the macro exist on the page's label. |
all | label-two | label-one, label-two | ❌ | ✅ | Matches in 5.0.15 since all the labels in the macro exist on the page's label. |
all | label-one, label-two | label-one | ✅ | ❌ | Does not match in 5.0.15 since label-two is missing from the page's labels. Note the labels in the parameter must all be on the page's labels. |
all | label-one, label-two | label-one, label-two | ✅ | ✅ | Matches since both label-one and label-two are on the page's labels. |
all | label-one, label-two, label-three | label-one, label-two | ✅ | ❌ | Does not match in 5.0.15 since label three is missing from the page's labels. Note the labels in the parameter must all be on the page's labels. |
To specify labels to exclude with Match Using set to any, see the Label parameter matrix.