Difference between revisions of "Specification search toolbar"
Robertzhou (Talk | contribs) (→Whole Word Button) |
Robertzhou (Talk | contribs) (→7. "Whole Word" CheckBox) |
||
| Line 432: | Line 432: | ||
| − | + | The Whole Word Cis a check box button, after it is selected , searching text will match the whole word to find in the current document. When the whole word searching text not exist , he Dynamic Text Info2 will shown “ phrase not found” information. | |
| − | The Whole Word Cis a check box button, after it is selected , searching text will match the whole word to find in the current document. When the whole word searching text not exist , he Dynamic Text Info2 will shown “ phrase not found” information | + | |
=== Dynamic Text Info1 === | === Dynamic Text Info1 === | ||
Revision as of 02:56, 24 April 2009
This page exists to implemente a search toolbar for OOo. (The specifications can be created using the Specification template)
The Search tool bar is tool bar which will provider search quickly text feature(like firfox search toolbar), it includes searching text, backwards searching, forward searching, Match of lowercase or uppercase, Match the Whole word and Closer button. It can be closed by mouse or pressing a Keyboard shortcut.
Any discussion of the specification should happen in the maillist(discuss@ux.openoffice.org), or on the discussion pages.
Contents
- 1 Search toolbar
- 2 Swriter Scalc Impress Drawing
- 2.1 Abstract
- 2.2 i-Team Members (The specification owner is part of the i-Team)
- 2.3 Approved for Implementation
- 2.4 Document Change History
- 2.5 Glossary
- 2.6 Motivation
- 2.7 User Scenarios
- 2.8 Goals
- 2.9 Requirements and Dependencies
- 2.10 Competitive Analyses
- 2.11 Detailed Specification
- 2.12 Future Tasks
- 2.13 Notes
- 2.14 References
Search toolbar
Swriter Scalc Impress Drawing
| Document - ID | Specification Owner | Last Change | Status |
| Shizhoubo | 2009-04-22 | Draft | |
| Conforms to | |||
| Applies to | Swriter, Scalc, Impress, Drawing | ||
| Task ID(s) | None | ||
| Category | Feature |
Abstract
The Search tool bar is tool bar which will provider search quickly text feature(like fireforx toolbar), it includes searching text, backwards searching, forward searching, Match of lowercase or uppercase, Match the Whole word and Closer button. It can be closed by mouse or pressing a Keyboard shortcut.
i-Team Members (The specification owner is part of the i-Team)
| Name | E-mail Address | |
| User Experience | Jaron Kuppers (Jaron),Philip Ganchev(Philip) | jaronbaron@gmail.com, phil.ganchev@gmail.com |
| Development | shizhoubo(robertzhou) | shizhoubo@redoffice.com |
| Quality Assurance | <Name + Initials> | |
| Documentation | shizhoubo(robertzhou) | shizhoubo@redoffice.com |
Approved for Implementation
| Approved by | Date | |
| User Experience | <Name> | <Date> |
| Development | <Name> | <Date> |
| Quality Assurance | <Name> | <Date> |
| Documentation | <Name> | <Date> |
| String Review | <Name> | <Date> |
Document Change History
| Rev. Level | Change | Initials | Date |
| 1.0 | initial version | 2009-04-23 |
Glossary
| Term | Description |
Motivation
The motivation for this feature is to enhance the speed of searching text ,and the search tool bar does not hid the content of the document.
User Scenarios
In current OpenOffice.org ,users use the search dialog to search text, when the users want to see content which the search dialog hid, the uses have to move the search dialog via mouse,because the search dialog always display.
Goals
The goal for OpenOffice.org 3.x is to provide a tool bar which gives uses the possibility to apply frequently uesed for searching text. The search tool bar will provide a simple, shortcut way to searching text, without the users not have to open the search dialog.
Requirements and Dependencies
Requirements
Provide a tool bar which gives users the possibility to apply frequently used commands without the opening search dialog.
Technical Dependencies
Implementation of the search tool bar depend on these searching codes which the current search dialog is using the searching codes , but it has nothing to do with the search dialog.
Competitive Analyses
Google Chrome Browser
The Google Chrome Search tool bar (Figure 1,marked by the redline). it is located on the below of the address Tool bar and can't be moved. The Search tool bar can made visible by pressing Ctrl+F. The search toolbar is very simple , it only provide searching text and not match Match Case. It includes backwards searching , forwards searching text and count of the searching text. The Search tool bar organized into a number of buttons or lable which are arranged from the left to the right with it.
Mozilla Firefox Browser
Mozillas Search Tool bar(Figure 2) , It is located at the above of the staus bar and can't be moved .The Search tool bar can made visible by pressing Ctrl+F.
The Search tool bar organized into a number of buttons which are arranged from the left to the right with it. The mouse can opterator any button and every button has states.
Detailed Specification
The OpenOffice Search Tool Bar(Figure3) shall be located at the above of the status bar. And it can't be moved. It can made visible by pressing Ctrl+F1. It is make up of the tool bar item , of course , these tool bar item can be BUTTON_SYMBOLTEXT or BUTTON_SYMBOL.
| Property | State | Comment |
| Toolbar Name: | Search toolbar | |
| 搜索工具栏 | ||
| Has Closer: | No | |
| Style: | Icon/Text | |
| Initial State: | Docked | |
| Initial Docking Position: | Bottom, above the status bar | |
| Initial Floating Position: | None | |
| List in "View/Toolbars": | Yes | |
| Is Context Sensitive: | No | |
| Toolbar Items: | ||
| Item Name: | <EN-US> | |
| <Other Language (Optional)> | ||
| Item Icon: | <Link to Image here> | |
| Action: | <Specify action here. E.g. Finding> | |
| Other Properties: | <Specify properties here> | |
1. "Find" Label
| Property | Label | Comment |
| Label: | Find | EN-US |
The static text info only describe information to explain what the edit controller input. It name “Find”, it only is static text and showed in the searching tool bar. It should support multilingual property.
2. Input for searching TextField
| Property | State | Comment |
| Enabled: | during one of documents is opening | these documents is only swriter,scalc,impress or drawing |
| Disabled: | None | |
| Read Only: | No | |
| Initial String: | Blank space string | |
| String Preselected: | Yes | |
| Caret Position: | <0> | |
| Characters Not Allowed | None | |
| Echo characters (Password Field) | None | |
| TextField Label: | <EN-US> | Here is "Find" label |
The Edit Controller is TextField Controller, users can input searching text in the edit Text, and it always is showed in the searching tool bar. When users did not find searching text in current document, the edit text background color should be set gray which mean not find searching text.
3. "Next" Button
| Property | State | Comment |
| Enabled: | if there is any text content in the TextField Controller, it will be always enabled | |
| Disabled: | if there is nothing text content in the TextField Controller, it will be disabled | |
| On Click: | find backward searching text in the current document | |
| Other: | None | |
| Button Label: | <EN-US> |
The is a simple tool bar item with BUTTON_SYMBOLTEXT type. Users can use to find backward searching text in the current document. When the searching text is showed at end of the document, the The Dynamic Text Info2 will shown “ reached end of document,continue form top” information.
4. "Previous" Button
| Property | State | Comment |
| Enabled: | if there is any text content in the 2.TextField Controller, it will be always enabled | |
| Disabled: | if there is nothing text content in the 2.TextField Controller, it will be disabled | |
| On Click: | Find forwards searching text in the current document | |
| Other: | None | |
| Button Label: | <EN-US> |
The is a simple tool bar item with BUTTON_SYMBOLTEXT type. Users can use to find forwards searching text in the current document. When the searching text is showed at top of the document, the The Dynamic Text Info2 will shown “ reached top of document,continue form end” information.
5. "Search All" Button
| Property | State | Comment |
| Enabled: | if there is any text content in the TextField Controller, it will be always enabled | |
| Disabled: | if there is nothing text content in the TextField Controller, it will be disabled | |
| On Click: | The all searching text will be shown hightlight and selected in the current document | |
| Other: | None | |
| Button Label: | <EN-US> |
The Button is a tool bar item with BUTTON_SYMBOLTEXT type,when users click it, the searching text will be shown hightlight and selected. The “search all button” need not changed states.
6. "Match Case" CheckBox
| Property | State | Comment |
| Enabled: | During the search toolbar is open, it is always enabled | |
| Disabled: | None | |
| Tristate: | ||
| Checked: | Searching text will match case to find in the current document | |
| Other: | None | |
| CheckBox Label: | <EN-US> |
The Match Case CheckBox is a check box button, after the check box is selected, searching text will match case to find in the current document, when searching text may not exist, The Dynamic Text Info2 will shown “ phrase not found” information.
7. "Whole Word" CheckBox
| Property | State | Comment |
| Enabled: | During the searching toolbar is opening. it is always enabled | |
| Disabled: | None | |
| Tristate: | None | |
| Checked: | searching text will match the whole word to find in the current document. | |
| Other: | None | |
| CheckBox Label: | <EN-US> |
The Whole Word Cis a check box button, after it is selected , searching text will match the whole word to find in the current document. When the whole word searching text not exist , he Dynamic Text Info2 will shown “ phrase not found” information.
Dynamic Text Info1
The Dynamic Text info1 is a dynamic string, is show information which means to show count of searching text in the current documents. When user use only “Search all” to find string, the Dynamic Text info2 will be shown , and tell user count of the searching text in the current document. Like following image of red line mark.
Dynamic Text Info2
The Dynamic Text info2 is a dynamic string, is show information which remain following informations to users. “phrase not found “, “ reached top of document,continue form end”, “reached end of document,continue form top” . What the dynamic text is depend to result of searching text.
But the Dynamic Text Info1 and Info2 would support multilingual property.
Close Button
The is tool bar item with only BUTTON_SYMBOL type, it can close the search tool bar.
Future Tasks
None at this time.
Notes
None
References
none
