[prev in list] [next in list] [prev in thread] [next in thread] 

List:       openjdk-openjfx-dev
Subject:    Re: JDK-8210361: Add images to docs for public API classes of controls
From:       Nir Lisker <nlisker () gmail ! com>
Date:       2018-09-12 20:23:58
Message-ID: CA+0ynh_jEYnGUXZNauRm+cyjwDLQ_BW=_ReQ-HQj-3uWWFiz=A () mail ! gmail ! com
[Download RAW message or body]

Hi Anirvan,

A gallery will fit best in the tutorials. The page for UI controls [1] will
be ideal in my opinion (put the gallery as the first link).

About the screenshots: that page contains much more suitable screenshots in
each control's page when it comes to a gallery. They are stylistic,
show-off-ish, and present a wider range of possibilities and states for
each control. The examples in the JavaDocs are minimalistic, with the point
of showing how easy it is to create the control. They don't make for much
of a gallery, but they do show the developer very quickly what that control
they are looking at is for a WYSIWYG code example.

I suggest you submit an RFE which relates to the general "update the
tutorials" issue [2] (instead of the one I'm working on) and take the
screenshots from those pages.

[1]
https://docs.oracle.com/javase/8/javafx/user-interface-tutorial/ui_controls.htm#JFXUI336
[2] https://bugs.openjdk.java.net/browse/JDK-8210360

- Nir

On Wed, Sep 12, 2018 at 10:33 PM Anirvan Sarkar <powers.anirvan@gmail.com>
wrote:

> Hi Nir,
>
> Thanks for this RFE.
>
> Now other UI toolkits like GTK and QT have a separate gallery of
> controls[1][2].
>
> I was considering to add something similar in JavaFX but I never got
> around to start working on it, mostly due to all the screenshots which is
> needed to be taken beforehand !
>
> Since you will now take images of all the controls, you can consider to
> add a gallery in this RFE itself.
>
> But if you don't want then someone else (me) can volunteer to do this once
> this RFE is merged.
>
> Let me know what you decide :-)
>
> [1] : https://developer.gnome.org/gtk4/stable/ch03.html
> [2] : http://doc.qt.io/archives/qt-4.8/gallery.html
>
>
> On Thu 13 Sep, 2018, 12:07 AM Kevin Rushforth, <kevin.rushforth@oracle.com>
> wrote:
>
>> Agreed. For simple controls like checkbox, button, etc., it makes sense
>> to use an undecorated Stage. It's less busy and puts the emphasis on the
>> control being illustrated.
>>
>> -- Kevin
>>
>>
>> On 9/12/2018 7:57 AM, Pedro Duque Vieira wrote:
>> > Yes I agree with you. Controls on which their window decorations are a
>> part
>> > of them, should show up with them. If those decorations change
>> depending on
>> > the platform their running, I would put a note saying that.
>> >
>> > The vast majority of controls don't belong to that category.
>> >
>> > Cheers,
>> >
>> > On Wed, Sep 12, 2018 at 3:51 PM Nir Lisker <nlisker@gmail.com> wrote:
>> >
>> >> That's sensible, though for Alert and the like I think they should
>> stay as
>> >> it's effectively part of the control.
>> >>
>> >> On Wed, Sep 12, 2018 at 4:19 PM Pedro Duque Vieira <
>> >> pedro.duquevieira@gmail.com> wrote:
>> >>
>> >>> I would remove the window decorations. That's platform dependent,
>> windows,
>> >>> linux, mac have different aesthetics for this. They also don't add any
>> >>> value to the representation of the control.
>> >>>
>> >>> That's what I usually do.
>> >>>
>> >>> Cheers,
>> >>>
>> >>>
>> >>>
>> >>>
>> >>> --
>> >>> Pedro Duque Vieira - https://www.pixelduke.com
>> >>>
>>
>>
[prev in list] [next in list] [prev in thread] [next in thread]