1 ! Copyright (C) 2006, 2009 Slava Pestov.
2 ! See http://factorcode.org/license.txt for BSD license.
3 USING: debugger help help.topics help.crossref kernel models compiler.units
4 assocs words vocabs accessors fry combinators.short-circuit
5 sequences models models.history tools.apropos combinators
6 ui.commands ui.gadgets ui.gadgets.panes ui.gadgets.scrollers
7 ui.gadgets.tracks ui.gestures ui.gadgets.buttons ui.gadgets.packs
8 ui.gadgets.editors ui.gadgets.labels ui.gadgets.status-bar
9 ui.gadgets.glass ui.gadgets.borders ui.tools.common
10 ui.tools.browser.popups ui ;
13 TUPLE: browser-gadget < tool pane scroller search-field popup ;
15 { 650 400 } browser-gadget set-tool-dim
17 : show-help ( link browser-gadget -- )
18 model>> dup add-history
19 [ >link ] dip set-model ;
21 : <help-pane> ( browser-gadget -- gadget )
22 model>> [ '[ _ print-topic ] try ] <pane-control> ;
24 : search-browser ( string browser -- )
25 '[ <apropos> _ show-help ] unless-empty ;
27 : <search-field> ( browser -- field )
28 '[ _ search-browser ] <action-field>
32 : <browser-toolbar> ( browser -- toolbar )
37 over <toolbar> f track-add
38 swap search-field>> "Search:" label-on-left 1 track-add ;
40 : <browser-gadget> ( link -- gadget )
41 vertical browser-gadget new-track
43 swap >link <history> >>model
44 dup <search-field> >>search-field
45 dup <browser-toolbar> { 3 3 } <border> { 1 0 } >>fill f track-add
46 dup <help-pane> >>pane
47 dup pane>> <scroller> >>scroller
48 dup scroller>> 1 track-add ;
50 M: browser-gadget graft*
51 [ add-definition-observer ] [ call-next-method ] bi ;
53 M: browser-gadget ungraft*
54 [ call-next-method ] [ remove-definition-observer ] bi ;
56 M: browser-gadget handle-gesture
58 { [ over key-gesture? not ] [ call-next-method ] }
59 { [ dup popup>> ] [ { [ pass-to-popup ] [ call-next-method ] } 2&& ] }
63 : showing-definition? ( defspec assoc -- ? )
66 [ [ dup word-link? [ name>> ] when ] dip key? ]
67 [ [ dup vocab-link? [ vocab ] when ] dip key? ]
70 M: browser-gadget definitions-changed ( assoc browser -- )
71 model>> [ value>> swap showing-definition? ] keep
72 '[ _ notify-connections ] when ;
74 M: browser-gadget focusable-child* search-field>> ;
76 : (browser-window) ( topic -- )
77 <browser-gadget> "Browser" open-status-window ;
79 : browser-window ( -- )
80 "handbook" (browser-window) ;
82 \ browser-window H{ { +nullary+ t } } define-command
84 : com-browse ( link -- )
85 [ browser-gadget? ] find-window
86 [ [ raise-window ] [ gadget-child show-help ] bi ]
87 [ (browser-window) ] if* ;
90 [ browser-gadget? ] find-window
91 [ raise-window ] [ browser-window ] if* ;
93 \ show-browser H{ { +nullary+ t } } define-command
95 : com-back ( browser -- ) model>> go-back ;
97 : com-forward ( browser -- ) model>> go-forward ;
99 : com-documentation ( browser -- ) "handbook" swap show-help ;
101 : browser-help ( -- ) "ui-browser" com-browse ;
103 \ browser-help H{ { +nullary+ t } } define-command
105 browser-gadget "toolbar" f {
106 { T{ key-down f { A+ } "LEFT" } com-back }
107 { T{ key-down f { A+ } "RIGHT" } com-forward }
108 { f com-documentation }
109 { T{ key-down f f "F1" } browser-help }
112 : ?show-help ( link browser -- )
113 over [ show-help ] [ 2drop ] if ;
115 : navigate ( browser quot -- )
116 '[ control-value @ ] keep ?show-help ;
118 : com-up ( browser -- ) [ article-parent ] navigate ;
120 : com-prev ( browser -- ) [ prev-article ] navigate ;
122 : com-next ( browser -- ) [ next-article ] navigate ;
124 browser-gadget "navigation" "Commands for navigating in the article hierarchy" {
125 { T{ key-down f { A+ } "u" } com-up }
126 { T{ key-down f { A+ } "p" } com-prev }
127 { T{ key-down f { A+ } "n" } com-next }
128 { T{ key-down f { A+ } "k" } com-show-outgoing-links }
129 { T{ key-down f { A+ } "K" } com-show-incoming-links }
132 browser-gadget "multi-touch" f {
133 { left-action com-back }
134 { right-action com-forward }
137 browser-gadget "scrolling"
138 "The browser's scroller can be scrolled from the keyboard."
140 { T{ key-down f f "UP" } com-scroll-up }
141 { T{ key-down f f "DOWN" } com-scroll-down }
142 { T{ key-down f f "PAGE_UP" } com-page-up }
143 { T{ key-down f f "PAGE_DOWN" } com-page-down }