Skip to content
Mike Chen edited this page Aug 21, 2019 · 10 revisions

##FAQ

0. Can I use other keyboard shortcuts?

Yes. To change keyboard shortcuts, please go to Chrome Setting page.

  • Settings > More Tools > Extensions > (open sidebar by clicking the icon at upper-left corner) > Keyboard shortcuts
  • Or visit chrome://extensions/shortcuts

1. How the snapshot works?

It relies javascript to iterate the DOM elements of the page, and draws them on a html canvas.

2. Why there are some blank areas in the snapshot?

Page content, including images or lazy loaded blocks, might be hosted on a different domain.

Due to the security policy, javascript can not access cross-domain content.

3. How can I get a refined snapshot?

Instead of using extension's javascript, we can utilize the native snapshot functionality provided by Chrome.

4. Why the webpage is scrolled automatically when I try to refine the snapshot?

The native snapshot functionality, provided by Chrome, only works for current visible area.

To take a snapshot of whole page, we need to

  1. make multiple partial snapshots
  2. stitch them together like a panorama

So, the extension scrolls the webpage just like it moves the camera.

5. Why the snapshot a) does not fit to b) is overflowed from the height of window?

There are two way to implement mini-map:

  1. Make fixed-height snapshot.

    • if the page is short, the width of snapshot will overflow. (We are not good at horizontal scrolling)
    • if the page is long, the width of snapshot will become very narrow. (not good)
    fixed-height snapshot of short page fixed-height snapshot of long page
  2. Make fixed-width snapshot.

    • if the page is short, the height of snapshot will not reach the bottom of window. (little bit ugly)
    • if the page is long, the height of snapshot will overflow from the window viewport. (We can scroll to reveal them)
    fixed-width snapshot of short page fixed-width snapshot of long page

I choose the second way to implement it. Also makes it consists with SublimeText's minimap.

6. Why the snapshot floats on top of the page rather than has it's own space by shifting the page content.

Currently, I don't have good technical solution for shifting the page content and keeping the layout without being broken. I've tried to apply margin right on html, but fixed dom elements are relative to the viewport rather than html and they will not follow the change I made.

7. Why the snapshot doesn't refresh when page content changes (e.g. page with infinite loading)

The short answer is — there is some limitation from the tool. It's good for article-based static webpage. But it's not a good fit for pages with dynamic content.

Webpages could be dynamically changed in various ways. It's nearly impossible to keep eyes on all the changes. Or the cost is prohibitively high which eventually impairs your browsing experience. It's a trade-off I chose to not support dynamic content.