-
Notifications
You must be signed in to change notification settings - Fork 1.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Documentation bump #684
Documentation bump #684
Conversation
developer_manual/design/index.rst
Outdated
@@ -5,6 +5,7 @@ Design guidelines | |||
.. toctree:: | |||
:maxdepth: 2 | |||
|
|||
newbutton |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I'd say this should be part of the navigation section. 😉
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I asked myself the same question! I think you're right :)
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
In the other hand, the new button is placed outside of the <div id="app-navigation">
, so I'm not really sure. :/
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Why is it placed outside? Then it wouldn't be in the sidebar anymore.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hu! I'm an idiot, I wanted to say outside the ul navigation, but yes, this is inside the app-navigation. ^^'
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Nevertheless, we also have a specific settings page which is also in the app-navigation div, so which do you prefer? Inside the navigation page or like this ?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Ah ok 😉 Makes sense to have them grouped by the "app-navigation". Maybe we should also move the settings stuff to there, since that is in the app-navigation as well.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I agree! :)
d55f659
to
d686403
Compare
+ Wording fixes and introduction to the full navigation element Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
d686403
to
b672fb4
Compare
------------- | ||
|
||
A 'new' button is just a stylised button located above the navigation part of your app. | ||
It can be tied to whatever you want as long as it follow those simple rules. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It can be tied to whatever action you want
as long as it follow those simple rules.
?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe just call it primary action button, since it is then not limited to a create action. And we can get rid of the It can be tied to whatever you want
sentence.
* a menu | ||
* a settings area | ||
|
||
The 'new' button and the settings area are optional. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should we add a global code block to show a full example?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Should be clear from the other examples imo.
Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
e5d3a15
to
7633648
Compare
@juliushaertl Here we go! :) Also, see comments I made on this pr :) |
Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
------ | ||
|
||
* Stay simple, don't use overcomplicated text in this button. | ||
* Avoid using sentences longer than one line. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe also:
- Only use a single button
|
||
To create a settings area create a div with the id ``app-settings`` inside the ``app-navigation`` div. | ||
|
||
* The data attribute ``data-apps-slide-toggle`` slides up a target area using a jQuery selector and hides the area if the user clicks outside of it. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Is the toggling done by server code or do the app developer need to implement it themselves?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
server :)
Introduction | ||
=============== | ||
|
||
The navigation section of any nextcloud app is the left sidebar. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
nextcloud -> Nextcloud
Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
051ce12
to
e31fdc2
Compare
Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
e31fdc2
to
3db48fc
Compare
Signed-off-by: John Molakvoæ (skjnldsv) <skjnldsv@protonmail.com>
Let's get this in! :) |
Let's wait until 13 is branched off. |
@MorrisJobke clear? :) |
Pushed |
WIP
Top right header