Helios-Core.st 45 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353
  1. Smalltalk createPackage: 'Helios-Core'!
  2. InterfacingObject subclass: #HLModel
  3. instanceVariableNames: 'announcer environment'
  4. package: 'Helios-Core'!
  5. !HLModel commentStamp!
  6. I am the abstract superclass of all models of Helios.
  7. I am the "Model" part of the MVC pattern implementation in Helios.
  8. I provide access to an `Environment` object and both a local (model-specific) and global (system-specific) announcer.
  9. The `#withChangesDo:` method is handy for performing model changes ensuring that all widgets are aware of the change and can prevent it from happening.
  10. Modifications of the system should be done via commands (see `HLCommand` and subclasses).!
  11. !HLModel methodsFor: 'accessing'!
  12. announcer
  13. ^ announcer ifNil: [ announcer := Announcer new ]
  14. !
  15. environment
  16. ^ environment ifNil: [ self manager environment ]
  17. !
  18. environment: anEnvironment
  19. environment := anEnvironment
  20. !
  21. manager
  22. ^ HLManager current
  23. !
  24. systemAnnouncer
  25. ^ self environment systemAnnouncer
  26. ! !
  27. !HLModel methodsFor: 'error handling'!
  28. withChangesDo: aBlock
  29. [
  30. self announcer announce: (HLAboutToChange new
  31. actionBlock: aBlock;
  32. yourself).
  33. aBlock value.
  34. ]
  35. on: HLChangeForbidden
  36. do: [ :ex | ]
  37. ! !
  38. !HLModel methodsFor: 'testing'!
  39. isBrowserModel
  40. ^ false
  41. !
  42. isReferencesModel
  43. ^ false
  44. !
  45. isToolModel
  46. ^ false
  47. ! !
  48. HLModel subclass: #HLFinder
  49. instanceVariableNames: ''
  50. package: 'Helios-Core'!
  51. !HLFinder commentStamp!
  52. I am the `Finder` service handler of Helios.
  53. Finding a class will open a new class browser, while finding a method will open a references browser.!
  54. !HLFinder methodsFor: 'finding'!
  55. findClass: aClass
  56. HLBrowser openAsTab openClassNamed: aClass name
  57. !
  58. findMethod: aCompiledMethod
  59. HLBrowser openAsTab openMethod: aCompiledMethod
  60. !
  61. findString: aString
  62. | foundClass |
  63. foundClass := self environment classes
  64. detect: [ :each | each name = aString ]
  65. ifNone: [ nil ].
  66. foundClass
  67. ifNil: [ HLReferences openAsTab search: aString ]
  68. ifNotNil: [ self findClass: foundClass ]
  69. ! !
  70. HLModel subclass: #HLToolModel
  71. instanceVariableNames: 'selectedClass selectedPackage selectedProtocol selectedSelector'
  72. package: 'Helios-Core'!
  73. !HLToolModel commentStamp!
  74. I am a model specific to package and class manipulation. All browsers should either use me or a subclass as their model.
  75. I provide methods for package, class, protocol and method manipulation and access, forwarding to my environment.
  76. I also handle compilation of classes and methods as well as compilation and parsing errors.!
  77. !HLToolModel methodsFor: 'accessing'!
  78. allSelectors
  79. ^ self environment allSelectors
  80. !
  81. availableClassNames
  82. ^ self environment availableClassNames
  83. !
  84. availablePackageNames
  85. ^ self environment availablePackageNames
  86. !
  87. availablePackages
  88. ^ self environment availablePackageNames
  89. !
  90. availableProtocols
  91. ^ self environment availableProtocolsFor: self selectedClass
  92. !
  93. forceSelectedClass: aClass
  94. self withChangesDo: [
  95. self
  96. selectedClass: nil;
  97. selectedClass: aClass ]
  98. !
  99. forceSelectedMethod: aMethod
  100. self withChangesDo: [
  101. self
  102. selectedMethod: nil;
  103. selectedMethod: aMethod ]
  104. !
  105. forceSelectedPackage: aPackage
  106. self withChangesDo: [
  107. self
  108. selectedPackage: nil;
  109. selectedPackage: aPackage ]
  110. !
  111. forceSelectedProtocol: aProtocol
  112. self withChangesDo: [
  113. self
  114. selectedProtocol: nil;
  115. selectedProtocol: aProtocol ]
  116. !
  117. packageToCommit
  118. "Answer the package to commit depending on the context:
  119. - if a Method is selected, answer its package
  120. - else answer the `selectedPackage`"
  121. ^ self selectedMethod
  122. ifNil: [ self selectedPackage ]
  123. ifNotNil: [ :method | method package ]
  124. !
  125. packages
  126. ^ self environment packages
  127. !
  128. selectedClass
  129. ^ selectedClass
  130. !
  131. selectedClass: aClass
  132. (self selectedClass = aClass and: [ aClass isNil ])
  133. ifTrue: [ ^ self ].
  134. self withChangesDo: [
  135. selectedClass = aClass ifTrue: [
  136. self selectedProtocol: nil ].
  137. aClass
  138. ifNil: [ selectedClass := nil ]
  139. ifNotNil: [
  140. self selectedPackage: aClass theNonMetaClass package.
  141. self showInstance
  142. ifTrue: [ selectedClass := aClass theNonMetaClass ]
  143. ifFalse: [ selectedClass := aClass theMetaClass ] ].
  144. self selectedProtocol: nil.
  145. self announcer announce: (HLClassSelected on: self selectedClass) ]
  146. !
  147. selectedMethod
  148. ^ self selectedClass ifNotNil: [
  149. self selectedClass methodDictionary
  150. at: selectedSelector
  151. ifAbsent: [ nil ] ]
  152. !
  153. selectedMethod: aCompiledMethod
  154. selectedSelector = aCompiledMethod ifTrue: [ ^ self ].
  155. self withChangesDo: [
  156. aCompiledMethod
  157. ifNil: [ selectedSelector := nil ]
  158. ifNotNil: [
  159. selectedClass := aCompiledMethod methodClass.
  160. selectedPackage := selectedClass theNonMetaClass package.
  161. selectedSelector := aCompiledMethod selector ].
  162. self announcer announce: (HLMethodSelected on: aCompiledMethod) ]
  163. !
  164. selectedPackage
  165. ^ selectedPackage
  166. !
  167. selectedPackage: aPackage
  168. selectedPackage = aPackage ifTrue: [ ^ self ].
  169. self withChangesDo: [
  170. selectedPackage := aPackage.
  171. self selectedClass: nil.
  172. self announcer announce: (HLPackageSelected on: aPackage) ]
  173. !
  174. selectedProtocol
  175. ^ selectedProtocol
  176. !
  177. selectedProtocol: aString
  178. selectedProtocol = aString ifTrue: [ ^ self ].
  179. self withChangesDo: [
  180. selectedProtocol := aString.
  181. self selectedMethod: nil.
  182. self announcer announce: (HLProtocolSelected on: aString) ]
  183. ! !
  184. !HLToolModel methodsFor: 'actions'!
  185. addInstVarNamed: aString
  186. self environment addInstVarNamed: aString to: self selectedClass.
  187. self announcer announce: (HLInstVarAdded new
  188. theClass: self selectedClass;
  189. variableName: aString;
  190. yourself)
  191. !
  192. save: aString
  193. self announcer announce: HLSourceCodeSaved new.
  194. (self shouldCompileClassDefinition: aString)
  195. ifTrue: [ self compileClassDefinition: aString ]
  196. ifFalse: [ self compileMethod: aString ]
  197. !
  198. saveSourceCode
  199. self announcer announce: HLSaveSourceCode new
  200. ! !
  201. !HLToolModel methodsFor: 'commands actions'!
  202. commitPackageOnSuccess: aBlock onError: anotherBlock
  203. self environment
  204. commitPackage: self packageToCommit
  205. onSuccess: aBlock
  206. onError: anotherBlock
  207. !
  208. copyClassTo: aClassName
  209. self withChangesDo: [
  210. self environment
  211. copyClass: self selectedClass theNonMetaClass
  212. to: aClassName ]
  213. !
  214. moveClassToPackage: aPackageName
  215. self withChangesDo: [
  216. self environment
  217. moveClass: self selectedClass theNonMetaClass
  218. toPackage: aPackageName ]
  219. !
  220. moveMethodToClass: aClassName
  221. self withChangesDo: [
  222. self environment
  223. moveMethod: self selectedMethod
  224. toClass: aClassName ]
  225. !
  226. moveMethodToProtocol: aProtocol
  227. self withChangesDo: [
  228. self environment
  229. moveMethod: self selectedMethod
  230. toProtocol: aProtocol ]
  231. !
  232. openClassNamed: aString
  233. | class |
  234. self withChangesDo: [
  235. class := self environment classNamed: aString.
  236. self selectedPackage: class package.
  237. self selectedClass: class ]
  238. !
  239. removeClass
  240. self withChangesDo: [
  241. self manager
  242. confirm: 'Do you REALLY want to remove class ', self selectedClass theNonMetaClass name
  243. ifTrue: [ self environment removeClass: self selectedClass theNonMetaClass ] ]
  244. !
  245. removeMethod
  246. self withChangesDo: [
  247. self manager
  248. confirm: 'Do you REALLY want to remove method ', self selectedMethod methodClass name,' >> #', self selectedMethod selector
  249. ifTrue: [ self environment removeMethod: self selectedMethod ] ]
  250. !
  251. removeProtocol
  252. self withChangesDo: [
  253. self manager
  254. confirm: 'Do you REALLY want to remove protocol ', self selectedProtocol
  255. ifTrue: [ self environment
  256. removeProtocol: self selectedProtocol
  257. from: self selectedClass ] ]
  258. !
  259. renameClassTo: aClassName
  260. self withChangesDo: [
  261. self environment
  262. renameClass: self selectedClass theNonMetaClass
  263. to: aClassName ]
  264. !
  265. renameProtocolTo: aString
  266. self withChangesDo: [
  267. self environment
  268. renameProtocol: self selectedProtocol
  269. to: aString
  270. in: self selectedClass ]
  271. ! !
  272. !HLToolModel methodsFor: 'compiling'!
  273. compileClassComment: aString
  274. self environment
  275. compileClassComment: aString
  276. for: self selectedClass
  277. !
  278. compileClassDefinition: aString
  279. self environment compileClassDefinition: aString
  280. !
  281. compileMethod: aString
  282. | method |
  283. self withCompileErrorHandling: [
  284. method := self environment
  285. compileMethod: aString
  286. for: self selectedClass
  287. protocol: self compilationProtocol.
  288. self selectedMethod: method ]
  289. ! !
  290. !HLToolModel methodsFor: 'defaults'!
  291. allProtocol
  292. ^ '-- all --'
  293. !
  294. unclassifiedProtocol
  295. ^ 'as yet unclassified'
  296. ! !
  297. !HLToolModel methodsFor: 'error handling'!
  298. handleCompileError: anError
  299. self announcer announce: (HLCompileErrorRaised new
  300. error: anError;
  301. yourself)
  302. !
  303. handleParseError: anError
  304. | split line column messageToInsert |
  305. split := anError messageText tokenize: ' : '.
  306. messageToInsert := split second.
  307. "21 = 'Parse error on line ' size + 1"
  308. split := split first copyFrom: 21 to: split first size.
  309. split := split tokenize: ' column '.
  310. line := split first.
  311. column := split second.
  312. self announcer announce: (HLParseErrorRaised new
  313. line: line asNumber;
  314. column: column asNumber;
  315. message: messageToInsert;
  316. error: anError;
  317. yourself)
  318. !
  319. handleUnkownVariableError: anError
  320. self announcer announce: (HLUnknownVariableErrorRaised new
  321. error: anError;
  322. yourself)
  323. !
  324. withCompileErrorHandling: aBlock
  325. self environment
  326. evaluate: [
  327. self environment
  328. evaluate: [
  329. self environment
  330. evaluate: aBlock
  331. on: ParseError
  332. do: [ :ex | self handleParseError: ex ] ]
  333. on: UnknownVariableError
  334. do: [ :ex | self handleUnkownVariableError: ex ] ]
  335. on: CompilerError
  336. do: [ :ex | self handleCompileError: ex ]
  337. ! !
  338. !HLToolModel methodsFor: 'private'!
  339. compilationProtocol
  340. | currentProtocol |
  341. currentProtocol := self selectedProtocol.
  342. currentProtocol ifNil: [ currentProtocol := self unclassifiedProtocol ].
  343. self selectedMethod ifNotNil: [ currentProtocol := self selectedMethod protocol ].
  344. ^ currentProtocol = self allProtocol
  345. ifTrue: [ self unclassifiedProtocol ]
  346. ifFalse: [ currentProtocol ]
  347. !
  348. withHelperLabelled: aString do: aBlock
  349. "TODO: doesn't belong here"
  350. '#helper' asJQuery remove.
  351. [ :html |
  352. html div
  353. id: 'helper';
  354. with: aString ] appendToJQuery: 'body' asJQuery.
  355. [
  356. aBlock value.
  357. '#helper' asJQuery remove
  358. ]
  359. valueWithTimeout: 10
  360. ! !
  361. !HLToolModel methodsFor: 'testing'!
  362. isToolModel
  363. ^ true
  364. !
  365. shouldCompileClassDefinition: aString
  366. ^ self selectedClass isNil or: [
  367. aString match: '^\s*[A-Z]' ]
  368. ! !
  369. !HLToolModel class methodsFor: 'actions'!
  370. on: anEnvironment
  371. ^ self new
  372. environment: anEnvironment;
  373. yourself
  374. ! !
  375. Object subclass: #HLProgressHandler
  376. instanceVariableNames: ''
  377. package: 'Helios-Core'!
  378. !HLProgressHandler commentStamp!
  379. I am a specific progress handler for Helios, displaying progresses in a modal window.!
  380. !HLProgressHandler methodsFor: 'progress handling'!
  381. do: aBlock on: aCollection displaying: aString
  382. HLProgressWidget default
  383. do: aBlock
  384. on: aCollection
  385. displaying: aString
  386. ! !
  387. Widget subclass: #HLWidget
  388. instanceVariableNames: 'wrapper'
  389. package: 'Helios-Core'!
  390. !HLWidget commentStamp!
  391. I am the abstract superclass of all Helios widgets.
  392. I provide common methods, additional behavior to widgets useful for Helios, like dialog creation, command execution and tab creation.
  393. ## API
  394. 1. Rendering
  395. Instead of overriding `#renderOn:` as with other Widget subclasses, my subclasses should override `#renderContentOn:`.
  396. 2. Refreshing
  397. To re-render a widget, use `#refresh`.
  398. 3. Key bindings registration and tabs
  399. When displayed as a tab, the widget has a chance to register keybindings with the `#registerBindingsOn:` hook method.
  400. 4. Unregistration
  401. When a widget has subscribed to announcements or other actions that need to be cleared when closing the tab, the hook method `#unregister` will be called by helios.
  402. 5. Tabs
  403. To enable a widget class to be open as a tab, override the class-side `#canBeOpenAsTab` method to answer `true`. `#tabClass` and `#tabPriority` can be overridden too to respectively change the css class of the tab and the order of tabs in the main menu.
  404. 6. Command execution
  405. An helios command (instance of `HLCommand` or one of its subclass) can be executed with `#execute:`.!
  406. !HLWidget methodsFor: 'accessing'!
  407. cssClass
  408. ^ 'hl_widget'
  409. !
  410. manager
  411. ^ HLManager current
  412. !
  413. removeTab
  414. self manager removeTabForWidget: self
  415. !
  416. setTabLabel: aString
  417. self manager announcer announce: (HLTabLabelChanged new
  418. widget: self;
  419. label: aString;
  420. yourself)
  421. !
  422. tabClass
  423. ^ self class tabClass
  424. !
  425. wrapper
  426. ^ wrapper
  427. ! !
  428. !HLWidget methodsFor: 'actions'!
  429. confirm: aString ifTrue: aBlock
  430. self manager confirm: aString ifTrue: aBlock
  431. !
  432. confirm: aString ifTrue: aBlock ifFalse: anotherBlock
  433. self manager
  434. confirm: aString
  435. ifTrue: aBlock
  436. ifFalse: anotherBlock
  437. !
  438. execute: aCommand
  439. HLManager current keyBinder
  440. activate;
  441. applyBinding: aCommand asBinding
  442. !
  443. inform: aString
  444. self manager inform: aString
  445. !
  446. openAsTab
  447. (HLTabWidget on: self labelled: self defaultTabLabel)
  448. add
  449. !
  450. request: aString do: aBlock
  451. self manager request: aString do: aBlock
  452. !
  453. request: aString value: valueString do: aBlock
  454. self manager
  455. request: aString
  456. value: valueString
  457. do: aBlock
  458. !
  459. unregister
  460. "This method is called whenever the receiver is closed (as a tab).
  461. Widgets subscribing to announcements should unregister there"
  462. ! !
  463. !HLWidget methodsFor: 'defaults'!
  464. defaultTabLabel
  465. ^ self class tabLabel
  466. ! !
  467. !HLWidget methodsFor: 'keybindings'!
  468. bindKeyDown: keyDownBlock keyUp: keyUpBlock
  469. self wrapper asJQuery
  470. keydown: keyDownBlock;
  471. keyup: keyUpBlock
  472. !
  473. registerBindings
  474. self registerBindingsOn: self manager keyBinder bindings
  475. !
  476. registerBindingsOn: aBindingGroup
  477. !
  478. unbindKeyDownKeyUp
  479. self wrapper asJQuery
  480. unbind: 'keydown';
  481. unbind: 'keyup'
  482. ! !
  483. !HLWidget methodsFor: 'rendering'!
  484. renderContentOn: html
  485. !
  486. renderOn: html
  487. wrapper := html div
  488. class: self cssClass;
  489. yourself.
  490. [ :renderer | self renderContentOn: renderer ] appendToJQuery: wrapper asJQuery
  491. ! !
  492. !HLWidget methodsFor: 'testing'!
  493. canHaveFocus
  494. ^ false
  495. ! !
  496. !HLWidget methodsFor: 'updating'!
  497. refresh
  498. self wrapper ifNil: [ ^ self ].
  499. self wrapper asJQuery empty.
  500. [ :html | self renderContentOn: html ] appendToJQuery: self wrapper asJQuery
  501. ! !
  502. !HLWidget class methodsFor: 'accessing'!
  503. openAsTab
  504. | instance |
  505. instance := self new.
  506. (HLTabWidget
  507. on: instance
  508. labelled: instance defaultTabLabel) add.
  509. ^ instance
  510. !
  511. tabClass
  512. ^ ''
  513. !
  514. tabLabel
  515. ^ 'Tab'
  516. !
  517. tabPriority
  518. ^ 500
  519. ! !
  520. !HLWidget class methodsFor: 'testing'!
  521. canBeOpenAsTab
  522. ^ false
  523. ! !
  524. HLWidget subclass: #HLFocusableWidget
  525. instanceVariableNames: ''
  526. package: 'Helios-Core'!
  527. !HLFocusableWidget commentStamp!
  528. I am a widget that can be focused.
  529. ## API
  530. Instead of overriding `#renderOn:` as with other `Widget` subclasses, my subclasses should override `#renderContentOn:`.
  531. To bring the focus to the widget, use the `#focus` method.!
  532. !HLFocusableWidget methodsFor: 'accessing'!
  533. focusClass
  534. ^ 'focused'
  535. ! !
  536. !HLFocusableWidget methodsFor: 'events'!
  537. blur
  538. self wrapper asJQuery blur
  539. !
  540. focus
  541. self wrapper asJQuery focus
  542. ! !
  543. !HLFocusableWidget methodsFor: 'rendering'!
  544. renderContentOn: html
  545. !
  546. renderOn: html
  547. wrapper := html div
  548. class: self cssClass;
  549. yourself.
  550. wrapper with: [ self renderContentOn: html ].
  551. wrapper
  552. at: 'tabindex' put: '0';
  553. onBlur: [ self wrapper asJQuery removeClass: self focusClass ];
  554. onFocus: [ self wrapper asJQuery addClass: self focusClass ]
  555. ! !
  556. !HLFocusableWidget methodsFor: 'testing'!
  557. canHaveFocus
  558. ^ true
  559. !
  560. hasFocus
  561. ^ self wrapper notNil and: [ self wrapper asJQuery hasClass: self focusClass ]
  562. ! !
  563. HLFocusableWidget subclass: #HLListWidget
  564. instanceVariableNames: 'items selectedItem'
  565. package: 'Helios-Core'!
  566. !HLListWidget methodsFor: 'accessing'!
  567. activeItemCssClass
  568. ^'active'
  569. !
  570. buttonsDivCssClass
  571. ^ 'pane_actions form-actions'
  572. !
  573. cssClassForItem: anObject
  574. ^ ''
  575. !
  576. findListItemFor: anObject
  577. ^ (((wrapper asJQuery find: 'li')
  578. filter: [ :thisArg :otherArg | (thisArg asJQuery data: 'item') = anObject ] currySelf) eq: 0)
  579. !
  580. items
  581. ^ items ifNil: [ items := self defaultItems ]
  582. !
  583. items: aCollection
  584. items := aCollection
  585. !
  586. listCssClass
  587. ^'nav nav-pills nav-stacked'
  588. !
  589. listCssClassForItem: anObject
  590. ^ self selectedItem = anObject
  591. ifTrue: [ self activeItemCssClass ]
  592. ifFalse: [ 'inactive' ]
  593. !
  594. positionOf: aListItem
  595. <
  596. return aListItem.parent().children().get().indexOf(aListItem.get(0)) + 1
  597. >
  598. !
  599. selectedItem
  600. ^ selectedItem
  601. !
  602. selectedItem: anObject
  603. selectedItem := anObject
  604. ! !
  605. !HLListWidget methodsFor: 'actions'!
  606. activateFirstListItem
  607. self activateListItem: ((wrapper asJQuery find: 'li.inactive') eq: 0)
  608. !
  609. activateItem: anObject
  610. self activateListItem: (self findListItemFor: anObject)
  611. !
  612. activateListItem: aListItem
  613. | item |
  614. (aListItem get: 0) ifNil: [ ^ self ].
  615. aListItem parent children removeClass: self activeItemCssClass.
  616. aListItem addClass: self activeItemCssClass.
  617. self ensureVisible: aListItem.
  618. "Activate the corresponding item"
  619. item := aListItem data: 'item'.
  620. self selectedItem == item ifFalse: [
  621. self selectItem: item ]
  622. !
  623. activateNextListItem
  624. self activateListItem: (self wrapper asJQuery find: ('li.', self activeItemCssClass)) next.
  625. "select the first item if none is selected"
  626. (self wrapper asJQuery find: (' .', self activeItemCssClass)) get ifEmpty: [
  627. self activateFirstListItem ]
  628. !
  629. activatePreviousListItem
  630. self activateListItem: (self wrapper asJQuery find: ('li.', self activeItemCssClass)) prev
  631. !
  632. ensureVisible: aListItem
  633. "Move the scrollbar to show the active element"
  634. | parent position |
  635. (aListItem get: 0) ifNil: [ ^ self ].
  636. position := self positionOf: aListItem.
  637. parent := aListItem parent.
  638. aListItem position top < 0 ifTrue: [
  639. (parent get: 0) scrollTop: ((parent get: 0) scrollTop + aListItem position top - 10) ].
  640. aListItem position top + aListItem height > parent height ifTrue: [
  641. (parent get: 0) scrollTop: ((parent get: 0) scrollTop + aListItem height - (parent height - aListItem position top)) +10 ]
  642. !
  643. focus
  644. super focus.
  645. self items isEmpty ifFalse: [
  646. self selectedItem ifNil: [ self activateFirstListItem ] ]
  647. !
  648. reactivateListItem: aListItem
  649. self activateListItem: aListItem.
  650. self reselectItem: self selectedItem
  651. !
  652. refresh
  653. super refresh.
  654. self selectedItem ifNotNil: [self ensureVisible: (self findListItemFor: self selectedItem)].
  655. !
  656. reselectItem: anObject
  657. !
  658. selectItem: anObject
  659. self selectedItem: anObject
  660. ! !
  661. !HLListWidget methodsFor: 'defaults'!
  662. defaultItems
  663. ^ #()
  664. ! !
  665. !HLListWidget methodsFor: 'events'!
  666. setupKeyBindings
  667. (HLRepeatedKeyDownHandler on: self)
  668. whileKeyDown: 38 do: [ self activatePreviousListItem ];
  669. whileKeyDown: 40 do: [ self activateNextListItem ];
  670. rebindKeys.
  671. self wrapper asJQuery keydown: [ :e |
  672. e which = 13 ifTrue: [
  673. self reselectItem: self selectedItem ] ]
  674. ! !
  675. !HLListWidget methodsFor: 'rendering'!
  676. renderButtonsOn: html
  677. !
  678. renderContentOn: html
  679. html ul
  680. class: self listCssClass;
  681. with: [ self renderListOn: html ];
  682. onClick: [ self focus ].
  683. html div class: self buttonsDivCssClass; with: [
  684. self renderButtonsOn: html ].
  685. self setupKeyBindings
  686. !
  687. renderItem: anObject on: html
  688. | li |
  689. li := html li.
  690. li asJQuery data: 'item' put: anObject.
  691. li
  692. class: (self listCssClassForItem: anObject);
  693. with: [
  694. html a
  695. with: [
  696. (html tag: 'i') class: (self cssClassForItem: anObject).
  697. self renderItemLabel: anObject on: html ];
  698. onClick: [
  699. self reactivateListItem: li asJQuery ] ]
  700. !
  701. renderItemLabel: anObject on: html
  702. html with: anObject asString
  703. !
  704. renderListOn: html
  705. self items do: [ :each |
  706. self renderItem: each on: html ]
  707. ! !
  708. HLListWidget subclass: #HLNavigationListWidget
  709. instanceVariableNames: 'previous next'
  710. package: 'Helios-Core'!
  711. !HLNavigationListWidget methodsFor: 'accessing'!
  712. next
  713. ^ next
  714. !
  715. next: aWidget
  716. next := aWidget.
  717. aWidget previous = self ifFalse: [ aWidget previous: self ]
  718. !
  719. previous
  720. ^ previous
  721. !
  722. previous: aWidget
  723. previous := aWidget.
  724. aWidget next = self ifFalse: [ aWidget next: self ]
  725. ! !
  726. !HLNavigationListWidget methodsFor: 'actions'!
  727. nextFocus
  728. self next ifNotNil: [ self next focus ]
  729. !
  730. previousFocus
  731. self previous ifNotNil: [ self previous focus ]
  732. ! !
  733. !HLNavigationListWidget methodsFor: 'events'!
  734. setupKeyBindings
  735. super setupKeyBindings.
  736. self wrapper asJQuery keydown: [ :e |
  737. e which = 39 ifTrue: [
  738. self nextFocus ].
  739. e which = 37 ifTrue: [
  740. self previousFocus ] ]
  741. ! !
  742. HLNavigationListWidget subclass: #HLToolListWidget
  743. instanceVariableNames: 'model'
  744. package: 'Helios-Core'!
  745. !HLToolListWidget methodsFor: 'accessing'!
  746. commandCategory
  747. ^ self label
  748. !
  749. label
  750. ^ 'List'
  751. !
  752. menuCommands
  753. "Answer a collection of commands to be put in the cog menu"
  754. ^ ((HLToolCommand concreteClasses
  755. select: [ :each | each isValidFor: self model ])
  756. collect: [ :each | each for: self model ])
  757. select: [ :each |
  758. each category = self commandCategory and: [
  759. each isAction and: [ each isActive ] ] ]
  760. !
  761. model
  762. ^ model
  763. !
  764. model: aBrowserModel
  765. model := aBrowserModel.
  766. self
  767. observeSystem;
  768. observeModel
  769. !
  770. selectedItem: anItem
  771. "Selection changed, update the cog menu"
  772. super selectedItem: anItem.
  773. self updateMenu
  774. ! !
  775. !HLToolListWidget methodsFor: 'actions'!
  776. activateListItem: anItem
  777. self model withChangesDo: [ super activateListItem: anItem ]
  778. !
  779. activateNextListItem
  780. self model withChangesDo: [ super activateNextListItem ]
  781. !
  782. activatePreviousListItem
  783. self model withChangesDo: [ super activatePreviousListItem ]
  784. !
  785. observeModel
  786. !
  787. observeSystem
  788. !
  789. reactivateListItem: anItem
  790. self model withChangesDo: [ super reactivateListItem: anItem ]
  791. !
  792. unregister
  793. super unregister.
  794. self model announcer unsubscribe: self.
  795. self model systemAnnouncer unsubscribe: self
  796. ! !
  797. !HLToolListWidget methodsFor: 'rendering'!
  798. renderContentOn: html
  799. self renderHeadOn: html.
  800. super renderContentOn: html
  801. !
  802. renderHeadOn: html
  803. html div
  804. class: 'list-label';
  805. with: [
  806. html with: self label.
  807. self renderMenuOn: html ]
  808. !
  809. renderMenuOn: html
  810. | commands |
  811. commands := self menuCommands.
  812. commands isEmpty ifTrue: [ ^ self ].
  813. html div
  814. class: 'btn-group cog';
  815. with: [
  816. html a
  817. class: 'btn dropdown-toggle';
  818. at: 'data-toggle' put: 'dropdown';
  819. with: [ (html tag: 'i') class: 'icon-chevron-down' ].
  820. html ul
  821. class: 'dropdown-menu pull-right';
  822. with: [
  823. self menuCommands do: [ :each |
  824. html li with: [ html a
  825. with: each menuLabel;
  826. onClick: [ self execute: each ] ] ] ] ]
  827. ! !
  828. !HLToolListWidget methodsFor: 'updating'!
  829. updateMenu
  830. (self wrapper asJQuery find: '.cog') remove.
  831. [ :html | self renderMenuOn: html ]
  832. appendToJQuery: (self wrapper asJQuery find: '.list-label')
  833. ! !
  834. !HLToolListWidget class methodsFor: 'instance creation'!
  835. on: aModel
  836. ^ self new
  837. model: aModel;
  838. yourself
  839. ! !
  840. HLListWidget subclass: #HLTabListWidget
  841. instanceVariableNames: 'callback'
  842. package: 'Helios-Core'!
  843. !HLTabListWidget commentStamp!
  844. I am a widget used to display a list of helios tabs.
  845. When a tab is selected, `callback` is evaluated with the selected tab as argument.!
  846. !HLTabListWidget methodsFor: 'accessing'!
  847. callback
  848. ^ callback ifNil: [ [] ]
  849. !
  850. callback: aBlock
  851. callback := aBlock
  852. ! !
  853. !HLTabListWidget methodsFor: 'actions'!
  854. selectItem: aTab
  855. super selectItem: aTab.
  856. self callback value: aTab
  857. ! !
  858. !HLTabListWidget methodsFor: 'rendering'!
  859. renderItemLabel: aTab on: html
  860. html span
  861. class: aTab cssClass;
  862. with: aTab label
  863. ! !
  864. HLWidget subclass: #HLInformationWidget
  865. instanceVariableNames: 'informationString'
  866. package: 'Helios-Core'!
  867. !HLInformationWidget commentStamp!
  868. I display an information dialog.
  869. ## API
  870. `HLWidget >> #inform:` is a convenience method for creating information dialogs.!
  871. !HLInformationWidget methodsFor: 'accessing'!
  872. informationString
  873. ^ informationString ifNil: [ '' ]
  874. !
  875. informationString: anObject
  876. informationString := anObject
  877. ! !
  878. !HLInformationWidget methodsFor: 'actions'!
  879. remove
  880. [
  881. self wrapper asJQuery fadeOut: 100.
  882. [ self wrapper asJQuery remove ]
  883. valueWithTimeout: 400.
  884. ]
  885. valueWithTimeout: 1500
  886. !
  887. show
  888. self appendToJQuery: 'body' asJQuery
  889. ! !
  890. !HLInformationWidget methodsFor: 'rendering'!
  891. renderContentOn: html
  892. html div
  893. class: 'growl';
  894. with: self informationString.
  895. self remove
  896. ! !
  897. HLWidget subclass: #HLManager
  898. instanceVariableNames: 'tabsWidget environment history announcer'
  899. package: 'Helios-Core'!
  900. !HLManager methodsFor: 'accessing'!
  901. activeTab
  902. ^ self tabsWidget activeTab
  903. !
  904. announcer
  905. ^ announcer ifNil: [ announcer := Announcer new ]
  906. !
  907. environment
  908. "The default environment used by all Helios objects"
  909. ^ environment ifNil: [ environment := self defaultEnvironment ]
  910. !
  911. environment: anEnvironment
  912. environment := anEnvironment
  913. !
  914. history
  915. ^ history ifNil: [ history := OrderedCollection new ]
  916. !
  917. history: aCollection
  918. history := aCollection
  919. !
  920. keyBinder
  921. ^ HLKeyBinder current
  922. !
  923. setEditorTheme: aTheme
  924. 'helios.editorTheme' asSetting value: aTheme
  925. !
  926. setTheme: aTheme
  927. | currentTheme |
  928. currentTheme := 'helios.theme' asSettingIfAbsent: 'default'.
  929. 'body' asJQuery
  930. removeClass: currentTheme value;
  931. addClass: aTheme.
  932. 'helios.theme' asSetting value: aTheme
  933. !
  934. tabWidth
  935. ^ (window asJQuery width - 90) / self tabs size
  936. !
  937. tabs
  938. ^ self tabsWidget tabs
  939. !
  940. tabsWidget
  941. ^ tabsWidget ifNil: [ tabsWidget := HLTabsWidget new ]
  942. ! !
  943. !HLManager methodsFor: 'actions'!
  944. activate: aTab
  945. self tabsWidget activate: aTab
  946. !
  947. addTab: aTab
  948. self tabsWidget addTab: aTab
  949. !
  950. confirm: aString ifFalse: aBlock
  951. self
  952. confirm: aString
  953. ifTrue: []
  954. ifFalse: aBlock
  955. !
  956. confirm: aString ifTrue: aBlock
  957. self
  958. confirm: aString
  959. ifTrue: aBlock
  960. ifFalse: []
  961. !
  962. confirm: aString ifTrue: aBlock ifFalse: anotherBlock
  963. HLConfirmationWidget new
  964. confirmationString: aString;
  965. actionBlock: aBlock;
  966. cancelBlock: anotherBlock;
  967. show
  968. !
  969. inform: aString
  970. HLInformationWidget new
  971. informationString: aString;
  972. show
  973. !
  974. removeActiveTab
  975. self tabsWidget removeActiveTab
  976. !
  977. removeTabForWidget: aWidget
  978. self tabsWidget removeTabForWidget: aWidget
  979. !
  980. request: aString do: aBlock
  981. self
  982. request: aString
  983. value: ''
  984. do: aBlock
  985. !
  986. request: aString value: valueString do: aBlock
  987. HLRequestWidget new
  988. confirmationString: aString;
  989. actionBlock: aBlock;
  990. value: valueString;
  991. show
  992. ! !
  993. !HLManager methodsFor: 'defaults'!
  994. defaultEnvironment
  995. "If helios is loaded from within a frame, answer the parent window environment"
  996. | parent parentSmalltalkGlobals |
  997. parent := window opener ifNil: [ window parent ].
  998. parent ifNil: [ ^ Environment new ].
  999. [ parentSmalltalkGlobals := ((parent at: 'requirejs') value: 'amber/boot') at: 'globals' ]
  1000. on: Error do: [ parentSmalltalkGlobals := (parent at: 'requirejs') value: 'amber_vm/globals' ].
  1001. parentSmalltalkGlobals ifNil: [ ^ Environment new ].
  1002. ^ (parentSmalltalkGlobals at: 'Environment') new
  1003. ! !
  1004. !HLManager methodsFor: 'initialization'!
  1005. setup
  1006. self
  1007. registerServices;
  1008. setupEvents.
  1009. self keyBinder setupEvents.
  1010. self tabsWidget setupEvents.
  1011. self setupTheme.
  1012. '#helper' asJQuery fadeOut
  1013. ! !
  1014. !HLManager methodsFor: 'private'!
  1015. registerServices
  1016. self
  1017. registerInspector;
  1018. registerErrorHandler;
  1019. registerProgressHandler;
  1020. registerTranscript;
  1021. registerFinder
  1022. !
  1023. setupEvents
  1024. 'body' asJQuery keydown: [ :event |
  1025. "On ctrl keydown, adds a 'navigation' css class to <body>
  1026. for the CodeMirror navigation links. See `HLCodeWidget`."
  1027. event ctrlKey ifTrue: [
  1028. 'body' asJQuery addClass: 'navigation' ] ].
  1029. 'body' asJQuery keyup: [ :event |
  1030. 'body' asJQuery removeClass: 'navigation' ].
  1031. window asJQuery resize: [ :event |
  1032. self refresh ]
  1033. !
  1034. setupTheme
  1035. "self
  1036. setTheme: 'niflheim';
  1037. setEditorTheme: 'niflheim'."
  1038. self
  1039. setTheme: 'default';
  1040. setEditorTheme: 'default'.
  1041. ! !
  1042. !HLManager methodsFor: 'rendering'!
  1043. renderContentOn: html
  1044. html with: self tabsWidget.
  1045. html with: HLWelcomeWidget new
  1046. ! !
  1047. !HLManager methodsFor: 'services'!
  1048. registerErrorHandler
  1049. self environment registerErrorHandler: HLErrorHandler new.
  1050. ErrorHandler register: HLErrorHandler new
  1051. !
  1052. registerFinder
  1053. self environment registerFinder: HLFinder new.
  1054. Finder register: HLFinder new
  1055. !
  1056. registerInspector
  1057. self environment registerInspector: HLInspector.
  1058. Inspector register: HLInspector
  1059. !
  1060. registerProgressHandler
  1061. self environment registerProgressHandler: HLProgressHandler new.
  1062. ProgressHandler register: HLProgressHandler new
  1063. !
  1064. registerTranscript
  1065. self environment registerTranscript: HLTranscriptHandler
  1066. ! !
  1067. HLManager class instanceVariableNames: 'current'!
  1068. !HLManager class methodsFor: 'accessing'!
  1069. current
  1070. ^ current ifNil: [ current := self basicNew initialize ]
  1071. ! !
  1072. !HLManager class methodsFor: 'initialization'!
  1073. setup
  1074. self current
  1075. setup;
  1076. appendToJQuery: 'body' asJQuery.
  1077. window onbeforeunload:[ 'Do you want to close Amber? All uncommitted changes will be lost.' ]
  1078. ! !
  1079. !HLManager class methodsFor: 'instance creation'!
  1080. new
  1081. "Use current instead"
  1082. self shouldNotImplement
  1083. ! !
  1084. HLWidget subclass: #HLModalWidget
  1085. instanceVariableNames: ''
  1086. package: 'Helios-Core'!
  1087. !HLModalWidget commentStamp!
  1088. I implement an abstract modal widget.!
  1089. !HLModalWidget methodsFor: 'actions'!
  1090. remove
  1091. '.dialog' asJQuery removeClass: 'active'.
  1092. [
  1093. '#overlay' asJQuery remove.
  1094. wrapper asJQuery remove
  1095. ] valueWithTimeout: 300
  1096. !
  1097. show
  1098. self appendToJQuery: 'body' asJQuery
  1099. ! !
  1100. !HLModalWidget methodsFor: 'private'!
  1101. giveFocusToButton: aButton
  1102. aButton asJQuery focus
  1103. ! !
  1104. !HLModalWidget methodsFor: 'rendering'!
  1105. hasButtons
  1106. ^ true
  1107. !
  1108. renderButtonsOn: html
  1109. !
  1110. renderContentOn: html
  1111. | confirmButton |
  1112. html div id: 'overlay'.
  1113. html div
  1114. class: 'dialog ', self cssClass;
  1115. with: [
  1116. self renderMainOn: html.
  1117. self hasButtons ifTrue: [
  1118. self renderButtonsOn: html ] ].
  1119. '.dialog' asJQuery addClass: 'active'.
  1120. self setupKeyBindings
  1121. !
  1122. renderMainOn: html
  1123. !
  1124. setupKeyBindings
  1125. '.dialog' asJQuery keyup: [ :e |
  1126. e keyCode = String esc asciiValue ifTrue: [ self cancel ] ]
  1127. ! !
  1128. HLModalWidget subclass: #HLConfirmationWidget
  1129. instanceVariableNames: 'cancelButtonLabel confirmButtonLabel confirmationString actionBlock cancelBlock'
  1130. package: 'Helios-Core'!
  1131. !HLConfirmationWidget commentStamp!
  1132. I display confirmation dialog.
  1133. ## API
  1134. HLWidget contains convenience methods like `HLWidget >> #confirm:ifTrue:` for creating confirmation dialogs.!
  1135. !HLConfirmationWidget methodsFor: 'accessing'!
  1136. actionBlock
  1137. ^ actionBlock ifNil: [ [] ]
  1138. !
  1139. actionBlock: aBlock
  1140. actionBlock := aBlock
  1141. !
  1142. cancelBlock
  1143. ^ cancelBlock ifNil: [ [] ]
  1144. !
  1145. cancelBlock: aBlock
  1146. cancelBlock := aBlock
  1147. !
  1148. cancelButtonLabel
  1149. ^ cancelButtonLabel ifNil: [ 'Cancel' ]
  1150. !
  1151. cancelButtonLabel: aString
  1152. ^ cancelButtonLabel := aString
  1153. !
  1154. confirmButtonLabel
  1155. ^ confirmButtonLabel ifNil: [ 'Confirm' ]
  1156. !
  1157. confirmButtonLabel: aString
  1158. ^ confirmButtonLabel := aString
  1159. !
  1160. confirmationString
  1161. ^ confirmationString ifNil: [ 'Confirm' ]
  1162. !
  1163. confirmationString: aString
  1164. confirmationString := aString
  1165. ! !
  1166. !HLConfirmationWidget methodsFor: 'actions'!
  1167. cancel
  1168. self cancelBlock value.
  1169. self remove
  1170. !
  1171. confirm
  1172. self remove.
  1173. self actionBlock value
  1174. ! !
  1175. !HLConfirmationWidget methodsFor: 'rendering'!
  1176. renderButtonsOn: html
  1177. | confirmButton |
  1178. html div
  1179. class: 'buttons';
  1180. with: [
  1181. html button
  1182. class: 'button';
  1183. with: self cancelButtonLabel;
  1184. onClick: [ self cancel ].
  1185. confirmButton := html button
  1186. class: 'button default';
  1187. with: self confirmButtonLabel;
  1188. onClick: [ self confirm ] ].
  1189. self giveFocusToButton:confirmButton
  1190. !
  1191. renderMainOn: html
  1192. html span
  1193. class: 'head';
  1194. with: self confirmationString
  1195. ! !
  1196. HLConfirmationWidget subclass: #HLRequestWidget
  1197. instanceVariableNames: 'input multiline value'
  1198. package: 'Helios-Core'!
  1199. !HLRequestWidget commentStamp!
  1200. I display a modal window requesting user input.
  1201. ## API
  1202. `HLWidget >> #request:do:` and `#request:value:do:` are convenience methods for creating modal request dialogs.!
  1203. !HLRequestWidget methodsFor: 'accessing'!
  1204. beMultiline
  1205. multiline := true
  1206. !
  1207. beSingleline
  1208. multiline := false
  1209. !
  1210. cssClass
  1211. ^ 'large'
  1212. !
  1213. value
  1214. ^ value ifNil: [ '' ]
  1215. !
  1216. value: aString
  1217. value := aString
  1218. ! !
  1219. !HLRequestWidget methodsFor: 'actions'!
  1220. confirm
  1221. | val |
  1222. val := input asJQuery val.
  1223. self remove.
  1224. self actionBlock value: val
  1225. ! !
  1226. !HLRequestWidget methodsFor: 'private'!
  1227. giveFocusToButton: aButton
  1228. ! !
  1229. !HLRequestWidget methodsFor: 'rendering'!
  1230. renderMainOn: html
  1231. super renderMainOn: html.
  1232. self isMultiline
  1233. ifTrue: [ input := html textarea ]
  1234. ifFalse: [ input := html input
  1235. type: 'text';
  1236. onKeyDown: [ :event |
  1237. event keyCode = 13 ifTrue: [
  1238. self confirm ] ];
  1239. yourself ].
  1240. input asJQuery
  1241. val: self value;
  1242. focus
  1243. ! !
  1244. !HLRequestWidget methodsFor: 'testing'!
  1245. isMultiline
  1246. ^ multiline ifNil: [ true ]
  1247. ! !
  1248. HLModalWidget subclass: #HLProgressWidget
  1249. instanceVariableNames: 'progressBars visible'
  1250. package: 'Helios-Core'!
  1251. !HLProgressWidget commentStamp!
  1252. I am a widget used to display progress modal dialogs.
  1253. My default instance is accessed with `HLProgressWidget class >> #default`.
  1254. See `HLProgressHandler` for usage.!
  1255. !HLProgressWidget methodsFor: 'accessing'!
  1256. progressBars
  1257. ^ progressBars ifNil: [ progressBars := OrderedCollection new ]
  1258. ! !
  1259. !HLProgressWidget methodsFor: 'actions'!
  1260. addProgressBar: aProgressBar
  1261. self show.
  1262. self progressBars add: aProgressBar.
  1263. aProgressBar appendToJQuery: (self wrapper asJQuery find: '.dialog')
  1264. !
  1265. do: aBlock on: aCollection displaying: aString
  1266. | progressBar |
  1267. progressBar := HLProgressBarWidget new
  1268. parent: self;
  1269. label: aString;
  1270. workBlock: aBlock;
  1271. collection: aCollection;
  1272. yourself.
  1273. self addProgressBar: progressBar.
  1274. progressBar start
  1275. !
  1276. flush
  1277. self progressBars do: [ :each |
  1278. self removeProgressBar: each ]
  1279. !
  1280. remove
  1281. self isVisible ifTrue: [
  1282. visible := false.
  1283. super remove ]
  1284. !
  1285. removeProgressBar: aProgressBar
  1286. self progressBars remove: aProgressBar ifAbsent: [].
  1287. aProgressBar wrapper asJQuery remove.
  1288. self progressBars ifEmpty: [ self remove ]
  1289. !
  1290. show
  1291. self isVisible ifFalse: [
  1292. visible := true.
  1293. super show ]
  1294. ! !
  1295. !HLProgressWidget methodsFor: 'rendering'!
  1296. renderMainOn: html
  1297. self progressBars do: [ :each |
  1298. html with: each ]
  1299. ! !
  1300. !HLProgressWidget methodsFor: 'testing'!
  1301. hasButtons
  1302. ^ false
  1303. !
  1304. isVisible
  1305. ^ visible ifNil: [ false ]
  1306. ! !
  1307. HLProgressWidget class instanceVariableNames: 'default'!
  1308. !HLProgressWidget class methodsFor: 'accessing'!
  1309. default
  1310. ^ default ifNil: [ default := self new ]
  1311. ! !
  1312. HLModalWidget subclass: #HLTabSelectionWidget
  1313. instanceVariableNames: 'tabs tabList selectedTab selectCallback cancelCallback confirmCallback'
  1314. package: 'Helios-Core'!
  1315. !HLTabSelectionWidget commentStamp!
  1316. I am a modal window used to select or create tabs.!
  1317. !HLTabSelectionWidget methodsFor: 'accessing'!
  1318. cancelCallback
  1319. ^ cancelCallback ifNil: [ [] ]
  1320. !
  1321. cancelCallback: aBlock
  1322. cancelCallback := aBlock
  1323. !
  1324. confirmCallback
  1325. ^ confirmCallback ifNil: [ [] ]
  1326. !
  1327. confirmCallback: aBlock
  1328. confirmCallback := aBlock
  1329. !
  1330. selectCallback
  1331. ^ selectCallback ifNil: [ [] ]
  1332. !
  1333. selectCallback: aBlock
  1334. selectCallback := aBlock
  1335. !
  1336. selectedTab
  1337. ^ selectedTab
  1338. !
  1339. selectedTab: aTab
  1340. selectedTab := aTab
  1341. !
  1342. tabs
  1343. ^ tabs ifNil: [ #() ]
  1344. !
  1345. tabs: aCollection
  1346. tabs := aCollection
  1347. ! !
  1348. !HLTabSelectionWidget methodsFor: 'actions'!
  1349. cancel
  1350. self remove.
  1351. self cancelCallback value
  1352. !
  1353. confirm
  1354. self remove.
  1355. self confirmCallback value: self selectedTab
  1356. !
  1357. selectTab: aTab
  1358. self selectedTab: aTab.
  1359. self selectCallback value: aTab
  1360. !
  1361. setupKeyBindings
  1362. super setupKeyBindings.
  1363. '.dialog' asJQuery keyup: [ :e |
  1364. e keyCode = String cr asciiValue ifTrue: [ self confirm ] ]
  1365. ! !
  1366. !HLTabSelectionWidget methodsFor: 'rendering'!
  1367. renderButtonsOn: html
  1368. | confirmButton |
  1369. html div
  1370. class: 'buttons';
  1371. with: [
  1372. html button
  1373. class: 'button';
  1374. with: 'Cancel';
  1375. onClick: [ self cancel ].
  1376. confirmButton := html button
  1377. class: 'button default';
  1378. with: 'Select tab';
  1379. onClick: [ self confirm ] ].
  1380. self giveFocusToButton:confirmButton
  1381. !
  1382. renderContentOn: html
  1383. super renderContentOn: html.
  1384. self tabList focus
  1385. !
  1386. renderMainOn: html
  1387. html div
  1388. class: 'title';
  1389. with: 'Tab selection'.
  1390. html with: self tabList
  1391. !
  1392. renderTab: aTab on: html
  1393. html
  1394. span
  1395. class: aTab cssClass;
  1396. with: aTab label
  1397. !
  1398. renderTabsOn: html
  1399. self tabs do: [ :each |
  1400. html li with: [
  1401. html a
  1402. with: [
  1403. self renderTab: each on: html ];
  1404. onClick: [ self selectTab: each ] ] ]
  1405. !
  1406. tabList
  1407. tabList ifNil: [
  1408. tabList := HLTabListWidget new.
  1409. tabList
  1410. callback: [ :tab | self selectTab: tab. tabList focus ];
  1411. selectedItem: self selectedTab;
  1412. items: self tabs ].
  1413. ^ tabList
  1414. ! !
  1415. HLWidget subclass: #HLProgressBarWidget
  1416. instanceVariableNames: 'label parent workBlock collection bar'
  1417. package: 'Helios-Core'!
  1418. !HLProgressBarWidget commentStamp!
  1419. I am a widget used to display a progress bar while iterating over a collection.!
  1420. !HLProgressBarWidget methodsFor: 'accessing'!
  1421. collection
  1422. ^ collection
  1423. !
  1424. collection: aCollection
  1425. collection := aCollection
  1426. !
  1427. label
  1428. ^ label
  1429. !
  1430. label: aString
  1431. label := aString
  1432. !
  1433. parent
  1434. ^ parent
  1435. !
  1436. parent: aProgress
  1437. parent := aProgress
  1438. !
  1439. workBlock
  1440. ^ workBlock
  1441. !
  1442. workBlock: aBlock
  1443. workBlock := aBlock
  1444. ! !
  1445. !HLProgressBarWidget methodsFor: 'actions'!
  1446. evaluateAt: anInteger
  1447. self updateProgress: (anInteger / self collection size) * 100.
  1448. anInteger <= self collection size
  1449. ifTrue: [
  1450. [
  1451. self workBlock value: (self collection at: anInteger).
  1452. self evaluateAt: anInteger + 1 ] valueWithTimeout: 10 ]
  1453. ifFalse: [ [ self remove ] valueWithTimeout: 500 ]
  1454. !
  1455. remove
  1456. self parent removeProgressBar: self
  1457. !
  1458. start
  1459. "Make sure the UI has some time to update itself between each iteration"
  1460. self evaluateAt: 1
  1461. !
  1462. updateProgress: anInteger
  1463. bar asJQuery css: 'width' put: anInteger asString, '%'
  1464. ! !
  1465. !HLProgressBarWidget methodsFor: 'rendering'!
  1466. renderContentOn: html
  1467. html span with: self label.
  1468. html div
  1469. class: 'progress';
  1470. with: [
  1471. bar := html div
  1472. class: 'bar';
  1473. style: 'width: 0%' ]
  1474. ! !
  1475. HLProgressBarWidget class instanceVariableNames: 'default'!
  1476. !HLProgressBarWidget class methodsFor: 'accessing'!
  1477. default
  1478. ^ default ifNil: [ default := self new ]
  1479. ! !
  1480. HLWidget subclass: #HLTabWidget
  1481. instanceVariableNames: 'widget label root'
  1482. package: 'Helios-Core'!
  1483. !HLTabWidget commentStamp!
  1484. I am a widget specialized into building another widget as an Helios tab.
  1485. I should not be used directly, `HLWidget class >> #openAsTab` should be used instead.
  1486. ## Example
  1487. HLWorkspace openAsTab!
  1488. !HLTabWidget methodsFor: 'accessing'!
  1489. activate
  1490. self manager activate: self
  1491. !
  1492. cssClass
  1493. ^ self widget tabClass
  1494. !
  1495. focus
  1496. self widget canHaveFocus ifTrue: [
  1497. self widget focus ]
  1498. !
  1499. label
  1500. ^ label ifNil: [ '' ]
  1501. !
  1502. label: aString
  1503. label := aString
  1504. !
  1505. manager
  1506. ^ HLManager current
  1507. !
  1508. widget
  1509. ^ widget
  1510. !
  1511. widget: aWidget
  1512. widget := aWidget
  1513. ! !
  1514. !HLTabWidget methodsFor: 'actions'!
  1515. add
  1516. self manager addTab: self.
  1517. self observeManager
  1518. !
  1519. hide
  1520. root ifNotNil: [ root asJQuery css: 'visibility' put: 'hidden' ]
  1521. !
  1522. observeManager
  1523. self manager announcer
  1524. on: HLTabLabelChanged
  1525. send: #onTabLabelChanged:
  1526. to: self
  1527. !
  1528. registerBindings
  1529. self widget registerBindings
  1530. !
  1531. remove
  1532. self unregister.
  1533. self widget unregister.
  1534. root ifNotNil: [ root asJQuery remove ]
  1535. !
  1536. show
  1537. root
  1538. ifNil: [ self appendToJQuery: 'body' asJQuery ]
  1539. ifNotNil: [ root asJQuery css: 'visibility' put: 'visible' ]
  1540. !
  1541. unregister
  1542. self manager announcer unsubscribe: self
  1543. ! !
  1544. !HLTabWidget methodsFor: 'reactions'!
  1545. onTabLabelChanged: anAnnouncement
  1546. anAnnouncement widget = self widget ifTrue: [
  1547. self label = anAnnouncement label ifFalse: [
  1548. self label: anAnnouncement label.
  1549. self manager refresh ] ]
  1550. ! !
  1551. !HLTabWidget methodsFor: 'rendering'!
  1552. renderOn: html
  1553. root := html div
  1554. class: 'tab';
  1555. yourself.
  1556. self renderTab
  1557. !
  1558. renderTab
  1559. root contents: [ :html |
  1560. html div
  1561. class: 'amber_box';
  1562. with: [ self widget renderOn: html ] ]
  1563. ! !
  1564. !HLTabWidget methodsFor: 'testing'!
  1565. isActive
  1566. ^ self manager activeTab = self
  1567. ! !
  1568. !HLTabWidget class methodsFor: 'instance creation'!
  1569. on: aWidget labelled: aString
  1570. ^ self new
  1571. widget: aWidget;
  1572. label: aString;
  1573. yourself
  1574. ! !
  1575. HLWidget subclass: #HLTabsWidget
  1576. instanceVariableNames: 'tabs activeTab history selectionDisabled'
  1577. package: 'Helios-Core'!
  1578. !HLTabsWidget methodsFor: 'accessing'!
  1579. activeTab
  1580. ^ activeTab
  1581. !
  1582. history
  1583. ^ history ifNil: [ history := OrderedCollection new ]
  1584. !
  1585. history: aCollection
  1586. history := aCollection
  1587. !
  1588. tabWidth
  1589. ^ (window asJQuery width - 90) / self tabs size
  1590. !
  1591. tabs
  1592. ^ tabs ifNil: [ tabs := OrderedCollection new ]
  1593. ! !
  1594. !HLTabsWidget methodsFor: 'actions'!
  1595. activate: aTab
  1596. self isSelectionDisabled ifTrue: [ ^ self ].
  1597. self manager keyBinder flushBindings.
  1598. aTab registerBindings.
  1599. activeTab := aTab.
  1600. self
  1601. refresh;
  1602. addToHistory: aTab;
  1603. show: aTab
  1604. !
  1605. activateNextTab
  1606. | nextTab |
  1607. self tabs ifEmpty: [ ^ self ].
  1608. nextTab := self tabs
  1609. at: (self tabs indexOf: self activeTab) + 1
  1610. ifAbsent: [ self tabs first ].
  1611. self activate: nextTab
  1612. !
  1613. activatePreviousTab
  1614. | previousTab |
  1615. self tabs ifEmpty: [ ^ self ].
  1616. previousTab := self tabs
  1617. at: (self tabs indexOf: self activeTab) - 1
  1618. ifAbsent: [ self tabs last ].
  1619. self activate: previousTab
  1620. !
  1621. addTab: aTab
  1622. self tabs add: aTab.
  1623. self activate: aTab
  1624. !
  1625. addToHistory: aTab
  1626. self removeFromHistory: aTab.
  1627. self history add: aTab
  1628. !
  1629. disableSelection
  1630. selectionDisabled := true
  1631. !
  1632. enableSelection
  1633. selectionDisabled := false
  1634. !
  1635. removeActiveTab
  1636. self removeTab: self activeTab
  1637. !
  1638. removeFromHistory: aTab
  1639. self history: (self history reject: [ :each | each == aTab ])
  1640. !
  1641. removeTab: aTab
  1642. (self tabs includes: aTab) ifFalse: [ ^ self ].
  1643. self removeFromHistory: aTab.
  1644. self tabs remove: aTab.
  1645. self manager keyBinder flushBindings.
  1646. aTab remove.
  1647. self refresh.
  1648. self history ifNotEmpty: [
  1649. self history last activate ]
  1650. !
  1651. removeTabForWidget: aWidget
  1652. self removeTab: (self tabs
  1653. detect: [ :each | each widget = aWidget ]
  1654. ifNone: [ ^ self ])
  1655. !
  1656. updateTabsOrder
  1657. tabs := '.main-tabs li' asJQuery toArray
  1658. collect: [ :each | each at: 'tab-data' ]
  1659. ! !
  1660. !HLTabsWidget methodsFor: 'private'!
  1661. setupEvents
  1662. 'body' asJQuery keydown: [ :event |
  1663. "ctrl+> and ctrl+<"
  1664. (event ctrlKey and: [ event which = 188 ]) ifTrue: [
  1665. self activatePreviousTab.
  1666. event preventDefault ].
  1667. (event ctrlKey and: [ event which = 190 ]) ifTrue: [
  1668. self activateNextTab.
  1669. event preventDefault ] ]
  1670. ! !
  1671. !HLTabsWidget methodsFor: 'rendering'!
  1672. renderAddOn: html
  1673. html div
  1674. class: 'dropdown new_tab';
  1675. with: [
  1676. html a
  1677. class: 'dropdown-toggle';
  1678. at: 'data-toggle' put: 'dropdown';
  1679. with: [
  1680. (html tag: 'b') class: 'caret' ].
  1681. html ul
  1682. class: 'dropdown-menu';
  1683. with: [
  1684. ((HLWidget withAllSubclasses
  1685. select: [ :each | each canBeOpenAsTab ])
  1686. sorted: [ :a :b | a tabPriority < b tabPriority ])
  1687. do: [ :each |
  1688. html li with: [
  1689. html a
  1690. with: each tabLabel;
  1691. onClick: [ each openAsTab ] ] ] ] ]
  1692. !
  1693. renderContentOn: html
  1694. html div
  1695. class: 'navbar navbar-fixed-top';
  1696. with: [ html div
  1697. class: 'navbar-inner';
  1698. with: [ self renderTabsOn: html ] ].
  1699. self renderAddOn: html
  1700. !
  1701. renderTab: aTab on: html
  1702. | li |
  1703. li := html li
  1704. style: 'width: ', self tabWidth asString, 'px';
  1705. class: (aTab isActive ifTrue: [ 'tab active' ] ifFalse: [ 'tab inactive' ]);
  1706. with: [
  1707. html a
  1708. with: [
  1709. ((html tag: 'i') class: 'close')
  1710. onClick: [ self removeTab: aTab ].
  1711. html span
  1712. class: aTab cssClass;
  1713. title: aTab label;
  1714. with: aTab label ] ];
  1715. onClick: [ aTab activate ].
  1716. (li asJQuery get: 0) at: 'tab-data' put: aTab
  1717. !
  1718. renderTabsOn: html
  1719. | ul |
  1720. ul := html ul
  1721. class: 'nav main-tabs';
  1722. with: [
  1723. self tabs do: [ :each |
  1724. self renderTab: each on: html ] ].
  1725. ul asJQuery sortable: #{
  1726. 'containment' -> 'parent'.
  1727. 'start' -> [ self disableSelection ].
  1728. 'stop' -> [ [ self enableSelection] valueWithTimeout: 300 ].
  1729. 'update' -> [ self updateTabsOrder ]
  1730. }
  1731. !
  1732. show: aTab
  1733. self tabs do: [ :each | each hide ].
  1734. aTab show; focus
  1735. ! !
  1736. !HLTabsWidget methodsFor: 'testing'!
  1737. isSelectionDisabled
  1738. ^ selectionDisabled ifNil: [ false ]
  1739. ! !
  1740. HLTabsWidget class instanceVariableNames: 'current'!
  1741. HLWidget subclass: #HLWelcomeWidget
  1742. instanceVariableNames: ''
  1743. package: 'Helios-Core'!
  1744. !HLWelcomeWidget methodsFor: 'accessing'!
  1745. cssClass
  1746. ^ 'welcome'
  1747. ! !
  1748. !HLWelcomeWidget methodsFor: 'actions'!
  1749. openClassBrowser
  1750. HLBrowser openAsTab
  1751. !
  1752. openHelp
  1753. !
  1754. openTestRunner
  1755. HLSUnit openAsTab
  1756. !
  1757. openWorkspace
  1758. HLWorkspace openAsTab
  1759. ! !
  1760. !HLWelcomeWidget methodsFor: 'rendering'!
  1761. renderButtonsOn: html
  1762. html button
  1763. class: 'button';
  1764. with: 'Class Browser';
  1765. onClick: [ self openClassBrowser ].
  1766. html button
  1767. class: 'button';
  1768. with: 'Workspace';
  1769. onClick: [ self openWorkspace ].
  1770. html button
  1771. class: 'button';
  1772. with: 'Test Runner';
  1773. onClick: [ self openTestRunner ].
  1774. "html button
  1775. class: 'button';
  1776. with: 'Help';
  1777. onClick: [ self openHelp ]"
  1778. !
  1779. renderContentOn: html
  1780. self
  1781. renderHelpOn: html;
  1782. renderButtonsOn: html
  1783. !
  1784. renderHelpOn: html
  1785. html h2 with: 'No tools are open'.
  1786. html ul with: [
  1787. html li with: 'Perform actions with ctrl + space'.
  1788. html li with: 'Open one of the common tools:' ]
  1789. ! !