How to override link openning by clicking instead of Command Click?

Hi

In DocumentEditor, the default action to open a link is Command + Click. How do I override this and let the user to open a link by just clicking on it?

Thank you!


23 Replies 1 reply marked as answer

MA Mohammed Affan Saqib Hussain Syncfusion Team August 6, 2025 01:37 PM UTC

Hi Mengyang He,

Document Editor provides a property 'useCtrlClickToFollowHyperlink' which can be set to false to open the hyperlink on click. We have attached a sample for your reference.

Samplehttps://stackblitz.com/edit/react-b4keetux-y57gj5on?file=index.js

In the latest version 30.1.42, we are currently facing an issue with the hyperlink opening. We are currently validating the issue and will provide more details by 08 August 2025.

Regards,

Mohammed Affan C


Marked as answer

MH Mengyang He replied to Mohammed Affan Saqib Hussain August 6, 2025 04:31 PM UTC

Hi Mohammed,

Thank you for your reply.

I am able to enable hyperlink opening by clicking directly on the link. However, I noticed that the behavior is not always stable. Is this the same issue you are currently experiencing?

Currently, I handle hyperlink clicks using requestNavigate in my code as follows:

const docEditor = editorRef.current.documentEditor;
docEditor.useCtrlClickToFollowHyperlink = false;
docEditor.requestNavigate = (args: RequestNavigateEventArgs) => {
    console.log('link clicked', args);
    args.isHandled = true;
    handleHyperlinkClick(args.navigationLink);
};


However, I observed that the requestNavigate event is triggered inconsistently: sometimes it fires, and sometimes it does not, even for the same link and document content.


Is this the same issue you are encountering with both version 30.1.42 and version 29.2.7? I am currently using DocumentEditor 29.2.7 with the following packages:

"@syncfusion/ej2-react-buttons": "^30.1.37",
"@syncfusion/ej2-react-documenteditor": "29.2.7",
"@syncfusion/ej2-react-pdfviewer": "29.2.7"


MA Mohammed Affan Saqib Hussain Syncfusion Team August 7, 2025 02:55 PM UTC

Hi Mengyang He,

We tried to reproduce the reported issue in version 29.2.7 and in the latest version 30.2.4, but the requestNavigate event was triggered properly in our testing. We have attached a video for your reference. Additionally we have also attached the sample we used to test the issue.

Sample https://stackblitz.com/edit/react-b4keetux-uxrp6bfp?file=index.js

We are glad to announce that Essential Studio® 2025 Volume 2 SP Release v30.2.4 has been rolled out and is available for download at the following link:
https://www.syncfusion.com/forums/197303/essential-studio-2025-volume-2-service-pack-release-v30-2-4-is-available-for-download

In this release, the reported hyperlink opening issue has been resolved. We recommend that you upgrade to the latest version and check the issue. If the issue persists, kindly share the following environment details of your machine:
1. Browser version
2. Operating System (OS)

This will help us replicate the issue in a similar environment and investigate further.

Regards,

Mohammed Affan C


Attachment: Request_Navigate_Video_Demo_faed5640.zip


MH Mengyang He replied to Mohammed Affan Saqib Hussain August 7, 2025 07:15 PM UTC

Hi Mohammed,

Thanks for the reply.

I was able to fix the issue. The other issue I am having right now is I have some tables in the SFDT that I want to display in the DocumentEditor, but I found out the distance between the table content and table margin is too close:
Image_6114_1754594039119

How do I adjust the default table margin for each table? I tried the following code according to your documentation, but it actually didn't work:

useEffect(() => {

      if (!editorRef.current?.documentEditor) return;

      const docEditor = editorRef.current.documentEditor;

      const selection = docEditor.selection as any;

      if (selection.isInTable && selection.tableFormat) {

        const tf = selection.tableFormat;

        tf.leftMargin = 5.4;

        tf.rightMargin = 5.4;

        tf.topMargin = 5.4;

        tf.bottomMargin = 5.4;

      }

    }, []);



MA Mohammed Affan Saqib Hussain Syncfusion Team August 8, 2025 12:38 PM UTC

Hi Mengyang He,

We attempted to replicate the reported issue regarding the table margin adjustment for the selected table; however, the table margin was updated correctly.

For your reference, we have attached a video along with a sample. Please use the provided sample to reproduce the issue. If the issue continues to occur, we kindly request you to share the sample used on your end or modify the attached sample to reproduce the issue and send it back to us. This will enable us to conduct further analysis and provide you with an appropriate solution as soon as possible.

Sample https://stackblitz.com/edit/react-g3otfrkc-thyrhxwe?file=index.js


Documentationhttps://ej2.syncfusion.com/react/documentation/api/document-editor/selectionTableFormat/

