Package com.vaadin.flow.component.html

Class IFrame

java.lang.Object

com.vaadin.flow.component.Component

com.vaadin.flow.component.HtmlComponent

com.vaadin.flow.component.html.IFrame

All Implemented Interfaces:

AttachNotifier, DetachNotifier, HasElement, HasSize, HasStyle, Serializable

@Tag("iframe")
public class IFrame
extends HtmlComponent

Component representing a <iframe> element.

Since:

1.3

Author:

Vaadin Ltd

See Also:

The Inline Frame element, Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	IFrame.ImportanceType	Importance types.
static class	IFrame.SandboxType	Sandbox types.

Constructor Summary

Constructors

Constructor	Description
IFrame()	Creates a new iframe.
IFrame(String src)	Creates a new iframe with a source URL.

Method Summary

Modifier and Type	Method	Description
Optional<String>	getAllow()	Gets the value of allow attribute.
Optional<IFrame.ImportanceType>	getImportance()	Gets the importance attribute value.
Optional<String>	getName()	Gets the name attribute.
Optional<IFrame.SandboxType[]>	getSandbox()	Gets the list of sandbox attribute values.
String	getSrc()	Gets the source of the iframe.
Optional<String>	getSrcdoc()	Gets the srcdoc of the iframe.
void	reload()	Reloads the IFrame.
void	setAllow(String allow)	Sets the allow property to specify a feature policy.
void	setImportance(IFrame.ImportanceType importance)	Sets the importance attribute to the specified IFrame.ImportanceType value.
void	setName(String name)	Sets the name attribute.
void	setSandbox(IFrame.SandboxType... types)	Sets the sandbox attribute to the given IFrame.SandboxTypes.
void	setSrc(String src)	Sets the source of the iframe.
void	setSrcdoc(String srcdoc)	Sets the srcdoc of the iframe.
void	setUnsafeSrc(String src)	Sets the source of the iframe without validating its scheme.

Methods inherited from class com.vaadin.flow.component.HtmlComponent

getTitle, setTitle

Methods inherited from class com.vaadin.flow.component.Component

addListener, findAncestor, fireEvent, from, get, getChildren, getElement, getEventBus, getId, getListeners, getLocale, getParent, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getTranslation, getUI, hasListener, isAttached, isTemplateMapped, isVisible, onAttach, onDetach, onEnabledStateChanged, scrollIntoView, set, setElement, setId, setVisible

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface com.vaadin.flow.component.AttachNotifier

addAttachListener

Methods inherited from interface com.vaadin.flow.component.DetachNotifier

addDetachListener

Methods inherited from interface com.vaadin.flow.component.HasElement

getElement

Methods inherited from interface com.vaadin.flow.component.HasSize

getHeight, getHeightUnit, getMaxHeight, getMaxWidth, getMinHeight, getMinWidth, getWidth, getWidthUnit, setHeight, setHeight, setHeightFull, setMaxHeight, setMaxHeight, setMaxWidth, setMaxWidth, setMinHeight, setMinHeight, setMinWidth, setMinWidth, setSizeFull, setSizeUndefined, setWidth, setWidth, setWidthFull

Methods inherited from interface com.vaadin.flow.component.HasStyle

addClassName, addClassNames, getClassName, getClassNames, getStyle, hasClassName, removeClassName, removeClassNames, setClassName, setClassName

Constructor Detail

IFrame

public IFrame()

Creates a new iframe.

IFrame

public IFrame(String src)

Creates a new iframe with a source URL.

Parameters:

src - Source URL

Throws:

IllegalArgumentException - if src uses a scheme that is not considered safe according to DeploymentConfiguration.getUrlSafeSchemes(); see setUnsafeSrc(String) and the "safeUrlSchemes" configuration property

Method Detail

setSrc

public void setSrc(String src)

Sets the source of the iframe. If the contents at the src of the IFrame has changed and you want to refresh it in the user's browser, the src does not to be reset. In this case use the #reload() method.

Parameters:

src - Source URL.

Throws:

IllegalArgumentException - if the URL uses a scheme that is not considered safe according to DeploymentConfiguration.getUrlSafeSchemes(); see setUnsafeSrc(String) and the "safeUrlSchemes" configuration property

setUnsafeSrc

public void setUnsafeSrc(String src)

Sets the source of the iframe without validating its scheme.

Unlike setSrc(String), this method does not reject URLs based on the "safeUrlSchemes" configuration. Use it only for URLs that are fully under your control and known to be safe, such as a hard-coded javascript: or data: URL. Passing untrusted input here can expose the application to cross-site scripting (XSS) attacks.

Parameters:

src - Source URL.

See Also:

setSrc(String)

getSrc

public String getSrc()

Gets the source of the iframe.

Returns:

the source of the iframe.

setSrcdoc

public void setSrcdoc(String srcdoc)

Sets the srcdoc of the iframe.

Parameters:

srcdoc - srcdoc URL.

getSrcdoc

public Optional<String> getSrcdoc()

Gets the srcdoc of the iframe.

Returns:

the srcdoc of the iframe.

setAllow

public void setAllow(String allow)

Sets the allow property to specify a feature policy.

Parameters:

allow - the allow attribute value.

See Also:

Feature Policy.

getAllow

public Optional<String> getAllow()

Gets the value of allow attribute.

Returns:

the currently applied allow value.

setName

public void setName(String name)

Sets the name attribute.

Parameters:

name - the value for the name attribute.

getName

public Optional<String> getName()

Gets the name attribute.

Returns:

the name attribute.

setImportance

public void setImportance(IFrame.ImportanceType importance)

Sets the importance attribute to the specified IFrame.ImportanceType value.

Parameters:

importance - IFrame.ImportanceType value.

See Also:

IFrame.ImportanceType

getImportance

public Optional<IFrame.ImportanceType> getImportance()

Gets the importance attribute value.

Returns:

the importance value.

See Also:

IFrame.ImportanceType

setSandbox

public void setSandbox(IFrame.SandboxType... types)

Sets the sandbox attribute to the given IFrame.SandboxTypes.

Parameters:

types - IFrame.SandboxTypes.

getSandbox

public Optional<IFrame.SandboxType[]> getSandbox()

Gets the list of sandbox attribute values.

Returns:

the current IFrame.SandboxTypes.

reload

public void reload()

Reloads the IFrame.