Re: “Function finder”, issue #1469

Great job, Norm!

May I propose that in addition  to this the TOC is made
collapsible/expandable? The TOCs of the specifications have become
themselves too-long to assimilate at a glance, thus it is useful to be able
to abstract (summarize) and/or dig deeper into details.

Using Html 5 it is no longer necessary to use javascript for this -
the *<details>
<https://developer.mozilla.org/en-US/docs/Web/HTML/Element/details>*
and *<summary>
<https://developer.mozilla.org/en-US/docs/Web/HTML/Element/summary>*
elements are designed to give us this in pure Html 5.

Thanks,
Dimitre



On Thu, Oct 10, 2024 at 2:14 AM Norm Tovey-Walsh <norm@saxonica.com> wrote:

> Hi folks,
>
> TL/DR; unless there are objections, I’m going to update the build scripts
> to replace the long F&O function drop-down list with a search box.
>
> L/R:
>
> I made an attempt at improving the function finder interface in the F&O
> specification per issue #1469. I posted a link to a “hand crafted” version
> a couple of weeks ago:
>
>    https://qt4cg.org/pr/datalist/xpath-functions-40/Overview.html
>
> Response was generally positive, I think.
>
> One open question is whether the segregation by namespace should be
> preserved. As I’ve coded it up, there’s just one search box and if you want
> the array:empty function, you can search for “array:empty” or you can just
> search for “empty” and select “array:empty” from the drop down.
>
> That could be changed so that there was still a namespace prefix dropdown
> and searching was limited to that namespace, I suppose. It seemed easier to
> me to just have one list since searching narrows it down pretty quickly.
>
> I guess the other thing to note is that I’m relying on datalist which is
> widely, but not universally, supported
>
>    https://caniuse.com/?search=datalist
>
> The exact presentation of the list varies by browser, so you might want to
> try it out in your favorites and see what you think. It doesn’t seem to
> work especially well on mobile devices, but that whole sidebar navigation
> setup is a bit clunky on small screens anyway.
>
>                                         Be seeing you,
>                                           norm
>
> --
> Norm Tovey-Walsh
> Saxonica
>


-- 
Cheers,
Dimitre Novatchev
---------------------------------------
Truly great madness cannot be achieved without significant intelligence.
---------------------------------------
To invent, you need a good imagination and a pile of junk
-------------------------------------
Never fight an inanimate object
-------------------------------------
To avoid situations in which you might make mistakes may be the
biggest mistake of all
------------------------------------
Quality means doing it right when no one is looking.
-------------------------------------
You've achieved success in your field when you don't know whether what
you're doing is work or play
-------------------------------------
To achieve the impossible dream, try going to sleep.
-------------------------------------
Facts do not cease to exist because they are ignored.
-------------------------------------
Typing monkeys will write all Shakespeare's works in 200yrs.Will they write
all patents, too? :)
-------------------------------------
Sanity is madness put to good use.
-------------------------------------
I finally figured out the only reason to be alive is to enjoy it.