Fix Auto-Hiding Pop-Up Links Not Working in PDFs on iOS
Question details
The user needs a way to display auto-hiding pop-up definitions in a PDF on an iOS device, as macOS scripts do not translate correctly to mobile.
- Product
- Device & OS
- iOS
- Scenario
- Viewing interactive PDFs containing acronym definitions or rollover pop-ups on an iPhone or iPad.
- Observed behavior
- Instead of auto-hiding rollover pop-ups, most iOS PDF readers display persistent sticky notes or ignore the interactive hover JavaScript entirely.
Before troubleshooting, keep in mind that iOS devices use touchscreens, meaning traditional mouse 'hover' or 'rollover' events cannot be triggered natively.
Use Standard PDF Annotations and Comments
Since iOS relies on touch interfaces instead of mouse hovers, replacing rollover events with standard tap-based comments is the most reliable approach.
PDF JavaScript and hover events are highly inconsistent on mobile platforms. Standardizing your definitions as basic PDF comments ensures that anyone opening the file on an iOS device can simply tap the icon to read the definition and tap away to close it.
Open your PDF document in a desktop PDF editor like WPS Office.
Delete the interactive JavaScript actions associated with mouse 'rollover' or 'hover' events, as these will cause errors or persistent sticky notes on iOS.
Navigate to the Comment or Insert tab and add standard 'Note' or 'Sticky Note' annotations next to your acronyms. Type your definition inside the note box.
Save your PDF and open it in standard iOS PDF readers like Apple Books or Files to verify that a simple tap opens and closes the definition.
Create a Hyperlinked Glossary Page
Instead of relying on pop-up boxes, link complex terms or acronyms to a dedicated definition page within the same PDF.
Create and Edit Interactive PDFs with WPS Office
WPS Office provides robust PDF editing tools, allowing you to easily add hyperlinks, comments, and annotations that are fully compatible across both desktop and mobile platforms.
- 1. Launch WPS Office: Open WPS Office on your computer or mobile device and open your PDF document.
- 2. Access the Comment Tools: Navigate to the 'Comment' tab located on the top ribbon.
- 3. Add Tap-to-View Notes: Select the 'Note' tool to insert standard comments that act as mobile-friendly tap-to-view pop-ups.
- 4. Export your PDF: Save your changes. The resulting PDF will now display properly on iOS touchscreen devices.
Frequently Asked Questions
Why do rollover pop-ups work on macOS but not on iOS?
macOS devices use a mouse cursor, which triggers 'hover' or 'rollover' events. iOS devices use touchscreens, which lack a hover state. Consequently, iOS PDF readers typically translate these interactive scripts poorly or ignore them entirely.
Is there any iOS PDF reader that supports interactive JavaScript?
A few specialized PDF readers on iOS offer partial support for PDF JavaScript, but none guarantee 100% compatibility with complex auto-hiding scripts designed for desktop environments.
Can I use CSS or HTML to create pop-ups in a PDF?
No, standard PDFs do not support HTML or CSS for rendering interactive elements. Interactive features in PDFs rely entirely on PDF-specific annotations, form fields, and JavaScript.
How can I define acronyms in a mobile-friendly way?
The most mobile-friendly methods are including the definition in parentheses after the first use, adding standard tap-to-view sticky note annotations, or using internal hyperlinks pointing to a glossary section.
