pub struct ButtonScope { /* private fields */ }Expand description
A Button and its builder.
Implementations§
Source§impl ButtonScope
impl ButtonScope
Sourcepub fn accessible_name(self, name: impl Into<String>) -> Self
pub fn accessible_name(self, name: impl Into<String>) -> Self
The name assistive technology reads. With no visible label it is the control’s name; with one it replaces the label, and on an icon-only button it is read instead of the icon’s meaning.
Source§impl ButtonScope
impl ButtonScope
Sourcepub fn text_align(self, align: TextAlign) -> Self
pub fn text_align(self, align: TextAlign) -> Self
Where the label sits in the button. A button that never calls this sends nothing and keeps its label centred.
Sourcepub fn font_size(self, sp: f32) -> Self
pub fn font_size(self, sp: f32) -> Self
The label’s size in sp. A button that never calls this sends nothing and takes the design system’s size for its variant.
Sourcepub fn font_weight(self, weight: u16) -> Self
pub fn font_weight(self, weight: u16) -> Self
The label’s weight (e.g. 400, 500, 600, 700). Overrides the type role’s weight. A button that never calls this sends nothing.
Sourcepub fn type_role(self, role: TypeRole) -> Self
pub fn type_role(self, role: TypeRole) -> Self
The rung of the type ladder the label is set in: its size, weight and line height.
font_size and font_weight win over the role’s values. A button that never calls
this sends nothing and keeps the design system’s label style for its variant.
Sourcepub fn content_padding(self, horizontal: f32, vertical: f32) -> Self
pub fn content_padding(self, horizontal: f32, vertical: f32) -> Self
The room between the button’s edge and its label, in dp: horizontal at each side
and vertical above and below. It replaces the design system’s padding for this
button only, and still gives way when the button is too small for the label and
the padding together. Modifier::padding is the room around the button and is not
changed by this. A button that never calls this sends nothing and keeps the design
system’s padding.
pub fn enabled(self, enabled: bool) -> Self
pub fn variant(self, variant: ButtonVariant) -> Self
Sourcepub fn kind(self, kind: ButtonKind) -> Self
pub fn kind(self, kind: ButtonKind) -> Self
What the button is, apart from how loud it is: ButtonKind::ActionKey is one key of
a dense grid, drawn in the design system’s own calculator-key shape.
Sourcepub fn max_lines(self, lines: u32) -> Self
pub fn max_lines(self, lines: u32) -> Self
How many lines the label may take. A label is one line unless this says more, so a Korean label is never broken between syllables by a squeezed parent.
Sourcepub fn overflow(self, overflow: TextOverflow) -> Self
pub fn overflow(self, overflow: TextOverflow) -> Self
What happens to a label longer than its lines.
Sourcepub fn color(self, paint: Paint) -> Self
pub fn color(self, paint: Paint) -> Self
The label’s colour, for the rare button whose meaning is not its variant’s.
Sourcepub fn color_if(self, paint: Option<Paint>) -> Self
pub fn color_if(self, paint: Option<Paint>) -> Self
The same, when there may be no colour of its own.
pub fn on_click(self, handler: impl FnMut() + 'static) -> Self
Sourcepub fn focus_handle(self, handle: &FocusHandle) -> Self
pub fn focus_handle(self, handle: &FocusHandle) -> Self
Binds handle to this button, so handle.request() puts keyboard focus here.
Source§impl ButtonScope
impl ButtonScope
Source§impl ButtonScope
impl ButtonScope
Source§impl ButtonScope
impl ButtonScope
Sourcepub fn on_motion_finished(
self,
handler: impl FnMut(MotionFinished) + 'static,
) -> Self
pub fn on_motion_finished( self, handler: impl FnMut(MotionFinished) + 'static, ) -> Self
Runs once when this node’s size motion comes to rest, with the size it settled
at in dp. The node needs Modifier::motion for its size to move; without it
nothing is reported. A run interrupted by a newer size is not reported, only
the one that settles, and under reduced motion it arrives in the frame the
size changes in.