Regards,

Mohammed Affan C


Attachment: Table_Margin_setting_video_demo_d7460530.zip


VB Viller blender February 11, 2026 07:12 PM UTC

We recently used it in a Alert platform to create a clean, interactive dashboard for managing listings and client communications. It was part of a broader system we built for GTA SA APK , and Syncfusion made it much easier to handle the UI without building everything from scratch. Definitely recommend it for similar business-focused tools!




CA Chrispine Agunja Imbo Syncfusion Team February 12, 2026 07:44 AM UTC

Hi Viller,

Thank you so much for your kind words! We’re glad to hear that Syncfusion helped streamline your dashboard development. We truly appreciate your support and look forward to continuing to serve you.

Regards,

Chris




OL Oliver April 23, 2026 05:09 AM UTC

You can handle this by setting useCtrlClickToFollowHyperlink = false, so links open on a normal click. For more control, the requestNavigate event is a solid option since it lets you customize the behavior further. In a way, it’s similar to how GTA San Andreas Mod APK lets users tweak controls and gameplay—small changes in interaction can make a big difference in overall user experience.



SN Saran Nagaraj Syncfusion Team April 28, 2026 01:20 PM UTC

Hi Oliver,

Thanks for sharing the update. We appreciate you taking the time to add this.


Regards,
Saran N



GI Gossip Idea May 4, 2026 06:35 AM UTC

In most rich-text or document editing environments like DocumentEditor, the default “Command + Click” behavior is intentionally used to prevent accidental navigation while editing content. To change this to a single-click behavior, you usually need to modify the editor’s link-handling configuration rather than the browser itself.

If you’re using a customizable editor (like ProseMirror, TipTap, or similar), look for options such as handleClick, linkClickHandler, or “editable link behavior” settings. You may need to override the default event listener and explicitly enable onClick navigation when the editor is in read/view mode (and disable it during edit mode to avoid interference).

Also, always ensure accessibility considerations—single-click links in edit mode can easily disrupt user workflow.

I saw a similar discussion with practical implementation examples on Manoknapulaapp, which breaks down how link behaviors are handled in different editor frameworks and might help you adjust it properly



DB Diane Bradley May 7, 2026 07:44 AM UTC

Hey everyone! I found the discussion on overriding link behavior super insightful. I'm curious—what are some practical use cases you've encountered when implementing this in your projects? Thanks for sharing your knowledge!
Attachment: Table_Margin_setting_video_demo_d7460530.zip  phrazle



SN Saran Nagaraj Syncfusion Team May 11, 2026 10:33 AM UTC

Hi Diane Bradley,

We have analyzed the provided details and video references.

 

Regarding "Table Margin Updation"

The video demonstrates updating table content spacing using a button click through Document Editor properties. As observed, the table property values are updating correctly, which is the expected behavior. Could you please clarify if you are experiencing any specific issue in this scenario?

 

Regarding "Hyperlink Accessing"

As mentioned in our earlier response, You can achieve single-click hyperlink navigation by setting useCtrlClickToFollowHyperlink = false, which allows links to open on a normal click. For more advanced customization, you can use the requestNavigate event to control navigation behavior based on your requirements.

 

Practical Uses of Single-Click Hyperlink

  • Suitable for read-only or preview modes, where quick navigation is expected
  • Enhances usability in document viewer scenarios (e.g., reports, knowledge articles)
  • Provides a more intuitive user experience without requiring keyboard interaction

 

If you have a specific use case or need further clarification on single-click hyperlink behavior, please share additional details. We will analyze your requirements and provide further guidance.


Regards,
Saran N



GI Gossip Idea replied to Mohammed Affan Saqib Hussain May 23, 2026 04:32 AM UTC

Hi Mohammed Affan C,

Thank you for the detailed response and for sharing both the StackBlitz sample and the latest release update.

I tested the provided sample:
https://stackblitz.com/edit/react-b4keetux-uxrp6bfp?file=index.js

and also reviewed the new release notes here:
https://www.syncfusion.com/forums/197303/essential-studio-2025-volume-2-service-pack-release-v30-2-4-is-available-for-download /truecallarapk/

After upgrading to v30.2.4, the hyperlink navigation behavior appears much more stable compared to the earlier build. It seems the requestNavigate event is now triggering correctly in most scenarios.

One thing I noticed during testing is that browser-specific caching or extension conflicts can sometimes affect hyperlink handling in React-based applications. It may also help other developers if they clear cached assets before re-testing after the upgrade.

For anyone still troubleshooting similar navigation-related issues, reproducing the behavior with the shared StackBlitz sample is definitely a good starting point before checking local environment configurations.



