docstr: Insert a single-element container.
  
  Inserts a container into your app that can be used to hold a single element.
  This allows you to, for example, remove elements at any point, or replace
  several elements at once (using a child multi-element container).
  
  To insert/replace/clear an element on the returned container, you can
  use "with" notation or just call methods directly on the returned object.
  See examples below.
  
  Examples
  --------
  Overwriting elements in-place using "with" notation:
  
  >>> import streamlit as st
  >>> import time
  >>>
  >>> with st.empty():
  ...     for seconds in range(60):
  ...         st.write(f"⏳ {seconds} seconds have passed")
  ...         time.sleep(1)
  ...     st.write("✔️ 1 minute over!")
  
  Replacing several elements, then clearing them:
  
  >>> import streamlit as st
  >>>
  >>> placeholder = st.empty()
  >>>
  >>> # Replace the placeholder with some text:
  >>> placeholder.text("Hello")
  >>>
  >>> # Replace the text with a chart:
  >>> placeholder.line_chart({"data": [1, 5, 2, 6]})
  >>>
  >>> # Replace the chart with several elements:
  >>> with placeholder.container():
  ...     st.write("This is one element")
  ...     st.write("This is another")
  ...
  >>> # Clear all those elements:
  >>> placeholder.empty()
docstr_tok: ["Insert","a","single-element","container",".","Inserts","a","container","into","your","app","that","can","be","used","to","hold","a","single","element",".","This","allows","you","to",",","for","example",",","remove","elements","at","any","point",",","or","replace","several","elements","at","once","(","using","a","child","multi-element","container",")",".","To","insert\/replace\/clear","an","element","on","the","returned","container",",","you","can","use","``","with","''","notation","or","just","call","methods","directly","on","the","returned","object",".","See","examples","below",".","Examples","--","--","--","--","Overwriting","elements","in-place","using","``","with","''","notation",":",">",">",">","import","streamlit","as","st",">",">",">","import","time",">",">",">",">",">",">","with","st.empty","(",")",":","...","for","seconds","in","range","(","60",")",":","...","st.write","(","f","''","\u23f3","{","seconds","}","seconds","have","passed","''",")","...","time.sleep","(","1",")","...","st.write","(","``","\u2714\ufe0f","1","minute","over","!","''",")","Replacing","several","elements",",","then","clearing","them",":",">",">",">","import","streamlit","as","st",">",">",">",">",">",">","placeholder","=","st.empty","(",")",">",">",">",">",">",">","#","Replace","the","placeholder","with","some","text",":",">",">",">","placeholder.text","(","``","Hello","''",")",">",">",">",">",">",">","#","Replace","the","text","with","a","chart",":",">",">",">","placeholder.line_chart","(","{","``","data","''",":","[","1",",","5",",","2",",","6","]","}",")",">",">",">",">",">",">","#","Replace","the","chart","with","several","elements",":",">",">",">","with","placeholder.container","(",")",":","...","st.write","(","``","This","is","one","element","''",")","...","st.write","(","``","This","is","another","''",")","...",">",">",">","#","Clear","all","those","elements",":",">",">",">","placeholder.empty","(",")"]
code: def empty(self) -> "DeltaGenerator":
      """Insert a single-element container.
  
      Inserts a container into your app that can be used to hold a single element.
      This allows you to, for example, remove elements at any point, or replace
      several elements at once (using a child multi-element container).
  
      To insert/replace/clear an element on the returned container, you can
      use "with" notation or just call methods directly on the returned object.
      See examples below.
  
      Examples
      --------
      Overwriting elements in-place using "with" notation:
  
      >>> import streamlit as st
      >>> import time
      >>>
      >>> with st.empty():
      ...     for seconds in range(60):
      ...         st.write(f"⏳ {seconds} seconds have passed")
      ...         time.sleep(1)
      ...     st.write("✔️ 1 minute over!")
  
      Replacing several elements, then clearing them:
  
      >>> import streamlit as st
      >>>
      >>> placeholder = st.empty()
      >>>
      >>> # Replace the placeholder with some text:
      >>> placeholder.text("Hello")
      >>>
      >>> # Replace the text with a chart:
      >>> placeholder.line_chart({"data": [1, 5, 2, 6]})
      >>>
      >>> # Replace the chart with several elements:
      >>> with placeholder.container():
      ...     st.write("This is one element")
      ...     st.write("This is another")
      ...
      >>> # Clear all those elements:
      >>> placeholder.empty()
  
      """
      empty_proto = EmptyProto()
      return self.dg._enqueue("empty", empty_proto)
  
imports: from typing import TYPE_CHECKING, cast
  from streamlit.proto.Empty_pb2 import Empty
label_desc: Use image node_id 1 for calling the EmptyMixin obj's underlying member method code with example usage: obj.empty() and returns: self