zxing pdf417 c# : Make pdf form editable in reader software control project winforms web page html UWP print30-part2081

When an image is used to represent a character that cannot otherwise be represented in Unicode, for example gaiji, itaiji, or new characters such
as novel currency symbols, the alternative text should be a more conventional way of writing the same thing, e.g. using the phonetic hiragana or
katakana to give the character's pronunciation.
An image should not be used if Unicode characters would serve an identical purpose. Only when the text cannot be directly represented using
Unicode, e.g. because of decorations or because the character is not in the Unicode character set (as in the case of gaiji), would an image be
appropriate.
4.8.4.1.6 A graphical representation of some of the surrounding text
In many cases, the image is actually just supplementary, and its presence merely reinforces the surrounding text. In these cases, thealtp281
attribute must be present but its value must be the empty string.
In general, an image falls into this category if removing the image doesn't make the page any less useful, but including the image makes it a lot
easier for users of visual browsers to understand the concept.
An illuminated manuscript might use graphics for some of its images. The alternative text in such a situation is just the character that the
image represents.
<p><img src="initials/o.svg" alt="O">nce upon a time and a long long time ago, late at
night, when it was dark, over the hills, through the woods, across a great ocean, in a land far
away, in a small house, on a hill, under a full moon...
In this example from 1997, a new-fangled currency symbol that looks like a curly E with two bars in the middle instead of one is
represented using an image. The alternative text gives the character's pronunciation.
<p>Only <img src="euro.png" alt="euro ">5.99!
Example
If an author is tempted to use an image because their default system font does not support a given character, then Web Fonts are a better
solution than images.
Note
A flowchart that repeats the previous paragraph in graphical form:
<p>The Network passes data to the Input Stream Preprocessor, which
passes it to the Tokenizer, which passes it to the Tree Construction
stage. From there, data goes to both the DOM and to Script Execution.
Script Execution is linked to the DOM, and, using document.write(),
passes data to the Tokenizer.</p>
<p><img src="images/parsing-model-overview.png" alt=""></p>
In these cases, it would be wrong to include alternative text that consists of just a caption. If a caption is to be included, then either the
titlep124
attribute can be used, or thefigurep201
andfigcaptionp204
elements can be used. In the latter case, the image would in
fact be a phrase or paragraph with an alternative graphical representation, and would thus require alternative text.
<!-- Using the title="" attribute -->
<p>The Network passes data to the Input Stream Preprocessor, which
passes it to the Tokenizer, which passes it to the Tree Construction
stage. From there, data goes to both the DOM and to Script Execution.
Script Execution is linked to the DOM, and, using document.write(),
passes data to the Tokenizer.</p>
<p>
<img src="images/parsing-model-overview.png" alt=""
title="Flowchart representation of the parsing model."></p>
<!-- Using <figure> and <figcaption> -->
<p>The Network passes data to the Input Stream Preprocessor, which
passes it to the Tokenizer, which passes it to the Tree Construction
stage. From there, data goes to both the DOM and to Script Execution.
Script Execution is linked to the DOM, and, using document.write(),
passes data to the Tokenizer.</p>
Example
301
Make pdf form editable in reader - extract form data from PDF in C#.net, ASP.NET, MVC, Ajax, WPF
Help to Read and Extract Field Data from PDF with a Convenient C# Solution
html form output to pdf; cannot save pdf form in reader
Make pdf form editable in reader - VB.NET PDF Form Data Read library: extract form data from PDF in vb.net, ASP.NET, MVC, Ajax, WPF
Convenient VB.NET Solution to Read and Extract Field Data from PDF
extract data from pdf to excel; extract pdf form data to excel
4.8.4.1.7 Ancillary images
Sometimes, an image is not critical to the content, but is nonetheless neither purely decorative nor entirely redundant with the text. In these cases,
thealtp281
attribute must be present, and its value should either be the empty string, or a textual representation of the information that the image
conveys. If the image has a caption giving the image's title, then thealtp281
attribute's value must not be empty (as that would be quite confusing
for non-visual readers).
<figure>
<img src="images/parsing-model-overview.png" alt="The Network leads to
the Input Stream Preprocessor, which leads to the Tokenizer, which
leads to the Tree Construction stage. The Tree Construction stage
leads to two items. The first is Script Execution, which leads via
document.write() back to the Tokenizer. The second item from which
Tree Construction leads is the DOM. The DOM is related to the Script
Execution.">
<figcaption>Flowchart representation of the parsing model.</figcaption>
</figure>
<!-- This is WRONG. Do not do this. Instead, do what the above examples do. -->
<p>The Network passes data to the Input Stream Preprocessor, which
passes it to the Tokenizer, which passes it to the Tree Construction
stage. From there, data goes to both the DOM and to Script Execution.
Script Execution is linked to the DOM, and, using document.write(),
passes data to the Tokenizer.</p>
<p><img src="images/parsing-model-overview.png"
alt="Flowchart representation of the parsing model."></p>
<!-- Never put the image's caption in the alt="" attribute! -->
A graph that repeats the previous paragraph in graphical form:
<p>According to a study covering several billion pages,
about 62% of documents on the Web in 2007 triggered the Quirks
rendering mode of Web browsers, about 30% triggered the Almost
Standards mode, and about 9% triggered the Standards mode.</p>
<p><img src="rendering-mode-pie-chart.png" alt=""></p>
Example
Consider a news article about a political figure, in which the individual's face was shown in an image that, through a style sheet, is
floated to the right. The image is not purely decorative, as it is relevant to the story. The image is not entirely redundant with the story
either, as it shows what the politician looks like. Whether any alternative text need be provided is an authoring decision, in part
influenced by whether the image colours the interpretation of the prose.
In this first variant, the image is shown without context, and no alternative text is provided:
<p>
<img src="alexsalmond.jpeg" alt=""> Ahead of today's referendum,
the First Minister of Scotland, Alex Salmond, wrote an open letter to all
registered voters. In it, he admitted that all countries make mistakes.</p>
If the picture is just a face, there might be no value in describing it. It's of no interest to the reader whether the individual has red hair or
blond hair, whether the individual has white skin or black skin, whether the individual has one eye or two eyes.
However, if the picture is more dynamic, for instance showing the politician as angry, or particularly happy, or devastated, some
alternative text would be useful in setting the tone of the article, a tone that might otherwise be missed:
<p>
<img src="alexsalmond.jpeg" alt="Alex Salmond is sad.">
Ahead of today's referendum, the First Minister of Scotland, Alex Salmond,
wrote an open letter to all registered voters. In it, he admitted that all
countries make mistakes.</p>
Example
302
C# PDF Convert to Text SDK: Convert PDF to txt files in C#.net
to convert target PDF document to other editable file formats should be noted here is that our PDF to text Thus, please make sure you have installed VS 2005 or
collect data from pdf forms; using pdf forms to collect data
VB.NET Image: Add Callout Annotation on Document and Image in VB.
document and image formats, such as PDF, Word, TIFF mainly contains two parts-that are editable text area guide that tells you how to make callout annotation
exporting data from pdf to excel; extract data from pdf into excel
4.8.4.1.8 A purely decorative image that doesn't add any information
If an image is decorative but isn't especially page-specific — for example an image that forms part of a site-wide design scheme — the image
should be specified in the site's CSS, not in the markup of the document.
However, a decorative image that isn't discussed by the surrounding text but still has some relevance can be included in a page using theimgp280
element. Such images are decorative, but still form part of the content. In these cases, thealtp281
attribute must be present but its value must be
the empty string.
4.8.4.1.9 A group of images that form a single larger picture with no links
When a picture has been sliced into smaller image files that are then displayed together to form the complete picture again, one of the images must
have itsaltp281
attribute set as per the relevant rules that would be appropriate for the picture as a whole, and then all the remaining images must
have theiraltp281
attribute set to the empty string.
<p>
<img src="alexsalmond.jpeg" alt="Alex Salmond is ecstatic!">
Ahead of today's referendum, the First Minister of Scotland, Alex Salmond,
wrote an open letter to all registered voters. In it, he admitted that all
countries make mistakes.</p>
Whether the individual was "sad" or "ecstatic" makes a difference to how the rest of the paragraph is to be interpreted: is he likely saying
that he is resigned to the populace making a bad choice in the upcoming referendum, or is he saying that the election was a mistake but
the likely turnout will make it irrelevant? The interpretation varies based on the image.
If the image has a caption, then including alternative text avoids leaving the non-visual user confused as to what the caption refers to.
<p>Ahead of today's referendum, the First Minister of Scotland, Alex Salmond,
wrote an open letter to all registered voters. In it, he admitted that all
countries make mistakes.</p>
<figure>
<img src="alexsalmond.jpeg"
alt="A high forehead, cheerful disposition, and dark hair round out Alex Salmond's face.">
<figcaption> Alex Salmond, SNP. Photo © 2014 PolitiPhoto. </figcaption>
</figure>
Example
Examples where the image is purely decorative despite being relevant would include things like a photo of the Black Rock City
landscape in a blog post about an event at Burning Man, or an image of a painting inspired by a poem, on a page reciting that poem.
The following snippet shows an example of the latter case (only the first verse is included in this snippet):
<h1>The Lady of Shalott</h1>
<p><img src="shalott.jpeg" alt=""></p>
<p>On either side the river lie<br>
Long fields of barley and of rye,<br>
That clothe the wold and meet the sky;<br>
And through the field the road run by<br>
To many-tower'd Camelot;<br>
And up and down the people go,<br>
Gazing where the lilies blow<br>
Round an island there below,<br>
The island of Shalott.</p>
Example
In the following example, a picture representing a company logo forXYZ Corphas been split into two pieces, the first containing the
letters "XYZ" and the second with the word "Corp". The alternative text ("XYZ Corp") is all in the first image.
<h1>
<img src="logo1.png" alt="XYZ Corp"><img src="logo2.png" alt=""></h1>
Example
Example
303
VB.NET PDF Convert to Text SDK: Convert PDF to txt files in vb.net
VB.NET control for batch converting PDF to editable & searchable users will be able to convert a PDF file or Before you get started, please make sure that you
extract table data from pdf; pdf data extraction to excel
VB.NET Create PDF Library SDK to convert PDF from other file
Create and save editable PDF with a blank page, bookmarks, links Creating a PDF document is a good way to share your ideas because you can make sure that
how to save editable pdf form in reader; sign pdf form reader
4.8.4.1.10 A group of images that form a single larger picture with links
Generally,image mapsp389
should be used instead of slicing an image for links.
However, if an image is indeed sliced and any of the components of the sliced picture are the sole contents of links, then one image per link must
have alternative text in itsaltp281
attribute representing the purpose of the link.
4.8.4.1.11 A key part of the content
In some cases, the image is a critical part of the content. This could be the case, for instance, on a page that is part of a photo gallery. The image is
the wholepointof the page containing it.
How to provide alternative text for an image that is a key part of the content depends on the image's provenance.
The general case
When it is possible for detailed alternative text to be provided, for example if the image is part of a series of screenshots in a magazine
review, or part of a comic strip, or is a photograph in a blog entry about that photograph, text that can serve as a substitute for the image must
be given as the contents of thealtp281
attribute.
In the following example, a rating is shown as three filled stars and two empty stars. While the alternative text could have been
"★★★☆☆", the author has instead decided to more helpfully give the rating in the form "3 out of 5". That is the alternative text of the
first image, and the rest have blank alternative text.
<p>Rating: <meter max=5 value=3>
<img src="1" alt="3 out of 5"
><img src="1" alt=""><img src="1" alt=""><img src="0" alt=""
><img src="0" alt=""></meter></p>
In the following example, a picture representing the flying spaghetti monster emblem, with each of the left noodly appendages and the
right noodly appendages in different images, so that the user can pick the left side or the right side in an adventure.
<h1>The Church</h1>
<p>You come across a flying spaghetti monster. Which side of His
Noodliness do you wish to reach out for?</p>
<p><a href="?go=left" ><img src="fsm-left.png"  alt="Left side. "></a
><img src="fsm-middle.png" alt=""
><a href="?go=right"><img src="fsm-right.png" alt="Right side."></a></p>
Example
A screenshot in a gallery of screenshots for a new OS, with some alternative text:
<figure>
<img src="KDE%20Light%20desktop.png"
alt="The desktop is blue, with icons along the left hand side in
two columns, reading System, Home, K-Mail, etc. A window is
open showing that menus wrap to a second line if they
cannot fit in the window. The window has a list of icons
along the top, with an address bar below it, a list of
icons for tabs along the left edge, a status bar on the
bottom, and two panes in the middle. The desktop has a bar
at the bottom of the screen with a few buttons, a pager, a
list of open applications, and a clock.">
<figcaption>Screenshot of a KDE desktop.</figcaption>
</figure>
Example
A graph in a financial report:
<img src="sales.gif"
title="Sales graph"
Example
304
VB.NET Excel: How to Covert Excel Doc to PDF in VB.NET Application
document is not editable and the Excel document is editable. So when using Excel or PDF document on your for VB.NET programming, you need to make sure whether
extracting data from pdf into excel; extract data from pdf form fields
Process Multipage TIFF Images in Web Image Viewer| Online
Export multi-page TIFF image to a PDF; More image viewing & multipage TIFF files in Web Document Viewer, make sure that Load, Save an Editable Multi-page TIFF.
extract data from pdf c#; extract data from pdf
Images that defy a complete description
In certain cases, the nature of the image might be such that providing thorough alternative text is impractical. For example, the image could
be indistinct, or could be a complex fractal, or could be a detailed topographical map.
In these cases, thealtp281
attribute must contain some suitable alternative text, but it may be somewhat brief.
alt="From 1998 to 2005, sales increased by the following percentages
with each year: 624%, 75%, 138%, 40%, 35%, 9%, 21%">
Note that "sales graph" would be inadequate alternative text for a sales graph. Text that would be a goodcaptionis not generally
suitable as replacement text.
Sometimes there simply is no text that can do justice to an image. For example, there is little that can be said to usefully describe
a Rorschach inkblot test. However, a description, even if brief, is still better than nothing:
<figure>
<img src="/commons/a/a7/Rorschach1.jpg" alt="A shape with left-right
symmetry with indistinct edges, with a small gap in the center, two
larger gaps offset slightly from the center, with two similar gaps
under them. The outline is wider in the top half than the bottom
half, with the sides extending upwards higher than the center, and
the center extending below the sides.">
<figcaption>A black outline of the first of the ten cards
in the Rorschach inkblot test.</figcaption>
</figure>
Note that the following would be a very bad use of alternative text:
<!-- This example is wrong. Do not copy it. -->
<figure>
<img src="/commons/a/a7/Rorschach1.jpg" alt="A black outline
of the first of the ten cards in the Rorschach inkblot test.">
<figcaption>A black outline of the first of the ten cards
in the Rorschach inkblot test.</figcaption>
</figure>
Including the caption in the alternative text like this isn't useful because it effectively duplicates the caption for users who don't
have images, taunting them twice yet not helping them any more than if they had only read or heard the caption once.
Example
Another example of an image that defies full description is a fractal, which, by definition, is infinite in detail.
The following example shows one possible way of providing alternative text for the full view of an image of the Mandelbrot set.
<img src="ms1.jpeg" alt="The Mandelbrot set appears as a cardioid with
its cusp on the real axis in the positive direction, with a smaller
bulb aligned along the same center line, touching it in the negative
direction, and with these two shapes being surrounded by smaller bulbs
of various sizes.">
Example
Similarly, a photograph of a person's face, for example in a biography, can be considered quite relevant and key to the content,
but it can be hard to fully substitute text for
<section class="bio">
<h1>A Biography of Isaac Asimov</h1>
<p>Born <b>Isaak Yudovich Ozimov</b> in 1920, Isaac was a prolific author.</p>
<p><img src="headpics/asimov.jpeg" alt="Isaac Asimov had dark hair, a tall forehead, and
wore glasses.
Later in life, he wore long white sideburns.">
<p>Asimov was born in Russia, and moved to the US when he was three years old.</p>
<p>...
</section>
Example
305
VB.NET TIFF: Convert TIFF to HTML Web Page Using VB.NET TIFF
information of TIFF file in a more editable file format This online article aims to make a detailed instruction on to HTML converters, like VB.NET PDF to HTML
extract data from pdf forms; vb extract data from pdf
VB.NET Image: Barcode Generator to Add UPC-A to Image, TIFF, PDF &
REFile.SaveDocumentFile(doc, "c:/upc-a.pdf", New PDFEncoder document, but also we can make a UPC A barcode imaging properties from the following parameter form.
pdf form save with reader; extracting data from pdf to excel
Images whose contents are not known
In some unfortunate cases, there might be no alternative text available at all, either because the image is obtained in some automated
fashion without any associated alternative text (e.g. a Webcam), or because the page is being generated by a script using user-provided
images where the user did not provide suitable or usable alternative text (e.g. photograph sharing sites), or because the author does not
themself know what the images represent (e.g. a blind photographer sharing an image on their blog).
In such cases, thealtp281
attribute may be omitted, but one of the following conditions must be met as well:
• Theimgp280
element is in afigurep201
element that contains afigcaptionp204
element that contains content other thaninter-
element whitespacep115
, and, ignoring thefigcaptionp204
element and its descendants, thefigurep201
element has noflow
contentp117
descendants other thaninter-element whitespacep115
and theimgp280
element.
• Thetitlep124
attribute is present and has a non-empty value.
In such cases it is unnecessary (and indeed discouraged) to include a reference to the presence of the image itself in the
alternative text, since such text would be redundant with the browser itself reporting the presence of the image. For example, if the
alternative text was "A photo of Isaac Asimov", then a conforming user agent might read that out as "(Image) A photo of Isaac
Asimov" rather than the more useful "(Image) Isaac Asimov had dark hair, a tall forehead, and wore glasses...".
Relying on thetitlep124
attribute is currently discouraged as many user agents do not expose the attribute in an
accessible manner as required by this specification (e.g. requiring a pointing device such as a mouse to cause a tooltip to
appear, which excludes keyboard-only users and touch-only users, such as anyone with a modern phone or tablet).
Note
Such cases are to be kept to an absolute minimum. If there is even the slightest possibility of the author having the ability to provide
real alternative text, then it would not be acceptable to omit thealtp281
attribute.
Note
A photo on a photo-sharing site, if the site received the image with no metadata other than the caption, could be marked up as
follows:
<figure>
<img src="1100670787_6a7c664aef.jpg">
<figcaption>Bubbles traveled everywhere with us.</figcaption>
</figure>
It would be better, however, if a detailed description of the important parts of the image obtained from the user and included on the
page.
Example
A blind user's blog in which a photo taken by the user is shown. Initially, the user might not have any idea what the photo they
took shows:
<article>
<h1>I took a photo</h1>
<p>I went out today and took a photo!</p>
<figure>
<img src="photo2.jpeg">
<figcaption>A photograph taken blindly from my front porch.</figcaption>
</figure>
</article>
Eventually though, the user might obtain a description of the image from their friends and could then include alternative text:
<article>
<h1>I took a photo</h1>
<p>I went out today and took a photo!</p>
<figure>
<img src="photo2.jpeg" alt="The photograph shows my squirrel
feeder hanging from the edge of my roof. It is half full, but there
are no squirrels around. In the background, out-of-focus trees fill the
shot. The feeder is made of wood with a metal grate, and it contains
peanuts. The edge of the roof is wooden too, and is painted white
with light blue streaks.">
<figcaption>A photograph taken blindly from my front porch.</figcaption>
Example
306
4.8.4.1.12 An image not intended for the user
Generally authors should avoid usingimgp280
elements for purposes other than showing images.
If animgp280
element is being used for purposes other than showing an image, e.g. as part of a service to count page views, then thealtp281
attribute must be the empty string.
In such cases, thewidthp393
andheightp393
attributes should both be set to zero.
4.8.4.1.13 An image in an e-mail or private document intended for a specific person who is known to be able to view images
This section does not apply to documents that are publicly accessible, or whose target audience is not necessarily personally known to the author,
such as documents on a Web site, e-mails sent to public mailing lists, or software documentation.
When an image is included in a private communication (such as an HTML e-mail) aimed at a specific person who is known to be able to view
images, thealtp281
attribute may be omitted. However, even in such cases authors are strongly urged to include alternative text (as appropriate
according to the kind of image involved, as described in the above entries), so that the e-mail is still usable should the user use a mail client that
does not support images, or should the document be forwarded on to other users whose abilities might not include easily seeing images.
</figure>
</article>
Sometimes the entire point of the image is that a textual description is not available, and the user is to provide the description. For
instance, the point of a CAPTCHA image is to see if the user can literally read the graphic. Here is one way to mark up a
CAPTCHA (note thetitlep124
attribute):
<p><label>What does this image say?
<img src="captcha.cgi?id=8934" title="CAPTCHA">
<input type=text name=captcha></label>
(If you cannot see the image, you can use an <a
href="?audio">audio</a> test instead.)</p>
Another example would be software that displays images and asks for alternative text precisely for the purpose of then writing a
page with correct alternative text. Such a page could have a table of images, like this:
<table>
<thead>
<tr> <th> Image <th> Description
<tbody>
<tr>
<td>
<img src="2421.png" title="Image 640 by 100, filename 'banner.gif'">
<td> <input name="alt2421">
<tr>
<td>
<img src="2422.png" title="Image 200 by 480, filename 'ad3.gif'">
<td> <input name="alt2422">
</table>
Notice that even in this example, as much useful information as possible is still included in thetitlep124
attribute.
Example
Since some users cannot use images at all (e.g. because they have a very slow connection, or because they are using a text-only
browser, or because they are listening to the page being read out by a hands-free automobile voice Web browser, or simply
because they are blind), thealtp281
attribute is only allowed to be omitted rather than being provided with replacement text when no
alternative text is available and none can be made available, as in the above examples. Lack of effort from the part of the author is
not an acceptable reason for omitting thealtp281
attribute.
Note
307
4.8.4.1.14 Guidance for markup generators
Markup generators (such as WYSIWYG authoring tools) should, wherever possible, obtain alternative text from their users. However, it is
recognised that in many cases, this will not be possible.
For images that are the sole contents of links, markup generators should examine the link target to determine the title of the target, or the URL of
the target, and use information obtained in this manner as the alternative text.
For images that have captions, markup generators should use thefigurep201
andfigcaptionp204
elements, or thetitlep124
attribute, to
provide the image's caption.
As a last resort, implementors should either set thealtp281
attribute to the empty string, under the assumption that the image is a purely decorative
image that doesn't add any information but is still specific to the surrounding content, or omit thealtp281
attribute altogether, under the assumption
that the image is a key part of the content.
Markup generators may specify agenerator-unable-to-provide-required-altattribute onimgp280
elements for which they have been
unable to obtain alternative text and for which they have therefore omitted thealtp281
attribute. The value of this attribute must be the empty string.
Documents containing such attributes are not conforming, but conformance checkers willsilently ignorep308
this error.
Markup generators should generally avoid using the image's own file name as the alternative text. Similarly, markup generators should avoid
generating alternative text from any content that will be equally available to presentation user agents (e.g. Web browsers).
4.8.4.1.15 Guidance for conformance checkers
A conformance checker must report the lack of analtp281
attribute as an error unless one of the conditions listed below applies:
• Theimgp280
element is in afigurep201
element that satisfiesthe conditions described abovep306
.
• Theimgp280
element has atitlep124
attribute with a value that is not the empty string (also asdescribed abovep306
).
• The conformance checker has been configured to assume that the document is an e-mail or document intended for a specific person
who is known to be able to view images.
• Theimgp280
element has a (non-conforming)generator-unable-to-provide-required-altp308
attribute whose value is the
empty string. A conformance checker that is not reporting the lack of analtp281
attribute as an error must also not report the presence
of the emptygenerator-unable-to-provide-required-altp308
attribute as an error. (This case does not represent a case
where the document is conforming, only that the generator could not determine appropriate alternative text — validators are not required
to show an error in this case, because such an error might encourage markup generators to include bogus alternative text purely in an
attempt to silence validators. Naturally, conformance checkersmayreport the lack of analtp281
attribute as an error even in the
presence of thegenerator-unable-to-provide-required-altp308
attribute; for example, there could be a user option to report
allconformance errors even those that might be the more or less inevitable result of using a markup generator.)
Categoriesp114:
Flow contentp117
.
Phrasing contentp117
.
Embedded contentp118
.
Interactive contentp118
.
Palpable contentp118
.
This is intended to avoid markup generators from being pressured into replacing the error of omitting thealtp281
attribute with the even
more egregious error of providing phony alternative text, because state-of-the-art automated conformance checkers cannot distinguish
phony alternative text from correct alternative text.
Note
This is because once a page is generated, it will typically not be updated, whereas the browsers that later read the page can be updated
by the user, therefore the browser is likely to have more up-to-date and finely-tuned heuristics than the markup generator did when
generating the page.
Note
4.8.5 Theiframeelement
Spec bugs:28773
308
Contexts in which this element can be usedp114:
Whereembedded contentp118
is expected.
Content modelp114:
Text that conforms tothe requirements given in the prosep314
.
Tag omission in text/htmlp114:
Neither tag is omissible.
Content attributesp114:
Global attributesp121
srcp309
— Address of the resource
srcdocp309
— A document to render in theiframep308
namep312
— Name ofnested browsing contextp749
sandboxp312
— Security rules for nested content
allowfullscreenp313
— Whether to allow theiframep308
's contents to userequestFullscreen()
widthp393
— Horizontal dimension
heightp393
— Vertical dimension
referrerpolicyp314
— Determines thereferrer policy
forfetches
initiated by the element
DOM interfacep114:
interface HTMLIFrameElement : HTMLElement
{
[CEReactions
] attribute DOMString src
;
[CEReactions
] attribute DOMString srcdoc
;
[CEReactions
] attribute DOMString name
;
[CEReactions
, SameObject, PutForwards=value
] readonly attribute DOMTokenList
sandbox
;
[CEReactions
] attribute boolean allowFullscreen
;
[CEReactions
] attribute DOMString width
;
[CEReactions
] attribute DOMString height
;
[CEReactions
] attribute DOMString referrerPolicy
;
readonly attribute Document
contentDocument
;
readonly attribute WindowProxy
contentWindow
;
Document
getSVGDocument
();
// also has obsolete members
};
Theiframep308
elementrepresentsp112
anested browsing contextp749
.
Thesrcattribute gives theURL
of a page that thenested browsing contextp749
is to contain. The attribute, if present, must be avalid non-empty
URL potentially surrounded by spacesp86
. If theitempropp679
is specified on aniframep308
element, then thesrcp309
attribute must also be
specified.
Thesrcdocattribute gives the content of the page that thenested browsing contextp749
is to contain. The value of the attribute is the source ofan
iframesrcdocdocument.
Thesrcdocp309
attribute, if present, must have a value usingthe HTML syntaxp951
that consists of the following syntactic components, in the given
order:
1. Any number ofcommentsp962
andspace charactersp64
.
2. Optionally, aDOCTYPEp951
.
3. Any number ofcommentsp962
andspace charactersp64
.
4. Thedocument element
, in the form of anhtmlp134
elementp952
.
5. Any number ofcommentsp962
andspace charactersp64
.
IDL
Support:
Chrome
20+
Chrome for Android
50+
UC Browser for Android 9.9+
iOS Safari
6.0-6.1+
Firefox
25+
IE
None
Opera Mini
None
Android Browser
4.4+
Safari
6+
Opera
15+
Source:caniuse.com
309
When aniframep308
element isinserted into a documentp43
that has abrowsing contextp748
, the user agent mustcreatep748
anested browsing
contextp749
, and thenprocess theiframeattributesp311
for the "first time".
When aniframep308
element isremoved from a documentp43
, the user agent mustdiscardp763
thenested browsing contextp749
, if any.
The above requirements apply inXML documents
as well.
Note
Here a blog uses thesrcdocp309
attribute in conjunction with thesandboxp312
attribute described below to provide users of user agents
that support this feature with an extra layer of protection from script injection in the blog post comments:
<article>
<h1>I got my own magazine!</h1>
<p>After much effort, I've finally found a publisher, and so now I
have my own magazine! Isn't that awesome?! The first issue will come
out in September, and we have articles about getting food, and about
getting in boxes, it's going to be great!</p>
<footer>
<p>Written by <a href="/users/cap">cap</a>, 1 hour ago.
</footer>
<article>
<footer> Thirteen minutes ago, <a href="/users/ch">ch</a> wrote: </footer>
<iframe sandbox srcdoc="<p>did you get a cover picture yet?"></iframe>
</article>
<article>
<footer> Nine minutes ago, <a href="/users/cap">cap</a> wrote: </footer>
<iframe sandbox srcdoc="<p>Yeah, you can see it <a
href=&quot;/gallery?mode=cover&amp;amp;page=1&quot;>in my gallery</a>."></iframe>
</article>
<article>
<footer> Five minutes ago, <a href="/users/ch">ch</a> wrote: </footer>
<iframe sandbox srcdoc="<p>hey that's earl's table.
<p>you should get earl&amp;amp;me on the next cover."></iframe>
</article>
Notice the way that quotes have to be escaped (otherwise thesrcdocp309
attribute would end prematurely), and the way raw
ampersands (e.g. in URLs or in prose) mentioned in the sandboxed content have to bedoublyescaped — once so that the ampersand
is preserved when originally parsing thesrcdocp309
attribute, and once more to prevent the ampersand from being misinterpreted when
parsing the sandboxed content.
Furthermore, notice that since theDOCTYPEp951
is optional iniframesrcdocdocumentsp309
, and thehtmlp134
,headp135
, and
bodyp156
elements haveoptional start and end tagsp956
, and thetitlep136
element is also optional iniframesrcdocdocumentsp309
,
the markup in asrcdocp309
attribute can be relatively succinct despite representing an entire document, since only the contents of the
bodyp156
element need appear literally in the syntax. The other elements are still present, but only by implication.
Example
Inthe HTML syntaxp951
, authors need only remember to use U+0022 QUOTATION MARK characters (") to wrap the attribute contents and
then to escape all U+0022 QUOTATION MARK (") and U+0026 AMPERSAND (&) characters, and to specify thesandboxp312
attribute, to
ensure safe embedding of content.
Note
Due to restrictions ofthe XHTML syntaxp1063
, in XML the U+003C LESS-THAN SIGN character (<) needs to be escaped as well. In order
to preventattribute-value normalization
, some of XML's whitespace characters — specifically U+0009 CHARACTER TABULATION (tab),
U+000A LINE FEED (LF), and U+000D CARRIAGE RETURN (CR) — also need to be escaped.[XML]p1165
Note
If thesrcp309
attribute and thesrcdocp309
attribute are both specified together, thesrcdocp309
attribute takes priority. This allows authors
to provide a fallbackURL
for legacy user agents that do not support thesrcdocp309
attribute.
Note
This happens without anyunloadp1155
events firing (thenested browsing contextp749
and itsDocumentp103
arediscardedp763
, not
unloadedp803
).
Note
310
Documents you may be interested
Documents you may be interested