Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Sign in
Toggle navigation
F
Front-End
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Issues
0
Issues
0
List
Board
Labels
Milestones
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Wiki
Wiki
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Create a new issue
Jobs
Commits
Issue Boards
Open sidebar
abdullh.alsoleman
Front-End
Commits
f9a578dd
Unverified
Commit
f9a578dd
authored
Aug 10, 2023
by
Ian Hickson
Committed by
GitHub
Aug 10, 2023
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
An example of parentData usage. (#131818)
parent
e972d5a3
Changes
4
Expand all
Hide whitespace changes
Inline
Side-by-side
Showing
4 changed files
with
447 additions
and
18 deletions
+447
-18
parent_data.0.dart
examples/api/lib/rendering/box/parent_data.0.dart
+394
-0
parent_data.0_test.dart
examples/api/test/rendering/box/parent_data.0_test.dart
+17
-0
box.dart
packages/flutter/lib/src/rendering/box.dart
+9
-0
framework.dart
packages/flutter/lib/src/widgets/framework.dart
+27
-18
No files found.
examples/api/lib/rendering/box/parent_data.0.dart
0 → 100644
View file @
f9a578dd
This diff is collapsed.
Click to expand it.
examples/api/test/rendering/box/parent_data.0_test.dart
0 → 100644
View file @
f9a578dd
// Copyright 2014 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
import
'package:flutter/material.dart'
;
import
'package:flutter_api_samples/rendering/box/parent_data.0.dart'
;
import
'package:flutter_test/flutter_test.dart'
;
void
main
(
)
{
testWidgets
(
'parent data example'
,
(
WidgetTester
tester
)
async
{
await
tester
.
pumpWidget
(
const
SampleApp
());
expect
(
tester
.
getTopLeft
(
find
.
byType
(
Headline
).
at
(
2
)),
const
Offset
(
30.0
,
728.0
));
await
tester
.
tap
(
find
.
byIcon
(
Icons
.
density_small
));
await
tester
.
pump
();
expect
(
tester
.
getTopLeft
(
find
.
byType
(
Headline
).
at
(
2
)),
const
Offset
(
30.0
,
682.0
));
});
}
packages/flutter/lib/src/rendering/box.dart
View file @
f9a578dd
...
@@ -911,6 +911,15 @@ class BoxHitTestEntry extends HitTestEntry<RenderBox> {
...
@@ -911,6 +911,15 @@ class BoxHitTestEntry extends HitTestEntry<RenderBox> {
}
}
/// Parent data used by [RenderBox] and its subclasses.
/// Parent data used by [RenderBox] and its subclasses.
///
/// {@tool dartpad}
/// Parent data is used to communicate to a render object about its
/// children. In this example, there are two render objects that perform
/// text layout. They use parent data to identify the kind of child they
/// are laying out, and space the children accordingly.
///
/// ** See code in examples/api/lib/rendering/box/parent_data.0.dart **
/// {@end-tool}
class
BoxParentData
extends
ParentData
{
class
BoxParentData
extends
ParentData
{
/// The offset at which to paint the child in the parent's coordinate system.
/// The offset at which to paint the child in the parent's coordinate system.
Offset
offset
=
Offset
.
zero
;
Offset
offset
=
Offset
.
zero
;
...
...
packages/flutter/lib/src/widgets/framework.dart
View file @
f9a578dd
...
@@ -1778,16 +1778,20 @@ abstract class InheritedWidget extends ProxyWidget {
...
@@ -1778,16 +1778,20 @@ abstract class InheritedWidget extends ProxyWidget {
bool
updateShouldNotify
(
covariant
InheritedWidget
oldWidget
);
bool
updateShouldNotify
(
covariant
InheritedWidget
oldWidget
);
}
}
///
RenderObjectWidget
s provide the configuration for [RenderObjectElement]s,
///
[RenderObjectWidget]
s provide the configuration for [RenderObjectElement]s,
/// which wrap [RenderObject]s, which provide the actual rendering of the
/// which wrap [RenderObject]s, which provide the actual rendering of the
/// application.
/// application.
///
///
/// See also:
/// Usually, rather than subclassing [RenderObjectWidget] directly, render
/// object widgets subclass one of:
///
///
/// * [MultiChildRenderObjectWidget], which configures a [RenderObject] with
/// * [LeafRenderObjectWidget], if the widget has no children.
/// a single list of children.
/// * [SingleChildRenderObjectElement], if the widget has exactly one child.
/// * [SlottedMultiChildRenderObjectWidget], which configures a
/// * [MultiChildRenderObjectWidget], if the widget takes a list of children.
/// [RenderObject] that organizes its children in different named slots.
/// * [SlottedMultiChildRenderObjectWidget], if the widget organizes its
/// children in different named slots.
///
/// Subclasses must implement [createRenderObject] and [updateRenderObject].
abstract
class
RenderObjectWidget
extends
Widget
{
abstract
class
RenderObjectWidget
extends
Widget
{
/// Abstract const constructor. This constructor enables subclasses to provide
/// Abstract const constructor. This constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions.
/// const constructors so that they can be used in const expressions.
...
@@ -1830,8 +1834,10 @@ abstract class RenderObjectWidget extends Widget {
...
@@ -1830,8 +1834,10 @@ abstract class RenderObjectWidget extends Widget {
void
didUnmountRenderObject
(
covariant
RenderObject
renderObject
)
{
}
void
didUnmountRenderObject
(
covariant
RenderObject
renderObject
)
{
}
}
}
/// A superclass for
RenderObjectWidgets that configure RenderObject
subclasses
/// A superclass for
[RenderObjectWidget]s that configure [RenderObject]
subclasses
/// that have no children.
/// that have no children.
///
/// Subclasses must implement [createRenderObject] and [updateRenderObject].
abstract
class
LeafRenderObjectWidget
extends
RenderObjectWidget
{
abstract
class
LeafRenderObjectWidget
extends
RenderObjectWidget
{
/// Abstract const constructor. This constructor enables subclasses to provide
/// Abstract const constructor. This constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions.
/// const constructors so that they can be used in const expressions.
...
@@ -1842,13 +1848,14 @@ abstract class LeafRenderObjectWidget extends RenderObjectWidget {
...
@@ -1842,13 +1848,14 @@ abstract class LeafRenderObjectWidget extends RenderObjectWidget {
}
}
/// A superclass for [RenderObjectWidget]s that configure [RenderObject] subclasses
/// A superclass for [RenderObjectWidget]s that configure [RenderObject] subclasses
/// that have a single child slot. (This superclass only provides the storage
/// that have a single child slot.
/// for that child, it doesn't actually provide the updating logic.)
///
///
/// T
ypically, the render object assigned to this widget will
make use of
/// T
he render object assigned to this widget should
make use of
/// [RenderObjectWithChildMixin] to implement a single-child model. The mixin
/// [RenderObjectWithChildMixin] to implement a single-child model. The mixin
/// exposes a [RenderObjectWithChildMixin.child] property that allows
/// exposes a [RenderObjectWithChildMixin.child] property that allows retrieving
/// retrieving the render object belonging to the [child] widget.
/// the render object belonging to the [child] widget.
///
/// Subclasses must implement [createRenderObject] and [updateRenderObject].
abstract
class
SingleChildRenderObjectWidget
extends
RenderObjectWidget
{
abstract
class
SingleChildRenderObjectWidget
extends
RenderObjectWidget
{
/// Abstract const constructor. This constructor enables subclasses to provide
/// Abstract const constructor. This constructor enables subclasses to provide
/// const constructors so that they can be used in const expressions.
/// const constructors so that they can be used in const expressions.
...
@@ -1868,13 +1875,15 @@ abstract class SingleChildRenderObjectWidget extends RenderObjectWidget {
...
@@ -1868,13 +1875,15 @@ abstract class SingleChildRenderObjectWidget extends RenderObjectWidget {
/// storage for that child list, it doesn't actually provide the updating
/// storage for that child list, it doesn't actually provide the updating
/// logic.)
/// logic.)
///
///
/// Subclasses must
return
a [RenderObject] that mixes in
/// Subclasses must
use
a [RenderObject] that mixes in
/// [ContainerRenderObjectMixin], which provides the necessary functionality to
/// [ContainerRenderObjectMixin], which provides the necessary functionality to
/// visit the children of the container render object (the render object
/// visit the children of the container render object (the render object
/// belonging to the [children] widgets). Typically, subclasses will
return
a
/// belonging to the [children] widgets). Typically, subclasses will
use
a
/// [RenderBox] that mixes in both [ContainerRenderObjectMixin] and
/// [RenderBox] that mixes in both [ContainerRenderObjectMixin] and
/// [RenderBoxContainerDefaultsMixin].
/// [RenderBoxContainerDefaultsMixin].
///
///
/// Subclasses must implement [createRenderObject] and [updateRenderObject].
///
/// See also:
/// See also:
///
///
/// * [Stack], which uses [MultiChildRenderObjectWidget].
/// * [Stack], which uses [MultiChildRenderObjectWidget].
...
@@ -6538,8 +6547,8 @@ class LeafRenderObjectElement extends RenderObjectElement {
...
@@ -6538,8 +6547,8 @@ class LeafRenderObjectElement extends RenderObjectElement {
///
///
/// The child is optional.
/// The child is optional.
///
///
/// This element subclass can be used for
RenderObjectWidget
s whose
/// This element subclass can be used for
[RenderObjectWidget]
s whose
///
RenderObject
s use the [RenderObjectWithChildMixin] mixin. Such widgets are
///
[RenderObject]
s use the [RenderObjectWithChildMixin] mixin. Such widgets are
/// expected to inherit from [SingleChildRenderObjectWidget].
/// expected to inherit from [SingleChildRenderObjectWidget].
class
SingleChildRenderObjectElement
extends
RenderObjectElement
{
class
SingleChildRenderObjectElement
extends
RenderObjectElement
{
/// Creates an element that uses the given widget as its configuration.
/// Creates an element that uses the given widget as its configuration.
...
@@ -6600,8 +6609,8 @@ class SingleChildRenderObjectElement extends RenderObjectElement {
...
@@ -6600,8 +6609,8 @@ class SingleChildRenderObjectElement extends RenderObjectElement {
/// An [Element] that uses a [MultiChildRenderObjectWidget] as its configuration.
/// An [Element] that uses a [MultiChildRenderObjectWidget] as its configuration.
///
///
/// This element subclass can be used for
RenderObjectWidget
s whose
/// This element subclass can be used for
[RenderObjectWidget]
s whose
///
RenderObject
s use the [ContainerRenderObjectMixin] mixin with a parent data
///
[RenderObject]
s use the [ContainerRenderObjectMixin] mixin with a parent data
/// type that implements [ContainerParentDataMixin<RenderObject>]. Such widgets
/// type that implements [ContainerParentDataMixin<RenderObject>]. Such widgets
/// are expected to inherit from [MultiChildRenderObjectWidget].
/// are expected to inherit from [MultiChildRenderObjectWidget].
///
///
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment