JS开发Word/Excel Online插件：ActiveViewChanged事件检测及视图实现咨询

Hey there! Let me walk you through what you need to know and some practical workarounds for your scenario:

First, a quick confirmation on event support #

You're absolutely right—Office.EventType.ActiveViewChanged is currently only supported in PowerPoint via Office JS. Word and Excel don't have a native event for tracking active view changes, so we'll need to use a workaround here. Also, there's no API to manually trigger a view mode switch in Word/Excel add-ins (this is intentional, to prevent plugins from altering the user's environment without explicit action).

Workaround: Poll for view state changes #

The most reliable way to detect when the user enters Reading View is to periodically check the active view state using the Office JS API. Here's how to implement this for both Word and Excel:

For Word Online #

let previousViewType;

// Initialize with the current view state when the plugin loads
Office.onReady(async () => {
  previousViewType = await Word.run(async (context) => {
    const view = context.document.activeView;
    context.load(view, 'viewType');
    await context.sync();
    return view.viewType;
  });

  // Start polling to check for view changes
  const viewCheckInterval = setInterval(async () => {
    const currentViewType = await Word.run(async (context) => {
      const view = context.document.activeView;
      context.load(view, 'viewType');
      await context.sync();
      return view.viewType;
    });

    // Trigger custom logic when switching into Reading View
    if (currentViewType === 'ReadingView' && previousViewType !== 'ReadingView') {
      console.log('Entered Reading View! Executing custom functionality...');
      // Insert your custom code here
    }

    previousViewType = currentViewType;
  }, 1500); // Adjust interval (1.5s is a good balance between responsiveness and performance)

  // Clean up the interval when the plugin is hidden/unloaded
  document.addEventListener('visibilitychange', () => {
    if (document.hidden) {
      clearInterval(viewCheckInterval);
    }
  });
});

For Excel Online #

The approach is similar, but we use Excel's view type enumeration:

let previousViewType;

Office.onReady(async () => {
  previousViewType = await Excel.run(async (context) => {
    const view = context.workbook.activeView;
    context.load(view, 'viewType');
    await context.sync();
    return view.viewType;
  });

  const viewCheckInterval = setInterval(async () => {
    const currentViewType = await Excel.run(async (context) => {
      const view = context.workbook.activeView;
      context.load(view, 'viewType');
      await context.sync();
      return view.viewType;
    });

    // Excel's Reading View is represented by 'Read'
    if (currentViewType === 'Read' && previousViewType !== 'Read') {
      console.log('Entered Reading View! Executing custom functionality...');
      // Insert your custom code here
    }

    previousViewType = currentViewType;
  }, 1500);

  // Clean up on visibility change
  document.addEventListener('visibilitychange', () => {
    if (document.hidden) {
      clearInterval(viewCheckInterval);
    }
  });
});

Key notes for this approach #

• Interval tuning: Avoid setting the interval too low (e.g., <500ms) as it can cause unnecessary API calls and performance issues. 1-2 seconds is ideal for most scenarios.
• Cleanup: Always clear the interval when the plugin is hidden or unloaded to prevent memory leaks.
• Initial check: The code checks the view state on plugin load, so if the user is already in Reading View when they launch the plugin, you can adjust the logic to run your custom code immediately.

Final thoughts #

While polling isn't as elegant as a native event, it's the only viable solution right now for tracking Reading View changes in Word and Excel add-ins. And as you noted, there's no way to manually trigger a view switch via Office JS—this is a deliberate limitation to prioritize user control.

内容的提问来源于stack exchange，提问作者thatdude