Skip to main content

RichDocumentView

Struct RichDocumentView 

Source
pub struct RichDocumentView { /* private fields */ }
Expand description

Retained, selectable, incrementally updating rich-document widget.

Implementations§

Source§

impl RichDocumentView

Source

pub fn new(model: RichDocumentModel) -> RichDocumentView

Examples found in repository?
examples/rich_document.rs (line 27)
3fn main() -> Result<()> {
4    let theme = DefaultTheme::dark();
5    let document = RichDocumentModel::from_markdown(
6        r#"# Deployment report
7
8SUI keeps this document selectable across blocks. Follow the [runbook](https://example.test/runbook) for details.
9
10- [x] Build artifacts
11- [x] Run tests
12- [ ] Publish release
13
14```rust
15let status = deploy().await?;
16assert!(status.ready());
17```
18"#,
19    );
20
21    let mut operation = RichExtensionBlock::new("operation-log", "Release operation");
22    operation.status = RichDocumentStatus::Running;
23    operation.summary = Some("2 of 3 stages complete".into());
24    operation.body = "build   complete\ntest    complete\npublish running".into();
25    document.append_extension(operation);
26
27    let view = RichDocumentView::new(document)
28        .theme(theme)
29        .on_link(|destination| println!("Application URL policy received: {destination}"));
30    let root = Surface::window(ScrollView::vertical(view).retain_content_layer())
31        .theme(theme)
32        .padding(Insets::all(24.0))
33        .fill();
34
35    App::new()
36        .window(Window::new("SUI Rich Document").root(root))
37        .run()
38}
Source

pub fn state(self, state: RichDocumentViewState) -> RichDocumentView

Source

pub fn renderer_registry( self, registry: RichDocumentRendererRegistry, ) -> RichDocumentView

Source

pub fn theme(self, theme: DefaultTheme) -> RichDocumentView

Examples found in repository?
examples/rich_document.rs (line 28)
3fn main() -> Result<()> {
4    let theme = DefaultTheme::dark();
5    let document = RichDocumentModel::from_markdown(
6        r#"# Deployment report
7
8SUI keeps this document selectable across blocks. Follow the [runbook](https://example.test/runbook) for details.
9
10- [x] Build artifacts
11- [x] Run tests
12- [ ] Publish release
13
14```rust
15let status = deploy().await?;
16assert!(status.ready());
17```
18"#,
19    );
20
21    let mut operation = RichExtensionBlock::new("operation-log", "Release operation");
22    operation.status = RichDocumentStatus::Running;
23    operation.summary = Some("2 of 3 stages complete".into());
24    operation.body = "build   complete\ntest    complete\npublish running".into();
25    document.append_extension(operation);
26
27    let view = RichDocumentView::new(document)
28        .theme(theme)
29        .on_link(|destination| println!("Application URL policy received: {destination}"));
30    let root = Surface::window(ScrollView::vertical(view).retain_content_layer())
31        .theme(theme)
32        .padding(Insets::all(24.0))
33        .fill();
34
35    App::new()
36        .window(Window::new("SUI Rich Document").root(root))
37        .run()
38}
Source

pub fn syntax_highlighter<H>(self, highlighter: H) -> RichDocumentView
where H: RichSyntaxHighlighter + 'static,

Examples found in repository?
examples/rich_document.rs (line 29)
3fn main() -> Result<()> {
4    let theme = DefaultTheme::dark();
5    let document = RichDocumentModel::from_markdown(
6        r#"# Deployment report
7
8SUI keeps this document selectable across blocks. Follow the [runbook](https://example.test/runbook) for details.
9
10- [x] Build artifacts
11- [x] Run tests
12- [ ] Publish release
13
14```rust
15let status = deploy().await?;
16assert!(status.ready());
17```
18"#,
19    );
20
21    let mut operation = RichExtensionBlock::new("operation-log", "Release operation");
22    operation.status = RichDocumentStatus::Running;
23    operation.summary = Some("2 of 3 stages complete".into());
24    operation.body = "build   complete\ntest    complete\npublish running".into();
25    document.append_extension(operation);
26
27    let view = RichDocumentView::new(document)
28        .theme(theme)
29        .on_link(|destination| println!("Application URL policy received: {destination}"));
30    let root = Surface::window(ScrollView::vertical(view).retain_content_layer())
31        .theme(theme)
32        .padding(Insets::all(24.0))
33        .fill();
34
35    App::new()
36        .window(Window::new("SUI Rich Document").root(root))
37        .run()
38}
Source

pub fn on_image<F>(self, callback: F) -> RichDocumentView
where F: FnMut(&str) + 'static,

Source

pub fn image_resolver<F>(self, resolver: F) -> RichDocumentView
where F: Fn(&RichInlineImage) -> Option<ImageHandle> + 'static,

Resolve Markdown image sources to images registered with the runtime.

Until a source resolves, the default renderer keeps the image’s alt text as an inline placeholder with full image semantics.

Source

pub fn on_attachment<F>(self, callback: F) -> RichDocumentView
where F: FnMut(RichBlockId) + 'static,

Source

pub fn model(&self) -> &RichDocumentModel

Source

pub fn view_state(&self) -> &RichDocumentViewState

Trait Implementations§

Source§

impl Widget for RichDocumentView

Source§

fn event(&mut self, ctx: &mut EventCtx, event: &Event)

Source§

fn command(&mut self, ctx: &mut EventCtx, command: &Command<'_>)

Receive a typed command addressed directly to this widget. Commands are target-only and do not capture or bubble through the widget tree.
Source§

fn measure(&mut self, ctx: &mut MeasureCtx, constraints: Constraints) -> Size

Source§

fn arrange(&mut self, ctx: &mut ArrangeCtx, bounds: Rect)

Source§

fn paint(&self, ctx: &mut PaintCtx)

Source§

fn accepts_focus(&self) -> bool

Source§

fn semantics(&self, ctx: &mut SemanticsCtx)

Source§

fn visit_children(&self, visitor: &mut dyn WidgetPodVisitor)

Visit this widget’s logical children. Read more
Source§

fn visit_children_mut(&mut self, visitor: &mut dyn WidgetPodMutVisitor)

Mutably visit this widget’s logical children. Read more
Source§

fn debug_name(&self) -> &'static str

Source§

fn diagnostics(&self, _ctx: &mut WidgetDiagnosticsCtx)

Publish widget-specific state for an inspector snapshot. Read more
Source§

fn intrinsic_size( &mut self, ctx: &mut MeasureCtx, axis: Axis, available_cross: f32, ) -> IntrinsicSize

Report the smallest and preferred extent along one axis. Read more
Source§

fn layer_options(&self) -> LayerOptions

Source§

fn layer_properties(&self) -> LayerProperties

Source§

fn stack_host_options(&self) -> Option<StackHostOptions>

Source§

fn stack_surface_options(&self) -> Option<StackSurfaceOptions>

Source§

fn overlay_options(&self) -> Option<OverlayOptions>

Describe this widget as the logical owner of a presented overlay. Read more
Source§

fn focus_changed(&mut self, _ctx: &mut EventCtx, _focused: bool)

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

Source§

impl<T> Downcast for T
where T: Any,

Source§

fn into_any(self: Box<T>) -> Box<dyn Any>

Convert Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>. Box<dyn Any> can then be further downcast into Box<ConcreteType> where ConcreteType implements Trait.
Source§

fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>

Convert Rc<Trait> (where Trait: Downcast) to Rc<Any>. Rc<Any> can then be further downcast into Rc<ConcreteType> where ConcreteType implements Trait.
Source§

fn as_any(&self) -> &(dyn Any + 'static)

Convert &Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &Any’s vtable from &Trait’s.
Source§

fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)

Convert &mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot generate &mut Any’s vtable from &mut Trait’s.
Source§

impl<T> Downcast<T> for T

Source§

fn downcast(&self) -> &T

Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> Upcast<T> for T

Source§

fn upcast(&self) -> Option<&T>

Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more