1# Orca
2#
3# Copyright 2004-2009 Sun Microsystems Inc.
4# Copyright 2010-2013 The Orca Team
5#
6# This library is free software; you can redistribute it and/or
7# modify it under the terms of the GNU Lesser General Public
8# License as published by the Free Software Foundation; either
9# version 2.1 of the License, or (at your option) any later version.
10#
11# This library is distributed in the hope that it will be useful,
12# but WITHOUT ANY WARRANTY; without even the implied warranty of
13# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14# Lesser General Public License for more details.
15#
16# You should have received a copy of the GNU Lesser General Public
17# License along with this library; if not, write to the
18# Free Software Foundation, Inc., Franklin Street, Fifth Floor,
19# Boston MA  02110-1301 USA.
20
21"""Propeerties of accessible objects. These have been put in their own module
22so that we can present them in the correct language when users change the
23language on the fly without having to reload a bunch of modules."""
24
25__id__        = "$Id$"
26__version__   = "$Revision$"
27__date__      = "$Date$"
28__copyright__ = "Copyright (c) 2004-2009 Sun Microsystems Inc." \
29                "Copyright (c) 2010-2013 The Orca Team"
30__license__   = "LGPL"
31
32from .orca_i18n import _, C_
33
34# Translators: this is the action name for the 'toggle' action. It must be the
35# same string used in the *.po file for gail.
36ACTION_TOGGLE = _("toggle")
37
38# Translators: this is a indication of the focused icon and the count of the
39# total number of icons within an icon panel. An example of an icon panel is
40# the Nautilus folder view.
41ICON_INDEX_SPEECH = _("on %(index)d of %(total)d")
42
43# Translators: this refers to the position of an item in a list or group of
44# objects, such as menu items in a menu, radio buttons in a radio button group,
45# combobox item in a combobox, etc.
46GROUP_INDEX_SPEECH = _("%(index)d of %(total)d")
47
48# Translators: This message describes a list item in a document. Nesting level
49# is how "deep" the item is (e.g., a level of 2 represents a list item inside a
50# list that's inside another list).
51NESTING_LEVEL_SPEECH = _("Nesting level %d")
52
53# Translators: This message describes a list item in a document. Nesting level
54# is how "deep" the item is (e.g., a level of 2 represents a list item inside a
55# list that's inside another list). This string is specifically for braille.
56# Because braille displays lack real estate, we're using a shorter string than
57# we use for speech.
58NESTING_LEVEL_BRAILLE = _("LEVEL %d")
59
60# Translators: This represents the depth of a node in a TreeView (i.e. how many
61# ancestors the node has). This is the spoken version.
62NODE_LEVEL_SPEECH = _("tree level %d")
63
64# Translators: This represents the depth of a node in a TreeView (i.e. how many
65# ancestors the node has). This is the braille version.
66NODE_LEVEL_BRAILLE = _("TREE LEVEL %d")
67
68# Translators: In web content, authors can identify an element which contains
69# detailed information about another element. For instance, for a password
70# field, there may be a list of requirements (number of characters, number of
71# special symbols, etc.). For an image, there may be an extended description
72# before or after the image. Often there are visual clues connecting the
73# detailed information to its related object. We need to convey this non-visually.
74# This relationship will be presented for the object containing the details, e.g.
75# when arrowing into or out of it. The string substitution is for the object to
76# which the detailed information applies. For instance, when navigating into
77# the details for an image named Pythagorean Theorem, Orca would present:
78# "details for Pythagorean Theorem image".
79# See https://w3c.github.io/aria/#aria-details
80RELATION_DETAILS_FOR = _("details for %s")
81
82# Translators: In web content, authors can identify an element which contains
83# detailed information about another element. For instance, for a password
84# field, there may be a list of requirements (number of characters, number of
85# special symbols, etc.). For an image, there may be an extended description
86# before or after the image. Often there are visual clues connecting the
87# detailed information to its related object. We need to convey this non-visually.
88# This relationship will be presented for the object which has details to tell
89# the user the type of object where the details can be found so that they can
90# more quickly navigate to it. The string substitution is for the object to
91# which the detailed information applies. For instance, when navigating to
92# a password field which has details in a list named "Requirements", Orca would
93# present: "has details in Requirements list".
94# See https://w3c.github.io/aria/#aria-details
95RELATION_HAS_DETAILS = _("has details in %s")
96
97# Translators: This string should be treated as a role describing an object.
98# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
99# This role refers to a container with a proposed change. This change can
100# include the insertion and/or deletion of content, and would typically be seen
101# in a collaborative editor, such as in Google Docs.
102ROLE_CONTENT_SUGGESTION = C_("role", "suggestion")
103
104# Translators: This string should be treated as a role describing an object.
105# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
106# The reason for including the editable state as part of the role is to make it
107# possible for users to quickly identify combo boxes in which a value can be
108# typed or arrowed to.
109ROLE_EDITABLE_COMBO_BOX = _("editable combo box")
110
111# Translators: This string should be treated as a role describing an object.
112# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
113# This role is to describe elements in web content which have the contenteditable
114# attribute set to true, indicating that the element can be edited by the user.
115ROLE_EDITABLE_CONTENT = _("editable content")
116
117# Translators: This string should be treated as a role describing an object.
118# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
119# The feed role is a scrollable list of articles where scrolling may cause
120# articles to be added to or removed from either end of the list.
121# https://w3c.github.io/aria/#feed
122ROLE_FEED = C_("role", "feed")
123
124# Translators: This string should be treated as a role describing an object.
125# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
126# The figure role is a perceivable section of content that typically contains a
127# graphical document, images, code snippets, or example text.
128# https://w3c.github.io/aria/#figure
129ROLE_FIGURE = C_("role", "figure")
130
131# Translators: This string should be treated as a role describing an object.
132# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
133# This role refers to the abstract in a digitally-published document.
134# https://w3c.github.io/dpub-aria/#doc-abstract
135ROLE_ABSTRACT = C_("role", "abstract")
136
137# Translators: This string should be treated as a role describing an object.
138# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
139# This role refers to the acknowledgments in a digitally-published document.
140# https://w3c.github.io/dpub-aria/#doc-acknowledgments
141ROLE_ACKNOWLEDGMENTS = C_("role", "acknowledgments")
142
143# Translators: This string should be treated as a role describing an object.
144# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
145# This role refers to the afterword in a digitally-published document.
146# https://w3c.github.io/dpub-aria/#doc-afterword
147ROLE_AFTERWORD = C_("role", "afterword")
148
149# Translators: This string should be treated as a role describing an object.
150# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
151# This role refers to the appendix in a digitally-published document.
152# https://w3c.github.io/dpub-aria/#doc-appendix
153ROLE_APPENDIX = C_("role", "appendix")
154
155# Translators: This string should be treated as a role describing an object.
156# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
157# This role refers to a bibliography entry in a digitally-published document.
158# https://w3c.github.io/dpub-aria/#doc-biblioentry
159ROLE_BIBLIOENTRY = C_("role", "bibliography entry")
160
161# Translators: This string should be treated as a role describing an object.
162# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
163# This role refers to the bibliography in a digitally-published document.
164# https://w3c.github.io/dpub-aria/#doc-bibliography
165ROLE_BIBLIOGRAPHY = C_("role", "bibliography")
166
167# Translators: This string should be treated as a role describing an object.
168# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
169# This role refers to a chapter in a digitally-published document.
170# https://w3c.github.io/dpub-aria/#doc-chapter
171ROLE_CHAPTER = C_("role", "chapter")
172
173# Translators: This string should be treated as a role describing an object.
174# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
175# This role refers to the colophon in a digitally-published document.
176# https://w3c.github.io/dpub-aria/#doc-colophon
177ROLE_COLOPHON = C_("role", "colophon")
178
179# Translators: This string should be treated as a role describing an object.
180# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
181# This role refers to the conclusion in a digitally-published document.
182# https://w3c.github.io/dpub-aria/#doc-conclusion
183ROLE_CONCLUSION = C_("role", "conclusion")
184
185# Translators: This string should be treated as a role describing an object.
186# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
187# This role refers to the cover in a digitally-published document.
188# https://w3c.github.io/dpub-aria/#doc-cover
189ROLE_COVER = C_("role", "cover")
190
191# Translators: This string should be treated as a role describing an object.
192# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
193# This role refers to a single credit in a digitally-published document.
194# https://w3c.github.io/dpub-aria/#doc-credit
195ROLE_CREDIT = C_("role", "credit")
196
197# Translators: This string should be treated as a role describing an object.
198# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
199# This role refers to the credits in a digitally-published document.
200# https://w3c.github.io/dpub-aria/#doc-credits
201ROLE_CREDITS = C_("role", "credits")
202
203# Translators: This string should be treated as a role describing an object.
204# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
205# This role refers to the dedication in a digitally-published document.
206# https://w3c.github.io/dpub-aria/#doc-dedication
207ROLE_DEDICATION = C_("role", "dedication")
208
209# Translators: This string should be treated as a role describing an object.
210# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
211# This role refers to a single endnote in a digitally-published document.
212# https://w3c.github.io/dpub-aria/#doc-endnote
213ROLE_ENDNOTE = C_("role", "endnote")
214
215# Translators: This string should be treated as a role describing an object.
216# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
217# This role refers to the endnotes in a digitally-published document.
218# https://w3c.github.io/dpub-aria/#doc-endnotes
219ROLE_ENDNOTES = C_("role", "endnotes")
220
221# Translators: This string should be treated as a role describing an object.
222# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
223# This role refers to the epigraph in a digitally-published document.
224# https://w3c.github.io/dpub-aria/#doc-epigraph
225ROLE_EPIGRAPH = C_("role", "epigraph")
226
227# Translators: This string should be treated as a role describing an object.
228# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
229# This role refers to the epilogue in a digitally-published document.
230# https://w3c.github.io/dpub-aria/#doc-epilogue
231ROLE_EPILOGUE = C_("role", "epilogue")
232
233# Translators: This string should be treated as a role describing an object.
234# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
235# This role refers to the errata in a digitally-published document.
236# https://w3c.github.io/dpub-aria/#doc-errata
237ROLE_ERRATA = C_("role", "errata")
238
239# Translators: This string should be treated as a role describing an object.
240# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
241# This role refers to an example in a digitally-published document.
242# https://w3c.github.io/dpub-aria/#doc-example
243ROLE_EXAMPLE = C_("role", "example")
244
245# Translators: This string should be treated as a role describing an object.
246# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
247# This role refers to the foreword in a digitally-published document.
248# https://w3c.github.io/dpub-aria/#doc-foreword
249ROLE_FOREWORD = C_("role", "foreword")
250
251# Translators: This string should be treated as a role describing an object.
252# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
253# This role refers to the glossary in a digitally-published document.
254# https://w3c.github.io/dpub-aria/#doc-glossary
255ROLE_GLOSSARY = C_("role", "glossary")
256
257# Translators: This string should be treated as a role describing an object.
258# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
259# This role refers to the index in a digitally-published document.
260# https://w3c.github.io/dpub-aria/#doc-index
261ROLE_INDEX = C_("role", "index")
262
263# Translators: This string should be treated as a role describing an object.
264# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
265# This role refers to the introduction in a digitally-published document.
266# https://w3c.github.io/dpub-aria/#doc-introduction
267ROLE_INTRODUCTION = C_("role", "introduction")
268
269# Translators: This string should be treated as a role describing an object.
270# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
271# This role refers to a pagebreak in a digitally-published document.
272# https://w3c.github.io/dpub-aria/#doc-pagebreak
273ROLE_PAGEBREAK = C_("role", "page break")
274
275# Translators: This string should be treated as a role describing an object.
276# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
277# This role refers to a page list in a digitally-published document.
278# https://w3c.github.io/dpub-aria/#doc-pagelist
279ROLE_PAGELIST = C_("role", "page list")
280
281# Translators: This string should be treated as a role describing an object.
282# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
283# This role refers to a named part in a digitally-published document.
284# https://w3c.github.io/dpub-aria/#doc-part
285ROLE_PART = C_("role", "part")
286
287# Translators: This string should be treated as a role describing an object.
288# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
289# This role refers to the preface in a digitally-published document.
290# https://w3c.github.io/dpub-aria/#doc-preface
291ROLE_PREFACE = C_("role", "preface")
292
293# Translators: This string should be treated as a role describing an object.
294# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
295# This role refers to the prologue in a digitally-published document.
296# https://w3c.github.io/dpub-aria/#doc-prologue
297ROLE_PROLOGUE = C_("role", "prologue")
298
299# Translators: This string should be treated as a role describing an object.
300# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
301# This role refers to a pullquote in a digitally-published document.
302# https://w3c.github.io/dpub-aria/#doc-pullquote
303ROLE_PULLQUOTE = C_("role", "pullquote")
304
305# Translators: This string should be treated as a role describing an object.
306# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
307# This role refers to a questions-and-answers section in a digitally-published
308# document. https://w3c.github.io/dpub-aria/#doc-qna
309# In English, "QNA" is generally recognized by native speakers. If your language
310# lacks the equivalent, please prefer the shortest phrase which clearly conveys
311# the meaning.
312ROLE_QNA = C_("role", "QNA")
313
314# Translators: This string should be treated as a role describing an object.
315# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
316# This role refers to the subtitle in a digitally-published document.
317# https://w3c.github.io/dpub-aria/#doc-subtitle
318ROLE_SUBTITLE = C_("role", "subtitle")
319
320# Translators: This string should be treated as a role describing an object.
321# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
322# This role refers to the table of contents in a digitally-published document.
323# https://w3c.github.io/dpub-aria/#doc-toc
324ROLE_TOC = C_("role", "table of contents")
325
326# Translators: The 'h' in this string represents a heading level attribute for
327# content that you might find in something such as HTML content (e.g., <h1>).
328# The translated form is meant to be a single character followed by a numeric
329# heading level, where the single character is to indicate 'heading'.
330ROLE_HEADING_LEVEL_BRAILLE = _("h%d")
331
332# Translators: The %(level)d is in reference to a heading level in HTML (e.g.,
333# For <h3>, the level is 3) and the %(role)s is in reference to a previously
334# translated rolename for the heading.
335ROLE_HEADING_LEVEL_SPEECH = _("%(role)s level %(level)d")
336
337# Translators: This string should be treated as a role describing an object.
338# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
339# The reason we include the orientation as part of the role is because in some
340# applications and toolkits, it can dictate which keyboard keys should be used
341# to modify the value of the widget.
342ROLE_SCROLL_BAR_HORIZONTAL = _("horizontal scroll bar")
343
344# Translators: This string should be treated as a role describing an object.
345# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
346# The reason we include the orientation as part of the role is because in some
347# applications and toolkits, it can dictate which keyboard keys should be used
348# to modify the value of the widget.
349ROLE_SCROLL_BAR_VERTICAL = _("vertical scroll bar")
350
351# Translators: This string should be treated as a role describing an object.
352# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
353# A slider is a widget which looks like a bar and displays a value as a range.
354# A common example of a slider can be found in UI for modifying volume levels.
355# The reason we include the orientation as part of the role is because in some
356# applications and toolkits, it can dictate which keyboard keys should be used
357# to modify the value of the widget.
358ROLE_SLIDER_HORIZONTAL = _("horizontal slider")
359
360# Translators: This string should be treated as a role describing an object.
361# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
362# A slider is a widget which looks like a bar and displays a value as a range.
363# A common example of a slider can be found in UI for modifying volume levels.
364# The reason we include the orientation as part of the role is because in some
365# applications and toolkits, it can dictate which keyboard keys should be used
366# to modify the value of the widget.
367ROLE_SLIDER_VERTICAL = _("vertical slider")
368
369# Translators: This string should be treated as a role describing an object.
370# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
371# A splitter is a bar that divides a container into two parts. It is often, but
372# not necessarily, user resizable. A common example of a splitter can be found
373# in email applications, where there is a container on the left which holds a
374# list of all the mail folders and a container on the right which lists all of
375# the messages in the selected folder. The bar which you click on and drag to
376# resize these containers is the splitter. The reason we include the orientation
377# as part of the role is because in some applications and toolkits, it can
378# dictate which keyboard keys should be used to modify the value of the widget.
379ROLE_SPLITTER_HORIZONTAL = _("horizontal splitter")
380
381# Translators: This string should be treated as a role describing an object.
382# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
383# A splitter is a bar that divides a container into two parts. It is often, but
384# not necessarily, user resizable. A common example of a splitter can be found
385# in email applications, where there is a container on the left which holds a
386# list of all the mail folders and a container on the right which lists all of
387# the messages in the selected folder. The bar which you click on and drag to
388# resize these containers is the splitter. The reason we include the orientation
389# as part of the role is because in some applications and toolkits, it can
390# dictate which keyboard keys should be used to modify the value of the widget.
391ROLE_SPLITTER_VERTICAL = _("vertical splitter")
392
393# Translators: This string should be treated as a role describing an object.
394# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
395# The "switch" role is a "light switch" style toggle, such as can be seen in
396# https://developer.gnome.org/gtk3/stable/GtkSwitch.html
397ROLE_SWITCH = C_("role", "switch")
398
399# Translators: This is an alternative name for the parent object of a series
400# of icons.
401ROLE_ICON_PANEL = _("Icon panel")
402
403# Translators: This string should be treated as a role describing an object.
404# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
405# The "banner" role is defined in the ARIA specification as "A region that
406# contains mostly site-oriented content, rather than page-specific content."
407# See https://www.w3.org/TR/wai-aria-1.1/#banner
408ROLE_LANDMARK_BANNER = C_("role", "banner")
409
410# Translators: This string should be treated as a role describing an object.
411# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
412# The "complementary" role is defined in the ARIA specification as "A supporting
413# section of the document, designed to be complementary to the main content at a
414# similar level in the DOM hierarchy, but remains meaningful when separated from
415# the main content." See https://www.w3.org/TR/wai-aria-1.1/#complementary
416ROLE_LANDMARK_COMPLEMENTARY = C_("role", "complementary content")
417
418# Translators: This string should be treated as a role describing an object.
419# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
420# The "contentinfo" role is defined in the ARIA specification as "A large
421# perceivable region that contains information about the parent document.
422# Examples of information included in this region of the page are copyrights and
423# links to privacy statements." See https://www.w3.org/TR/wai-aria-1.1/#contentinfo
424ROLE_LANDMARK_CONTENTINFO = C_("role", "information")
425
426# Translators: This string should be treated as a role describing an object.
427# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
428# The "main" role is defined in the ARIA specification as "The main content of
429# a document." See https://www.w3.org/TR/wai-aria-1.1/#main
430ROLE_LANDMARK_MAIN = C_("role", "main content")
431
432# Translators: This string should be treated as a role describing an object.
433# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
434# The "navigation" role is defined in the ARIA specification as "A collection of
435# navigational elements (usually links) for navigating the document or related
436# documents." See https://www.w3.org/TR/wai-aria-1.1/#navigation
437ROLE_LANDMARK_NAVIGATION =  C_("role", "navigation")
438
439# Translators: This string should be treated as a role describing an object.
440# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
441# The "region" role is defined in the ARIA specification as "A perceivable
442# section containing content that is relevant to a specific, author-specified
443# purpose and sufficiently important that users will likely want to be able to
444# navigate to the section easily and to have it listed in a summary of the page."
445# See https://www.w3.org/TR/wai-aria-1.1/#region
446ROLE_LANDMARK_REGION =  C_("role", "region")
447
448# Translators: This string should be treated as a role describing an object.
449# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
450# The "search" role is defined in the ARIA specification as "A landmark region
451# that contains a collection of items and objects that, as a whole, combine to
452# create a search facility." See https://www.w3.org/TR/wai-aria-1.1/#search
453ROLE_LANDMARK_SEARCH = C_("role", "search")
454
455# Translators: This string should be treated as a role describing an object.
456# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
457# The reason for including the visited state as part of the role is to make it
458# possible for users to quickly identify if the link is associated with content
459# already read.
460ROLE_VISITED_LINK = _("visited link")
461
462# Translators: This string should be treated as a role describing an object.
463# Examples of roles include "checkbox", "radio button", "paragraph", and "link."
464# A menu button is button widget that causes a menu to appear when the user
465# activates the button.
466ROLE_MENU_BUTTON = _("menu button")
467
468# Translators: This string refers to a row or column whose sort-order has been set
469# to ascending.
470SORT_ORDER_ASCENDING = _("sorted ascending")
471
472# Translators: This string refers to a row or column whose sort-order has been set
473# to descending.
474SORT_ORDER_DESCENDING = _("sorted descending")
475
476# Translators: This string refers to a row or column whose sort-order has been set,
477# but the nature of the sort order is unknown or something other than ascending or
478# descending.
479SORT_ORDER_OTHER = _("sorted")
480
481# Translators: This is a state which applies to elements in document content
482# which have an "onClick" action.
483STATE_CLICKABLE = _("clickable")
484
485# Translators: This is a state which applies to items which can be expanded
486# or collapsed such as combo boxes and nodes/groups in a treeview. Collapsed
487# means the item's children are not showing; expanded means they are.
488STATE_COLLAPSED = _("collapsed")
489
490# Translators: This is a state which applies to items which can be expanded
491# or collapsed such as combo boxes and nodes/groups in a treeview. Collapsed
492# means the item's children are not showing; expanded means they are.
493STATE_EXPANDED = _("expanded")
494
495# Translators: This is a state which applies to elements in document content
496# which have a longdesc attribute. http://www.w3.org/TR/WCAG20-TECHS/H45.html
497STATE_HAS_LONGDESC = _("has long description")
498
499# Translators: This is a state which applies to the orientation of widgets
500# such as sliders and scroll bars.
501STATE_HORIZONTAL = _("horizontal")
502
503# Translators: This is a state which applies to the orientation of widgets
504# such as sliders and scroll bars.
505STATE_VERTICAL =  _("vertical")
506
507# Translators: This is a state which applies to a check box.
508STATE_CHECKED = C_("checkbox", "checked")
509
510# Translators: This is a state which applies to a check box.
511STATE_NOT_CHECKED = C_("checkbox", "not checked")
512
513# Translators: This is a state which applies to a switch. For an example of
514# a switch, see https://developer.gnome.org/gtk3/stable/GtkSwitch.html
515STATE_ON_SWITCH = C_("switch", "on")
516
517# Translators: This is a state which applies to a switch. For an example of
518# a switch, see https://developer.gnome.org/gtk3/stable/GtkSwitch.html
519STATE_OFF_SWITCH = C_("switch", "off")
520
521# Translators: This is a state which applies to a check box.
522STATE_PARTIALLY_CHECKED = C_("checkbox", "partially checked")
523
524# Translators: This is a state which applies to a toggle button.
525STATE_PRESSED = C_("togglebutton", "pressed")
526
527# Translators: This is a state which applies to a toggle button.
528STATE_NOT_PRESSED = C_("togglebutton", "not pressed")
529
530# Translators: This is a state which applies to an item or option
531# in a selectable list.
532STATE_UNSELECTED_LIST_ITEM = C_("listitem", "not selected")
533
534# Translators: This is a state which applies to a radio button.
535STATE_SELECTED_RADIO_BUTTON = C_("radiobutton", "selected")
536
537# Translators: This is a state which applies to a radio button.
538STATE_UNSELECTED_RADIO_BUTTON = C_("radiobutton", "not selected")
539
540# Translators: This is a state which applies to a table cell.
541STATE_UNSELECTED_TABLE_CELL = C_("tablecell", "not selected")
542
543# Translators: This is a state which applies to a link.
544STATE_VISITED = C_("link state", "visited")
545
546# Translators: This is a state which applies to a link.
547STATE_UNVISITED = C_("link state", "unvisited")
548
549# Translators: This state represents an item on the screen that has been set
550# insensitive (or grayed out).
551STATE_INSENSITIVE_SPEECH = _("grayed")
552
553# Translators: This state represents an item on the screen that has been set
554# insensitive (or grayed out).
555STATE_INSENSITIVE_BRAILLE = _("grayed")
556
557# Translators: Certain objects (such as form controls on web pages) can have
558# STATE_EDITABLE set to inform the user that this field can be filled out.
559# It is assumed that form fields will be editable; if they lack this state,
560# we need to present that information to the user. This string is the spoken
561# version.
562STATE_READ_ONLY_SPEECH = C_("text", "read only")
563
564# Translators: Certain objects (such as form controls on web pages) can have
565# STATE_EDITABLE set to inform the user that this field can be filled out.
566# It is assumed that form fields will be editable; if they lack this state,
567# we need to present that information to the user. This string is the braille
568# version. (Because braille displays have limited real estate, we abbreviate.)
569STATE_READ_ONLY_BRAILLE =  C_("text", "rdonly")
570
571# Translators: Certain objects (such as form controls on web pages) can have
572# STATE_REQUIRED set to inform the user that this field must be filled out.
573STATE_REQUIRED_SPEECH = _("required")
574
575# Translators: Certain objects (such as form controls on web pages) can have
576# STATE_REQUIRED set to inform the user that this field must be filled out.
577STATE_REQUIRED_BRAILLE = _("required")
578
579# Translators: "multi-select" refers to a web form list in which more than
580# one item can be selected at a time.
581STATE_MULTISELECT_SPEECH = _("multi-select")
582
583# Translators: STATE_INVALID_ENTRY indicates that the associated object, such
584# as a form field, has an error. The following string is spoken when all we
585# know is that an error has occurred, but not the type of error.
586STATE_INVALID_SPEECH = C_("error", "invalid entry")
587
588# Translators: STATE_INVALID_ENTRY indicates that the associated object, such
589# as a form field, has an error. The following string is displayed in braille
590# when all we know is that an error has occurred, but not the type of error.
591# We prefer a smaller string than in speech because braille displays have a
592# limited size.
593STATE_INVALID_BRAILLE = C_("error", "invalid")
594
595# Translators: STATE_INVALID_ENTRY indicates that the associated object, such
596# as a form field, has an error. The following string is spoken when the error
597# is related to spelling.
598STATE_INVALID_SPELLING_SPEECH = C_("error", "invalid spelling")
599
600# Translators: STATE_INVALID_ENTRY indicates that the associated object, such
601# as a form field, has an error. The following string is displayed in braille
602# when the error is related to spelling. We prefer a smaller string than in
603# speech because braille displays have a limited size.
604STATE_INVALID_SPELLING_BRAILLE = C_("error", "spelling")
605
606# Translators: STATE_INVALID_ENTRY indicates that the associated object, such
607# as a form field, has an error. The following string is spoken when the error
608# is related to grammar.
609STATE_INVALID_GRAMMAR_SPEECH = C_("error", "invalid grammar")
610
611# Translators: STATE_INVALID_ENTRY indicates that the associated object, such
612# as a form field, has an error. The following string is displayed in braille
613# when the error is related to grammar. We prefer a smaller string than in
614# speech because braille displays have a limited size.
615STATE_INVALID_GRAMMAR_BRAILLE = C_("error", "grammar")
616
617# TODO: Look at why we're doing this as lists.
618
619CHECK_BOX_INDICATORS_SPEECH = \
620    [STATE_NOT_CHECKED, STATE_CHECKED, STATE_PARTIALLY_CHECKED]
621EXPANSION_INDICATORS_SPEECH = \
622    [STATE_COLLAPSED, STATE_EXPANDED]
623INVALID_INDICATORS_SPEECH = \
624    [STATE_INVALID_SPEECH,
625     STATE_INVALID_SPELLING_SPEECH,
626     STATE_INVALID_GRAMMAR_SPEECH]
627RADIO_BUTTON_INDICATORS_SPEECH = \
628    [STATE_UNSELECTED_RADIO_BUTTON, STATE_SELECTED_RADIO_BUTTON]
629
630SWITCH_INDICATORS_SPEECH = [STATE_OFF_SWITCH, STATE_ON_SWITCH]
631TOGGLE_BUTTON_INDICATORS_SPEECH = \
632    [STATE_NOT_PRESSED, STATE_PRESSED]
633
634CHECK_BOX_INDICATORS_BRAILLE     = ["< >", "<x>", "<->"]
635EXPANSION_INDICATORS_BRAILLE     = [STATE_COLLAPSED, STATE_EXPANDED]
636INVALID_INDICATORS_BRAILLE       = [STATE_INVALID_BRAILLE,
637                                    STATE_INVALID_SPELLING_BRAILLE,
638                                    STATE_INVALID_GRAMMAR_BRAILLE]
639RADIO_BUTTON_INDICATORS_BRAILLE  = ["& y", "&=y"]
640SWITCH_INDICATORS_BRAILLE = ["& y", "&=y"]
641TOGGLE_BUTTON_INDICATORS_BRAILLE = ["& y", "&=y"]
642
643TABLE_CELL_DELIMITER_BRAILLE = " "
644EOL_INDICATOR_BRAILLE = " $l"
645
646CHECK_BOX_INDICATORS_SOUND = ["not_checked", "checked", "partially_checked"]
647EXPANSION_INDICATORS_SOUND = ["collapsed", "expanded"]
648INVALID_INDICATORS_SOUND = ["invalid", "invalid_spelling", "invalid_grammar"]
649RADIO_BUTTON_INDICATORS_SOUND = ["unselected", "selected"]
650SWITCH_INDICATORS_SOUND = ["off", "on"]
651TOGGLE_BUTTON_INDICATORS_SOUND = ["not_pressed", "pressed"]
652STATE_CLICKABLE_SOUND = "clickable"
653STATE_HAS_LONGDESC_SOUND = "haslongdesc"
654STATE_INSENSITIVE_SOUND = "insensitive"
655STATE_MULTISELECT_SOUND = "multiselect"
656STATE_READ_ONLY_SOUND = "readonly"
657STATE_REQUIRED_SOUND = "required"
658STATE_VISITED_SOUND = "visited"
659