Difference between revisions of "Specification Common find toolbar"
(→References) |
|||
Line 1: | Line 1: | ||
− | {{Specification_Header|[mailto:Christoph.Lukasiak@Sun.com?subject:OOoWiki Christoph Lukasiak] ([http://wiki.services.openoffice.org/wiki/User:Clu Clu])| | + | {{Specification_Header|[mailto:Christoph.Lukasiak@Sun.com?subject:OOoWiki Christoph Lukasiak] ([http://wiki.services.openoffice.org/wiki/User:Clu Clu])|18. Jan 2010|Preliminary}} |
− | == Abstract == | + | == Abstract == |
− | + | ||
− | + | The 'Common Find toolbar' should be an addition to the 'Find & Replace' dialog, which provides a fast and easy text search without covering the search text. | |
− | + | __TOC__ | |
− | {| | + | == References == |
+ | |||
+ | {| cellspacing="0" cellpadding="4" border="2" style="border: 1px solid rgb(204, 204, 204); margin: 1em 1em 1em 0pt; border-collapse: collapse; width: 100%;" | ||
|- | |- | ||
− | | | + | | bgcolor="#dddddd" width="300" | '''Reference Document''' |
+ | | bgcolor="#dddddd" | '''Check''' | ||
+ | | bgcolor="#dddddd" | '''Location (URL)''' | ||
|- | |- | ||
− | + | | '''[http://wiki.services.openoffice.org/wiki/Specification#Before_Writing_a_Software_Specification_--_What_Else_Do_I_have_to_Do.3F Prerequisites]''' | |
− | | in progress: [passed/failed] | + | | in progress: [passed/failed] |
| n/a | | n/a | ||
|- | |- | ||
− | | '''Product Requirement, RFE, Issue ID''' (required) | + | | '''Product Requirement, RFE, Issue ID''' (required) |
− | | available | + | | available |
| [http://qa.openoffice.org/issues/show_bug.cgi?id=107176 i107176] | | [http://qa.openoffice.org/issues/show_bug.cgi?id=107176 i107176] | ||
|- | |- | ||
− | | '''Accessibility Check''' (required) | + | | '''Accessibility Check''' (required) |
| | | | ||
| See accessibility section for check list | | See accessibility section for check list | ||
|- | |- | ||
− | | '''[[Test case specification]]''' (required) | + | | '''[[Test case specification]]''' (required) |
− | | [available/not available] | + | | [available/not available] |
− | | | + | | <PLEASE ENTER LOCATION HERE> |
|- | |- | ||
− | | IDL Specification | + | | IDL Specification |
− | | [available/not available] | + | | [available/not available] |
− | | | + | | <PLEASE ENTER LOCATION HERE> |
|- | |- | ||
− | | [http://wiki.services.openoffice.org/wiki/The_Three_Golden_Rules_for_Writing_OpenOffice.org_Specifications '''Software Specification Rules'''] | + | | [http://wiki.services.openoffice.org/wiki/The_Three_Golden_Rules_for_Writing_OpenOffice.org_Specifications '''Software Specification Rules'''] |
− | | in progress | + | | in progress |
| n/a | | n/a | ||
|- | |- | ||
− | | Other, e.g. references to related specs, Product Concept Document | + | | Other, e.g. references to related specs, Product Concept Document |
− | | | + | | |
| specification: [http://wiki.services.openoffice.org/wiki/Specification_search_toolbar search toolbar] | | specification: [http://wiki.services.openoffice.org/wiki/Specification_search_toolbar search toolbar] | ||
|- | |- | ||
− | |Release Roadmap OOo 3.3 | + | | Release Roadmap OOo 3.3 |
− | | | + | | |
− | |http://wiki.services.openoffice.org/wiki/OOoRelease33 | + | | http://wiki.services.openoffice.org/wiki/OOoRelease33 |
− | + | ||
|} | |} | ||
− | == Contacts == | + | == Contacts == |
− | {| | + | {| cellspacing="0" cellpadding="4" border="2" style="border: 1px solid rgb(204, 204, 204); margin: 1em 1em 1em 0pt; border-collapse: collapse; width: 100%;" |
|- | |- | ||
− | | | + | | bgcolor="#dddddd" width="300" | '''Role''' |
+ | | bgcolor="#dddddd" | '''Name''' | ||
+ | | bgcolor="#dddddd" | '''E-Mail Address''' | ||
|- | |- | ||
− | | '''Developer''' | + | | '''Developer''' |
− | | Carsten Driesner | + | | Carsten Driesner |
| [mailto:cd@openoffice.org?subject:OOoWiki cd@openoffice.org] | | [mailto:cd@openoffice.org?subject:OOoWiki cd@openoffice.org] | ||
|- | |- | ||
− | | | + | | |
− | | shizhoubo(robertzhou) | + | | shizhoubo(robertzhou) |
− | |[mailto:robertzhou@openoffice.org?subject:OOoWiki robertzhou@openoffice.org] | + | | [mailto:robertzhou@openoffice.org?subject:OOoWiki robertzhou@openoffice.org] |
|- | |- | ||
− | | '''Quality Assurance''' | + | | '''Quality Assurance''' |
| Stefan Baltzer | | Stefan Baltzer | ||
− | |[mailto:sba@openoffice.org?subject:OOoWiki sba@openoffice.org] | + | | [mailto:sba@openoffice.org?subject:OOoWiki sba@openoffice.org] |
|- | |- | ||
− | | '''Documentation''' | + | | '''Documentation''' |
− | | Uwe Fischer | + | | Uwe Fischer |
| [mailto:Uwe.Fischer@sun.com?subject:OOoWiki Uwe.Fischer@sun.com] | | [mailto:Uwe.Fischer@sun.com?subject:OOoWiki Uwe.Fischer@sun.com] | ||
|- | |- | ||
− | | '''Icon Design''' | + | | '''Icon Design''' |
− | | Stella Schulze | + | | Stella Schulze |
| [mailto:Stella.Schulze@sun.com?subject:OOoWiki Stella.Schulze@sun.com] | | [mailto:Stella.Schulze@sun.com?subject:OOoWiki Stella.Schulze@sun.com] | ||
|- | |- | ||
− | | '''User Experience''' | + | | '''User Experience''' |
− | | Christoph Lukasiak | + | | Christoph Lukasiak |
| [mailto:Christoph.Lukasiak@Sun.com?subject:OOoWiki Christoph.Lukasiak@Sun.com] | | [mailto:Christoph.Lukasiak@Sun.com?subject:OOoWiki Christoph.Lukasiak@Sun.com] | ||
|- | |- | ||
| | | | ||
− | | Jaron Kuppers | + | | Jaron Kuppers |
| [mailto:jaronbaron@gmail.com?subject:OOoWiki jaronbaron@gmail.com] | | [mailto:jaronbaron@gmail.com?subject:OOoWiki jaronbaron@gmail.com] | ||
− | |||
|} | |} | ||
− | == Acronyms and Abbreviations == | + | == Acronyms and Abbreviations == |
− | {| | + | |
− | + | {| cellspacing="0" cellpadding="4" border="2" style="border: 1px solid rgb(204, 204, 204); margin: 1em 1em 1em 0pt; border-collapse: collapse; width: 100%;" | |
− | + | ||
|- | |- | ||
− | | | + | | bgcolor="#dddddd" | '''Acronym / Abbreviation''' |
− | | | + | | bgcolor="#dddddd" | '''Definition''' |
|- | |- | ||
+ | | <WYSIWYG> | ||
+ | | <What You See Is What You Get> | ||
|} | |} | ||
− | == Motivation == | + | == Motivation == |
− | + | ||
− | + | From the 'usage tracking' data of the 'find & replace' dialog we have learned that 76% of oo user just want to search inside the text, so we have to propose a fast & easy way to do so. Also it was often mentioned that the search & replace dialog covers the search area in an annoying way, so we must found an other solution for it. The other search settings like 'match case' etc. are used less than 0.1%, so we decided to leave them out in this toolbar, but like the replacing function they will still stay available in the find & replace dialog. | |
− | + | ||
− | + | ||
− | + | ||
− | <br> | + | == Detailed Specification == |
− | === Find Toolbar === | + | |
− | {| | + | [[Image:FindBar2.png]]<br><br> The common find toolbar is a standard toolbar containing a text search field, a next and forward button. It is located right next to the 'application standard' toolbar, is active by default and behave like every other toolbar (d&d, docking etc.).<br> By clicking into the search field, the info text disappear and the search text can be inputted. By entering the search field, the next and the previous button get active. After entering the search text, the search can be started by hitting the return key on keyboard or pushing the 'next' button. If anything is found, the first result is selected and can be edited or the next button can be clicked (is selected) for searching for the next result. If nothing is found (buttons get inactive) or it is searched to the end of the document, you get an info dialog similar to the behavior of the 'find & replace' dialog, like in all other cases, even if it works independent.<br> |
+ | |||
+ | <br> | ||
+ | |||
+ | === Find Toolbar === | ||
+ | |||
+ | {| cellspacing="0" cellpadding="4" border="2" style="border: 1px solid rgb(204, 204, 204); margin: 1em 1em 1em 0pt; border-collapse: collapse; width: 100%;" | ||
|- | |- | ||
− | | | + | | bgcolor="#dddddd" width="200" | '''Property''' |
+ | | bgcolor="#dddddd" | '''State''' | ||
+ | | bgcolor="#dddddd" | '''Comment''' | ||
|- | |- | ||
− | | rowspan="2" | '''Toolbar Name:''' | + | | rowspan="2" | '''Toolbar Name:''' |
| Common Find Toolbar | | Common Find Toolbar | ||
|- | |- | ||
− | | | + | | <Other Language (Optional)> |
| | | | ||
|- | |- | ||
− | | '''Has Closer:''' | + | | '''Has Closer:''' |
− | | no | + | | no |
− | | | + | | |
|- | |- | ||
− | | '''Style:''' | + | | '''Style:''' |
− | | Icon/Icon | + | | Icon/Icon |
− | | | + | | |
|- | |- | ||
− | | '''Initial State:''' | + | | '''Initial State:''' |
− | | docked | + | | docked |
− | | | + | | |
|- | |- | ||
− | | '''Initial Docking Position:''' | + | | '''Initial Docking Position:''' |
− | |next to toolbar 'Standard' | + | | next to toolbar 'Standard' |
− | | | + | | |
|- | |- | ||
− | | '''Initial Floating Position:''' | + | | '''Initial Floating Position:''' |
− | | no | + | | no |
− | | | + | | |
|- | |- | ||
− | | '''List in "View/Toolbars":''' | + | | '''List in "View/Toolbars":''' |
− | | yes | + | | yes |
− | | | + | | |
|- | |- | ||
− | | '''Is Context Sensitive:''' | + | | '''Is Context Sensitive:''' |
− | | no | + | | no |
− | | | + | | |
|} | |} | ||
− | === Find Textfield === | + | === Find Textfield === |
− | {| | + | |
+ | {| cellspacing="0" cellpadding="4" border="2" style="border: 1px solid rgb(204, 204, 204); margin: 1em 1em 1em 0pt; border-collapse: collapse; width: 100%;" | ||
|- | |- | ||
− | | | + | | bgcolor="#dddddd" width="200" | '''Property''' |
+ | | bgcolor="#dddddd" | '''State''' | ||
+ | | bgcolor="#dddddd" | '''Comment''' | ||
|- | |- | ||
− | | '''Enabled:''' | + | | '''Enabled:''' |
− | | always enabled | + | | always enabled |
− | | | + | | |
|- | |- | ||
− | | '''Disabled:''' | + | | '''Disabled:''' |
− | | never disabled | + | | never disabled |
− | | | + | | |
|- | |- | ||
− | | '''Read Only:''' | + | | '''Read Only:''' |
− | | no | + | | no |
− | | | + | | |
|- | |- | ||
− | | '''Initial String:''' | + | | '''Initial String:''' |
− | | Find | + | | Find |
− | |light grey | + | | light grey |
|- | |- | ||
− | | '''String Preselected:''' | + | | '''String Preselected:''' |
− | |no | + | | no |
− | | | + | | |
|- | |- | ||
− | | '''Caret Position:''' | + | | '''Caret Position:''' |
− | | | + | | <0> |
− | | | + | | |
|- | |- | ||
− | | '''Characters Not Allowed''' | + | | '''Characters Not Allowed''' |
− | | all characters allowed | + | | all characters allowed |
− | | | + | | |
|- | |- | ||
− | |''' Tip Help:''' | + | | '''Tip Help:''' |
− | | Find Textfield | + | | Find Textfield |
| | | | ||
|- | |- | ||
− | |''' TextField Label:''' | + | | '''TextField Label:''' |
− | | no | + | | no |
| | | | ||
|- | |- | ||
− | | '''Shortcut:''' | + | | '''Shortcut:''' |
− | | Ctrl + Alt + F | + | | Ctrl + Alt + F |
− | |focus in textfield | + | | focus in textfield |
|- | |- | ||
− | | '''Other:''' | + | | '''Other:''' |
− | | | + | | <Specify Other Properties Here> |
− | | | + | | |
|} | |} | ||
− | === Next Button === | + | === Next Button === |
− | {| | + | |
+ | {| cellspacing="0" cellpadding="4" border="2" style="border: 1px solid rgb(204, 204, 204); margin: 1em 1em 1em 0pt; border-collapse: collapse; width: 100%;" | ||
|- | |- | ||
− | | | + | | bgcolor="#dddddd" width="200" | '''Property''' |
+ | | bgcolor="#dddddd" | '''State''' | ||
+ | | bgcolor="#dddddd" | '''Comment''' | ||
|- | |- | ||
− | | '''Enabled:''' | + | | '''Enabled:''' |
− | | by entering the find text field | + | | by entering the find text field |
− | | | + | | |
|- | |- | ||
− | | '''Disabled:''' | + | | '''Disabled:''' |
− | | initially before entering the find text field and if text field gets empty | + | | initially before entering the find text field and if text field gets empty |
− | | | + | | |
|- | |- | ||
− | | '''On Click:''' | + | | '''On Click:''' |
− | | go to next found phrase and select it | + | | go to next found phrase and select it |
− | | | + | | |
|- | |- | ||
− | |''' Tip Help:''' | + | | '''Tip Help:''' |
− | | Find Next | + | | Find Next |
| | | | ||
|- | |- | ||
− | |''' Button Label:''' | + | | '''Button Label:''' |
− | | no | + | | no |
| only icon button | | only icon button | ||
|- | |- | ||
− | | '''Icon:''' | + | | '''Icon:''' |
− | | [[Image: | + | | [[Image:Arrowdown 16.png]] [[Image:Arrowdown 16 h.png]] [[Image:Arrowdown 26.png]] [[Image:Arrowdown 26 h.png]] |
| | | | ||
|- | |- | ||
− | | '''Other:''' | + | | '''Other:''' |
− | | | + | | <Specify Other Properties Here> |
− | | | + | | |
|} | |} | ||
− | === Previous Button === | + | === Previous Button === |
− | {| | + | |
+ | {| cellspacing="0" cellpadding="4" border="2" style="border: 1px solid rgb(204, 204, 204); margin: 1em 1em 1em 0pt; border-collapse: collapse; width: 100%;" | ||
|- | |- | ||
− | | | + | | bgcolor="#dddddd" width="200" | '''Property''' |
+ | | bgcolor="#dddddd" | '''State''' | ||
+ | | bgcolor="#dddddd" | '''Comment''' | ||
|- | |- | ||
− | | '''Enabled:''' | + | | '''Enabled:''' |
− | | by entering the find text field | + | | by entering the find text field |
− | | | + | | |
|- | |- | ||
− | | '''Disabled:''' | + | | '''Disabled:''' |
− | | initially before entering the find text field and if text field gets empty | + | | initially before entering the find text field and if text field gets empty |
− | | | + | | |
|- | |- | ||
− | | '''On Click:''' | + | | '''On Click:''' |
− | | go to previous found phrase and select it | + | | go to previous found phrase and select it |
− | | | + | | |
|- | |- | ||
− | |''' Tip Help:''' | + | | '''Tip Help:''' |
− | | Find Previous | + | | Find Previous |
| | | | ||
|- | |- | ||
− | |''' Button Label:''' | + | | '''Button Label:''' |
− | | no | + | | no |
| only icon button | | only icon button | ||
|- | |- | ||
− | | '''Icon:''' | + | | '''Icon:''' |
− | | [[Image: | + | | [[Image:Arrowup 16.png]] [[Image:Arrowup 16 h.png]] [[Image:Arrowup 26.png]] [[Image:Arrowup 26 h.png]] |
| | | | ||
|- | |- | ||
− | | '''Other:''' | + | | '''Other:''' |
− | | | + | | <Specify Other Properties Here> |
− | | | + | | |
|} | |} | ||
− | === Find & Replace Button === | + | === Find & Replace Button === |
− | {| | + | |
+ | {| cellspacing="0" cellpadding="4" border="2" style="border: 1px solid rgb(204, 204, 204); margin: 1em 1em 1em 0pt; border-collapse: collapse; width: 100%;" | ||
|- | |- | ||
− | | | + | | bgcolor="#dddddd" width="200" | '''Property''' |
+ | | bgcolor="#dddddd" | '''State''' | ||
+ | | bgcolor="#dddddd" | '''Comment''' | ||
|- | |- | ||
− | | '''Enabled:''' | + | | '''Enabled:''' |
− | | by user in toolbar settings (check visible) | + | | by user in toolbar settings (check visible) |
| | | | ||
|- | |- | ||
− | | '''Disabled:''' | + | | '''Disabled:''' |
− | | by default (not visible) | + | | by default (not visible) |
− | | | + | | |
|- | |- | ||
− | | '''On Click:''' | + | | '''On Click:''' |
− | | opens 'Find & Replace' dialog | + | | opens 'Find & Replace' dialog |
− | | | + | | |
|- | |- | ||
− | |''' Tip Help:''' | + | | '''Tip Help:''' |
− | | Find & Replace | + | | Find & Replace |
| | | | ||
|- | |- | ||
− | |''' Button Label:''' | + | | '''Button Label:''' |
− | | no | + | | no |
| only icon button | | only icon button | ||
|- | |- | ||
− | | '''Icon:''' | + | | '''Icon:''' |
− | | [[Image: | + | | [[Image:Fernglas icon.png]] |
| cropped screenshot icon | | cropped screenshot icon | ||
|- | |- | ||
− | | '''Other:''' | + | | '''Other:''' |
− | | | + | | <Specify Other Properties Here> |
− | | | + | | |
|} | |} | ||
− | == Accessibility == | + | == Accessibility == |
+ | |||
Accessibility is the responsibility of the I-Team, beginning with UX, DEV and QA, to ensure that the following requirements are fulfilled: | Accessibility is the responsibility of the I-Team, beginning with UX, DEV and QA, to ensure that the following requirements are fulfilled: | ||
− | # Is the feature '''fully keyboard accessible'''?'' - | + | #Is the feature '''fully keyboard accessible'''?''-> yes'' |
− | # Have I specified '''visual alternatives''' for the case that the specified feature includes audio as output? - | + | #Have I specified '''visual alternatives''' for the case that the specified feature includes audio as output? -> feature does not contain audio output |
− | # Are '''text alternatives '''for all icons and graphics available? - | + | #Are '''text alternatives '''for all icons and graphics available? -> yes |
− | # '''Don't provide important information in colors alone''''' (Ex: marking important information hard coded in red)'' - | + | #'''Don't provide important information in colors alone'''''(Ex: marking important information hard coded in red)'' -> considered |
− | # Does the specified feature respect '''system settings''' for '''font, size, and color '''for '''all''' windows and user interface elements? - | + | #Does the specified feature respect '''system settings''' for '''font, size, and color '''for '''all''' windows and user interface elements? -> yes |
− | # Have I ensured that '''flash rates''' do not exceed 2 hertz for blinking text, objects, or other elements? In any case, try to '''avoid flashing '''UI elements - | + | #Have I ensured that '''flash rates''' do not exceed 2 hertz for blinking text, objects, or other elements? In any case, try to '''avoid flashing '''UI elements -> considered |
− | # Ensure that assistive technology (AT) (like ZoomText or Orca) is able to read everything. = | + | #Ensure that assistive technology (AT) (like ZoomText or Orca) is able to read everything. => dev & qa topic |
+ | |||
+ | QUESTIONS? | ||
+ | |||
+ | If you need '''help''' while '''designing, implementing or testing''' the accessibility of the UI, ask/visit: | ||
+ | |||
+ | #The [http://wiki.services.openoffice.org/wiki/Accessibility_(A11y)_Quick_Test_Check_List accessibility check list at the OpenOffice.org Wiki] | ||
+ | #[mailto:accessibility@ui.openoffice.org accessibility@ui.openoffice.org] (The accessibility mailing lists, preferred) | ||
+ | #For specific implementation details, architecture: [mailto:mt@openoffice.org mt@openoffice.org] (Malte Timmermann) | ||
+ | #For specific UX and testing questions: [mailto:es@openoffice.org es@openoffice.org] (Éric Savary) | ||
+ | |||
+ | == Migration == | ||
+ | |||
+ | Common find toolbar should be migrateable (adaptable) for all oo applications (Writer, Calc, Draw/Impress) over uno api, while the 'Find & Replace' button get set inactive in the standard toolbar if find toolbar is active. In Impress the 'Präsentation' toolbar must travel into the second toolbar section (pic) to make space for the find toolbar and keep consistency.<br> <br> | ||
− | + | [[Image:AllApps4.png]] | |
− | + | == Configuration == | |
− | + | <START TYPING HERE --- If this part is irrelevant state a reason for its absence.> | |
− | + | ||
− | + | ||
− | + | ||
− | + | [[Specification Template Help#Configuration|Help]] | [[Configuration-Table|Configuration Table Template]] | |
− | + | ||
− | + | ||
− | + | == File Format == | |
− | + | <START TYPING HERE --- If this part is irrelevant state a reason for its absence.> [[Specification Template Help#File_Format|Help]] | |
− | + | ||
− | [[ | + | [[Specification Template Help#File_Format|Help]] | [[File Format Table|File Format Table Template]] |
− | == | + | == Future Tasks / Ideas == |
− | + | ||
− | + | - autocompletion<br> - searching by inserting first letter (start searching by first char)<br> - highlighting (jumping/selecting trough marked items)<br> - remember former search strings (string listbox)<br> - enlargable toolbar, manual or if text get bigger than 'find textbox'<br> - info text inside textbox (messages like: nothing found etc.)<br> - drop down (snippets) functions (with additional function set like s&r dialog)<br> - provide also smart & fast filter function for calc and base<br> - allow choosing between search & filter function (snippet?)<br> - 'more icon' inside textbox (or dropdown snippet etc.)<br> | |
− | == | + | == Open Issues == |
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | ||
− | + | <State a bulleted list of issues Issue here> | |
− | + | ||
[[Category:Features]] | [[Category:Features]] |
Revision as of 13:43, 19 January 2010
Specification Status | |
Author | Christoph Lukasiak (Clu) |
Last Change | 18. Jan 2010 |
Status (Help) | Preliminary |
Abstract
The 'Common Find toolbar' should be an addition to the 'Find & Replace' dialog, which provides a fast and easy text search without covering the search text.
Contents
References
Reference Document | Check | Location (URL) |
Prerequisites | in progress: [passed/failed] | n/a |
Product Requirement, RFE, Issue ID (required) | available | i107176 |
Accessibility Check (required) | See accessibility section for check list | |
Test case specification (required) | [available/not available] | <PLEASE ENTER LOCATION HERE> |
IDL Specification | [available/not available] | <PLEASE ENTER LOCATION HERE> |
Software Specification Rules | in progress | n/a |
Other, e.g. references to related specs, Product Concept Document | specification: search toolbar | |
Release Roadmap OOo 3.3 | http://wiki.services.openoffice.org/wiki/OOoRelease33 |
Contacts
Role | Name | E-Mail Address |
Developer | Carsten Driesner | cd@openoffice.org |
shizhoubo(robertzhou) | robertzhou@openoffice.org | |
Quality Assurance | Stefan Baltzer | sba@openoffice.org |
Documentation | Uwe Fischer | Uwe.Fischer@sun.com |
Icon Design | Stella Schulze | Stella.Schulze@sun.com |
User Experience | Christoph Lukasiak | Christoph.Lukasiak@Sun.com |
Jaron Kuppers | jaronbaron@gmail.com |
Acronyms and Abbreviations
Acronym / Abbreviation | Definition |
<WYSIWYG> | <What You See Is What You Get> |
Motivation
From the 'usage tracking' data of the 'find & replace' dialog we have learned that 76% of oo user just want to search inside the text, so we have to propose a fast & easy way to do so. Also it was often mentioned that the search & replace dialog covers the search area in an annoying way, so we must found an other solution for it. The other search settings like 'match case' etc. are used less than 0.1%, so we decided to leave them out in this toolbar, but like the replacing function they will still stay available in the find & replace dialog.
Detailed Specification
The common find toolbar is a standard toolbar containing a text search field, a next and forward button. It is located right next to the 'application standard' toolbar, is active by default and behave like every other toolbar (d&d, docking etc.).
By clicking into the search field, the info text disappear and the search text can be inputted. By entering the search field, the next and the previous button get active. After entering the search text, the search can be started by hitting the return key on keyboard or pushing the 'next' button. If anything is found, the first result is selected and can be edited or the next button can be clicked (is selected) for searching for the next result. If nothing is found (buttons get inactive) or it is searched to the end of the document, you get an info dialog similar to the behavior of the 'find & replace' dialog, like in all other cases, even if it works independent.
Find Toolbar
Property | State | Comment |
Toolbar Name: | Common Find Toolbar | |
<Other Language (Optional)> | ||
Has Closer: | no | |
Style: | Icon/Icon | |
Initial State: | docked | |
Initial Docking Position: | next to toolbar 'Standard' | |
Initial Floating Position: | no | |
List in "View/Toolbars": | yes | |
Is Context Sensitive: | no |
Find Textfield
Property | State | Comment |
Enabled: | always enabled | |
Disabled: | never disabled | |
Read Only: | no | |
Initial String: | Find | light grey |
String Preselected: | no | |
Caret Position: | <0> | |
Characters Not Allowed | all characters allowed | |
Tip Help: | Find Textfield | |
TextField Label: | no | |
Shortcut: | Ctrl + Alt + F | focus in textfield |
Other: | <Specify Other Properties Here> |
Next Button
Previous Button
Find & Replace Button
Property | State | Comment |
Enabled: | by user in toolbar settings (check visible) | |
Disabled: | by default (not visible) | |
On Click: | opens 'Find & Replace' dialog | |
Tip Help: | Find & Replace | |
Button Label: | no | only icon button |
Icon: | File:Fernglas icon.png | cropped screenshot icon |
Other: | <Specify Other Properties Here> |
Accessibility
Accessibility is the responsibility of the I-Team, beginning with UX, DEV and QA, to ensure that the following requirements are fulfilled:
- Is the feature fully keyboard accessible?-> yes
- Have I specified visual alternatives for the case that the specified feature includes audio as output? -> feature does not contain audio output
- Are text alternatives for all icons and graphics available? -> yes
- Don't provide important information in colors alone(Ex: marking important information hard coded in red) -> considered
- Does the specified feature respect system settings for font, size, and color for all windows and user interface elements? -> yes
- Have I ensured that flash rates do not exceed 2 hertz for blinking text, objects, or other elements? In any case, try to avoid flashing UI elements -> considered
- Ensure that assistive technology (AT) (like ZoomText or Orca) is able to read everything. => dev & qa topic
QUESTIONS?
If you need help while designing, implementing or testing the accessibility of the UI, ask/visit:
- The accessibility check list at the OpenOffice.org Wiki
- accessibility@ui.openoffice.org (The accessibility mailing lists, preferred)
- For specific implementation details, architecture: mt@openoffice.org (Malte Timmermann)
- For specific UX and testing questions: es@openoffice.org (Éric Savary)
Migration
Common find toolbar should be migrateable (adaptable) for all oo applications (Writer, Calc, Draw/Impress) over uno api, while the 'Find & Replace' button get set inactive in the standard toolbar if find toolbar is active. In Impress the 'Präsentation' toolbar must travel into the second toolbar section (pic) to make space for the find toolbar and keep consistency.
Configuration
<START TYPING HERE --- If this part is irrelevant state a reason for its absence.>
Help | Configuration Table Template
File Format
<START TYPING HERE --- If this part is irrelevant state a reason for its absence.> Help
Help | File Format Table Template
Future Tasks / Ideas
- autocompletion
- searching by inserting first letter (start searching by first char)
- highlighting (jumping/selecting trough marked items)
- remember former search strings (string listbox)
- enlargable toolbar, manual or if text get bigger than 'find textbox'
- info text inside textbox (messages like: nothing found etc.)
- drop down (snippets) functions (with additional function set like s&r dialog)
- provide also smart & fast filter function for calc and base
- allow choosing between search & filter function (snippet?)
- 'more icon' inside textbox (or dropdown snippet etc.)
Open Issues
<State a bulleted list of issues Issue here>