Skip to content

feat(design-system, web-pkg): add explicit explanation to enable/disable sync functionality to avoid confusing the user#13486

Open
mzner wants to merge 1 commit intomasterfrom
feat/OCISDEV-133/disable-enable-sync-confused-users-who-only-use-web
Open

feat(design-system, web-pkg): add explicit explanation to enable/disable sync functionality to avoid confusing the user#13486
mzner wants to merge 1 commit intomasterfrom
feat/OCISDEV-133/disable-enable-sync-confused-users-who-only-use-web

Conversation

@mzner
Copy link
Contributor

@mzner mzner commented Jan 16, 2026

add explicit explanation to enable/disable sync functionality to avoid confusing the user

  • add tooltip function to Action interface
  • remove aria-label when aria-label value is null so that it does not show in the html with empty value

Description

Related Issue

Motivation and Context

How Has This Been Tested?

  • test environment:
  • test case 1:
  • test case 2:
  • ...

Screenshots (if appropriate):

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Technical debt
  • Tests
  • Documentation
  • Maintenance (e.g. dependency updates or tooling)

Open tasks:

  • ...

…ble sync functionality to avoid confusing the user

 - add tooltip function to Action interface
 - remove aria-label when aria-label value is null so that it does not show in the html with empty value
@mzner mzner requested a review from LukasHirt January 16, 2026 10:21
@update-docs
Copy link

update-docs bot commented Jan 16, 2026

Thanks for opening this pull request! The maintainers of this repository would appreciate it if you would create a changelog item based on your changes.

tooltip: () =>
$pgettext(
'Explanation tooltip for the enable sync action in files shared with me and spaces',
'Only affects desktop and mobile clients. You can toggle this setting here, but it will only take effect on those platforms.'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Best to check with @DeepDiver1975 whether mobile clients are really affected or if it's only desktop...

tooltip: () =>
$pgettext(
'Explanation tooltip for the enable sync action in files shared with me and spaces',
'Only affects desktop and mobile clients. You can toggle this setting here, but it will only take effect on those platforms.'
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What would you say about being a bit more explicite what the settings actually do? Then maybe the mention that it does not affect web client might be redundant because it might be clear enough from the functionality description.

/>
</oc-button>
<span :id="uniqueId" class="oc-invisible-sr">
{{ tooltipText }}
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Won't this result in the action label being read twice in case there is no custom tooltip?


const tooltipText = computed<string>(() => {
if (action?.tooltip) {
return `${action.label(actionOptions)} - ${action.tooltip(actionOptions)}`
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I wonder whether we need to include the action label here or if we can rely only on the tooltip...

@sonarqubecloud
Copy link

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Disable/enable sync confudsed users who only use web

2 participants