development/flutter
development/flutter
1
0
Fork 0
mirror of https://github.com/flutter/flutter synced 2024-10-13 03:32:55 +00:00
Code Issues Packages Projects Releases Wiki Activity

Remove references to obsolete SemanticsSortOrder (#29012)

Browse source 
This removes references to SemanticsSortOrder, which was removed a long time ago.
This commit is contained in:
Greg Spencer 2019-03-08 09:39:45 -08:00 committed by GitHub
parent 89512e46f6
commit 80082ac4d3
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23
2 changed files with 17 additions and 52 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

64
examples/catalog/lib/custom_a11y_traversal.dart
View file

@ -5,46 +5,33 @@
import 'package:flutter/material.dart';
import 'package:flutter/semantics.dart';
/// This example shows a set of widgets for changing data fields arranged in a column
/// of rows but, in accessibility mode, are traversed in a custom order.
/// This example shows a set of widgets for changing data fields arranged in a
/// column of rows but, in accessibility mode, are traversed in a custom order.
///
/// This demonstrates how Flutter's accessibility system describes custom traversal
/// orders using sort keys.
/// This demonstrates how Flutter's accessibility system describes custom
/// traversal orders using sort keys.
///
/// The example app here has three fields that have a title and up/down spinner buttons
/// above and below. The traversal order should allow the user to focus on each
/// title, the input field next, the up spinner next, and the down spinner last before
/// moving to the next input title.
/// The example app here has three fields that have a title and up/down spinner
/// buttons above and below. The traversal order should allow the user to focus
/// on each title, the input field next, the up spinner next, and the down
/// spinner last before moving to the next input title.
///
/// Users that do not use a screen reader (e.g. TalkBack on Android and VoiceOver on iOS)
/// will just see a regular app with controls.
/// Users that do not use a screen reader (e.g. TalkBack on Android and
/// VoiceOver on iOS) will just see a regular app with controls.
///
/// The example's [RowColumnTraversal] widget sets up two [Semantics] objects that wrap the
/// given [Widget] child, providing the traversal order they should have in the "row"
/// direction, and then the traversal order they should have in the "column" direction.
///
/// Sort keys, by default, are appended to the sort orders for their parents, but
/// they can also override those of their parents (by setting
/// [SemanticsSortOrder.discardParentOrder] to true), and an entire sort order can be
/// defined with multiple keys, to provide for virtually any ordering.
///
/// Keys at the same position in the sort order are compared with each other, and
/// keys which are of different types, or which have different [SemanticSortKey.name]
/// values compare as "equal" so that two different types of keys can co-exist at the
/// same level and not interfere with each other, allowing for sorting in groups.
/// Keys that evaluate as equal, or when compared with Widgets that don't have
/// [Semantics], are given the default upper-start-to-lower-end geometric
/// ordering.
/// The example's [RowColumnTraversal] widget sets up two [Semantics] objects
/// that wrap the given [Widget] child, providing the traversal order they
/// should have in the "row" direction, and then the traversal order they should
/// have in the "column" direction.
///
/// Since widgets are globally sorted by their sort key, the order does not have
/// to conform to the widget hierarchy. Indeed, in this example, we traverse vertically
/// first, but the widget hierarchy is a column of rows.
/// to conform to the widget hierarchy. Indeed, in this example, we traverse
/// vertically first, but the widget hierarchy is a column of rows.
///
/// See also:
///
/// * [Semantics] for an object that annotates widgets with accessibility semantics
/// (including traversal order).
/// * [SemanticSortOrder] for the class that manages the sort order of a semantic node.
/// * [SemanticSortKey] for the base class of all semantic sort keys.
/// * [OrdinalSortKey] for a concrete sort key that sorts based on the given ordinal.
class RowColumnTraversal extends StatelessWidget {
@ -56,24 +43,7 @@ class RowColumnTraversal extends StatelessWidget {
/// Builds a widget hierarchy that wraps [child].
///
/// This function expresses the sort keys as a hierarchy, but it could just as
/// easily have been a flat list:
///
/// ```dart
/// Widget build(BuildContext context) {
/// return new Semantics(
/// sortOrder: new SemanticsSortOrder(
/// keys: <SemanticsSortKey>[
/// new OrdinalSortKey(columnOrder.toDouble()),
/// new OrdinalSortKey(rowOrder.toDouble())
/// ],
/// ),
/// child: child,
/// );
/// }
/// ```
///
/// The resulting order is the same.
/// This function expresses the sort keys as a hierarchy.
@override
Widget build(BuildContext context) {
return Semantics(

5
packages/flutter/lib/src/semantics/semantics.dart
View file

@ -3745,7 +3745,6 @@ String _concatStrings({
///
/// See Also:
///
/// * [SemanticsSortOrder] which manages a list of sort keys.
/// * [OrdinalSortKey] for a sort key that sorts using an ordinal.
abstract class SemanticsSortKey extends Diagnosticable implements Comparable<SemanticsSortKey> {
/// Abstract const constructor. This constructor enables subclasses to provide
@ -3794,10 +3793,6 @@ abstract class SemanticsSortKey extends Diagnosticable implements Comparable<Sem
/// fractional, e.g. in order to fit between two other consecutive whole
/// numbers. The value must be finite (it cannot be [double.nan],
/// [double.infinity], or [double.negativeInfinity]).
///
/// See also:
///
/// * [SemanticsSortOrder] which manages a list of sort keys.
class OrdinalSortKey extends SemanticsSortKey {
/// Creates a semantics sort key that uses a [double] as its key value.
///