MU Muslim May 24, 2026 02:41 AM UTC

    You can usually override this behavior by handling the link-click event inside the DocumentEditor and disabling the default modifier-key requirement. Depending on the framework you’re using, look for settings related to hyperlink navigation or mouse event handlers.

    In some editors, enabling direct link interaction can interfere with normal text selection, so it’s worth testing both editing and read-only modes. Checking the editor’s API documentation for hyperlink click events or custom command handling should help you implement single-click opening cleanly.

  • 


MU Muslim May 24, 2026 02:41 AM UTC

    You can usually override this behavior by handling the link-click event inside the DocumentEditor and disabling the default modifier-key requirement. Depending on the framework you’re using, look for settings related to hyperlink navigation or mouse event handlers.

    In some editors, enabling direct link interaction can interfere with normal text selection, so it’s worth testing both editing and read-only modes. Checking the editor’s API documentation for hyperlink click events or custom command handling should help you implement single-click opening cleanly.

  • 


SS Sujitha Siva Syncfusion Team May 26, 2026 11:08 AM UTC

Hi,

As mentioned in our earlier updates, you can use the requestNavigate event to customize the hyperlink navigation behavior in your application. Additionally, in the Document Editor, customizing the hyperlink navigation functionality works properly and does not override normal text interaction.

 

We have shared a video for reference. In this video, we demonstrate how hyperlinks work with direct Click, as well as in both read-only and edit modes.

 

If you are still facing any issues with hyperlink behavior, we have shared a sample for your reference. Kindly try to replicate the issue using this sample and share the details with us.

 

Sample: Zaihggcn (duplicated) - StackBlitz


Regards,

Sujitha S


Attachment: Video_73854f53.zip


GI Gossip Idea July 28, 2026 05:43 AM UTC

To change this behavior, you usually need to intercept the document's click event or handle the specific hyperlink click handler provided by your editor's API. Most rich text editor controls (like Syncfusion's DocumentEditor) have a hyperlinkClick or selectionChange event where you can call preventDefault() on the default event and programmatically open the URL in a new tab upon a standard single click.

Overriding default UI shortcuts and link behaviors can definitely get tricky when managing custom navigation logic. Whenever our developer team needs to pick random test URLs or set up arbitrary redirect targets during QA testing, we usually drop various dummy links into a quick decision tool like https://www.syncfusion.com/forums/197303/essential-studio-2025-volume-2-service-pack-release-v30-2-4-is-available-for-download/ https://ruletaaleatoriagratis.es/ to test different browser click behaviors efficiently!

Hope that helps point you in the right direction for custom event handling!




PO podcast July 28, 2026 05:48 PM UTC

Solid solution — setting useCtrlClickToFollowHyperlink = false does the job. When our dev team can't agree on which test URL or redirect scenario to QA first, we use Kolo Fortuny online to pick one at random. Keeps testing unbiased. https://kolofortunygra.pl/



PO podcast July 28, 2026 05:51 PM UTC

Great tip on the requestNavigate event — I had the same instability until the latest update. For randomizing test cases during link-behavior QA, we spin ruleta aleatoria online. Quick and fair. 



PO podcast July 28, 2026 05:51 PM UTC

Nice fix — disabling the modifier key requirement makes sense for read-only views. When I'm testing link behaviors across different document formats, I use the DixMax app to aggregate and compare results in one place. Streamlines the process.



PO podcast July 28, 2026 05:52 PM UTC

This thread saved me time — the StackBlitz sample was exactly what I needed. For anyone building a library of editor customizations, hackdelta has some solid organization tips that pair well with tracking event overrides.



PO podcast July 28, 2026 05:52 PM UTC

Helpful breakdown — the sample and video made the override clear. For anyone managing multiple editor customizations, hackdelta has some useful references for staying organized with code snippets and configurations.



TB Toca Boca replied to Gossip Idea August 3, 2026 10:50 AM UTC

If you want to override the default Command + Click behavior in DocumentEditor so that links open on a standard single click, you need to intercept the select or requestNavigate event (depending on the exact UI framework you're using) and disable the key-modifier check.

In most implementations, you can listen for the click event on hyperlink elements within the editor container, call e.preventDefault(), and manually trigger window.open(). For example, if you're testing anchor navigation for external web resources like https://www.syncfusion.com/forums/197303/essential-studio-2025-volume-2-service-pack-release-v30-2-4-is-available-for-download/ Toca Boca MOD APK, overriding that handler ensures users get instant single-click redirection without needing keyboard shortcuts.

Check your editor's event listener settings for isCommandKeyPressed or ctrlKey flags and set those event checks to false in your custom click handler!


Loader.
Up arrow icon