Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/OrionReed/dom3d
Browser extension to view and debug the DOM in 3D space.
https://github.com/OrionReed/dom3d
Last synced: 6 days ago
JSON representation
Browser extension to view and debug the DOM in 3D space.
- Host: GitHub
- URL: https://github.com/OrionReed/dom3d
- Owner: OrionReed
- License: gpl-3.0
- Created: 2024-03-27T20:25:22.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2024-04-03T21:43:05.000Z (7 months ago)
- Last Synced: 2024-08-02T20:46:22.621Z (3 months ago)
- Language: JavaScript
- Homepage:
- Size: 135 KB
- Stars: 424
- Watchers: 6
- Forks: 10
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
dom3d: a tiny spatial DOM viewer
### Installation
You can install this extension from the [Firefox](https://addons.mozilla.org/en-US/firefox/addon/dom3d/) and [Chrome](https://chromewebstore.google.com/detail/dom3d/lhdhfmkagpnfjjdgbionncpiolioknpj) extension stores or download the latest [release](https://github.com/OrionReed/dom3d/releases) and follow the instructions for your browser below.
Universal bookmarklet version
Simply prefix this code with `javascript:` and save it as a bookmark on Chrome or Firefox. This is a 1-1 equivalent to the full extension with the default configuration.
```js
(()=>{let e=t=>[...t.children].reduce((t,n)=>Math.max(t,e(n)),0)+1,t=e(document.body),n=(e,n=0,o=0)=>`hsl(${n}, 75%, ${Math.min(10+e*(1+60/t),90)+o}%)`,o=document.body;o.style.overflow="visible",o.style.transformStyle="preserve-3d",o.style.perspective=1e4;let r=window.innerWidth/2,i=window.innerHeight/2;o.style.perspectiveOrigin=o.style.transformOrigin=`${r}px ${i}px`,function e(t,o,r,i){for(let l=t.childNodes,s=l.length,d=0;d{let t=180*(1-e.clientY/window.innerHeight)-90,n=180*e.clientX/window.innerWidth-90;o.style.transform=`rotateX(${t}deg) rotateY(${n}deg)`})})();
```
In Firefox
1. Go to `about:debugging#/runtime/this-firefox`
2. Click "Load Temporary Addon"
3. Select `manifest.json` in the downloaded folder
4. Extension should now be installed, you can find it in the top right extensions menu (puzzle piece icon) and pin it if desired
In Chrome/Chromium browsers
1. Go to `chrome://extensions`
2. Enable "Developer Mode" in the top right
3. Click "Load Unpacked"
4. Select the downloaded folder
5. Extension should now be installed, you can find it in the top right extensions menu (puzzle piece icon) and pin it if desired
**Specific Chromium browsers may have additional steps.**
- In Opera, enable "Allow access to search page results"
In Microsoft Edge
1. Go to `edge://extensions`
2. Click "Load Unpacked"
3. Select the downloaded folder. Please use the Chrome version of the extension.
4. Extension should now be installed, you can find it in the top right extensions menu (puzzle piece icon) and pin it if desired
## Usage
Click the extension icon to enable 3D DOM view or right-click it for options.
| Option | Description |
|-----------------------|--------------------------------------------------------|
| Show Surfaces | Toggle visibility of element surfaces |
| Show Sides | Toggle visibility of element sides |
| Require Drag | Only rotate when dragging |
| Require Alt | Only rotate when Alt key is pressed |
| Randomize Color | Apply random colors to elements |
| CSS Selectors | Set CSS selectors to selectively color elements |
## Development
1. Run `yarn install`
2. Run `yarn watch` to watch for changes and automatically rebuild the extension.
3. Load the extension from `dist/{browser}` following the steps above.
For Safari, you can run `xcrun safari-web-extension-converter dist/safari` and try to go from there. No success so far.
## Known Issues
All help in diagnosing and fixing these key issues is welcome! I've linked to an Issue for each of them.
- [The z-ordering of DOM elements from the 'cameras' perspective is incorrect in some cases.](https://github.com/OrionReed/dom3d/issues/9)
- [Some websites (like GitHub) appear flat when their DOM clearly isn't.](https://github.com/OrionReed/dom3d/issues/10)
- [Some elements don't increase stack height, such as `` and `` tags.](https://github.com/OrionReed/dom3d/issues/11)