public-Repo-Mirrors/Top-Bar-Organizer
1
Fork 0
mirror of https://gitlab.gnome.org/julianschacher/top-bar-organizer.git synced 2025-10-27 15:19:09 +00:00
Code Releases Activity

Docs: Add initial About_the_Top_(Menu)Bar.md

Browse Source 
Add background documentation/information regarding the top (menu)bar.
This commit is contained in:
Julian 2021-05-12 12:12:22 +02:00
parent db0237792d
commit 1c7cafaff9
Signed by: julian
GPG Key ID: 094C2AC34192FA11
1 changed files with 18 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

18
docs/About_the_Top_(Menu)Bar.md Normal file
View File

@ -0,0 +1,18 @@
# About the Top (Menu)Bar
First of all, here are some Gnome Shell Design references for the top (menu)bar:
- <https://wiki.gnome.org/Projects/GnomeShell/Design> (see: Components -> Top Bar)
- <https://people.gnome.org/~mccann/shell/design/GNOME_Shell-20091114.pdf> (see: Components -> Top Menubar)
The top bar is an instance of Panel.
The Panel class is defined in [`panel.js`](https://gitlab.gnome.org/GNOME/gnome-shell/-/blob/master/js/ui/panel.js) and you can find an annotated version of `panel.js` in the `panel.js` of this repo.
### Initialization of the Top Bar
The top bar gets initialized by `Panel._init()` and `Panel._update()`.
These functions basically make sure, that the top bar has a `Panel._leftBox`, `Panel._centerBox` and `Panel._rightBox` with the default items like `activities`, `appMenu` and so on.
### Adding Items to the Top Bar
Extensions can add new items to the top bar using `Panel.addToStatusArea()`.